OpenClaw 专题
目录
本专题讲什么
OpenClaw 把「个人 AI 助手」做成一条可自托管、可常驻、可接多渠道的产品路径：你在自己控制的机器上运行 Gateway（控制面），再把日常已经在用的即时通讯或 Web 通道接进来，让助手在同一套会话与工具体系里工作。官方一句话是 Your own personal AI assistant. Any OS. Any Platform，完整说明见 仓库 README 与 官方文档站点。
本专题的定位是：在官方手册之外，补一层「决策与工程语言」——告诉你每个能力在落地时对应什么风险、什么检查项、什么运维节奏；文中大量链接指向 Getting started、Security、Configuration、Session model 等权威页面，避免只停留在概念层。
阅读方式建议
- 第一次接触：按目录顺序从 介绍与定位 读到 踩坑与常见问题，先跑通最小闭环。
- 准备上生产或多人共用：重点读 解决方案与工程实践、以及进阶篇 多 Agent 方案 与 上下文与记忆管理策略。
- 与官方手册的关系：本专题不替代官方逐步截图与最新命令行输出；遇到命令报错、配置键名争议，以官方文档与你本机
openclaw --help为准。
一张图建立心智模型
下图是学习用示意：帮助你在读官方架构文档前，先建立「渠道 → Gateway → 工具与工作区」的分层直觉；真实拓扑与协议细节请以 Architecture 与 Gateway protocol 为准。
读图时请抓住一句话：渠道负责“消息从哪来”，Gateway 负责“这条消息进入哪条会话与哪套策略”，工具与工作区负责“能做什么、长期沉淀什么”。 三者缺一，助手就会退化成「偶尔能用的聊天接口」。
适合谁与不适合谁
适合：
- 希望助手主要跑在自己的电脑或自己的服务器上，而不是完全依赖第三方网页单一入口。
- 已经在 Telegram、Slack、Discord、飞书类 IM 里工作，希望同一条助手逻辑覆盖多个渠道。
- 愿意阅读 DM 配对、沙箱、远程暴露 等安全文档，并接受「默认配置偏保守」这一事实。
- 愿意建立 运维习惯（升级、
doctor、日志与备份），而不是「装完就不管」。
不适合（或需要显著补全）：
- 多租户 SaaS：需要租户隔离、计费、审计与合规设计，本专题只提供风险清单与工程方向。
- 无人值守对公服务：若缺乏入站风控与工具审批，任何助手框架都不应直接上公网。
- 把 OpenClaw 当「合规产品」：合规是流程与制度；OpenClaw 提供的是技术能力边界。
章节导读与学习顺序
| 顺序 | 文档 | 你在这一阶段应达到的状态 |
|---|---|---|
| 1 | 介绍与定位 | 能说明 OpenClaw 与「Webhook 机器人」差异，知道能力边界与权威入口 |
| 2 | 安装与快速上手 | 能完成全局安装、onboard、拉起 Gateway 的最小闭环 |
| 3 | 架构与实战场景 | 能画出自己环境里的「渠道—Gateway—工具」关系，并选对场景 |
| 4 | 解决方案与工程实践 | 能把 DM 策略、沙箱、远程、运维纳入可执行清单 |
| 5 | 踩坑与常见问题 | 遇到问题时有章可循：先 doctor、再查渠道与日志 |
| 6 | 多 Agent 方案 | 能设计路由、隔离与 main/沙箱策略，避免“多入口共享高危权限” |
| 7 | 上下文与记忆管理策略 | 能分层管理工作区、技能与会话压缩，控制成本与隐私 |
建议按顺序阅读前 5 篇以建立共同语境；第 6、7 篇可在你要「多人/多入口/长对话」时深入。
与仓库内其他文档如何配合
- 同目录下的
OpenClaw与开源Agent框架实践更偏通用 Agent 工程位点（规划、工具、记忆、评测），适合与本文专题对照阅读：一篇讲「通用套路」，一篇讲「OpenClaw 这条产品路径」。 - 若你同时关注 Hermes-Agent（Nous Research），可阅读并列专题
Hermes-Agent 专题；Hermes 提供从 OpenClaw 迁移的 CLI（hermes claw migrate），见 Migrating from OpenClaw。
原文与权威链接
| 资源 | 链接 | 说明 |
|---|---|---|
| GitHub 仓库 | openclaw/openclaw | 源码、Issue、发布说明 |
| 官方文档首页 | docs.openclaw.ai | 概念、配置、渠道、工具索引 |
| 新手入门 | Getting started | 账号、配对、首条消息等 |
| 向导 / Onboarding | Onboarding / Wizard | 推荐 CLI 初始化路径 |
| 安全 | Security | 必读：DM、工具权限与暴露面 |
| 更新 | Updating | 升级与通道（stable/beta/dev） |
| 愿景 | VISION.md（仓库内） | 产品方向叙述 |