想拥有一个 7×24 小时在线的私人 AI 助手，能在 Telegram、WhatsApp、Discord 等平台随时响应你的消息？OpenClaw 就是为此而生的开源 AI Agent 网关。本文是一份从 0 到精通的完整教程，无论你是刚入门的小白还是想深度玩转多智能体的老鸟，都能找到适合自己的内容。
适用：macOS/Linux/WSL2。本文默认你在一台”跑 Gateway 的主机”上操作（比如你的 Mac mini）。
目标：从 0 到能用（网页聊天 / Telegram/WhatsApp 等）、能进 TUI、能排障、能玩转多智能体/多配置/安全隔离。
OpenClaw 的心智模型可以用一句话概括：
- Gateway（网关）：常驻后台的”中枢进程”，负责接入 Telegram/WhatsApp/网页 UI、维护会话、路由到智能体。
- Agent（智能体）：执行对话与工具调用的”角色实例”（、、…），每个 agent 可以有自己的 workspace、模型、工具权限。
- Session（会话）：某个 agent 下的一段对话历史（例如 、、或者按渠道分的 session key）。
你所有操作基本都围绕：启动 Gateway → 选 agent/session → 在某个渠道里发消息。
如果你之前了解过 OpenClaw 的前身（ClawdBot → Moltbot → OpenClaw），这三个概念应该不陌生。
默认工作区：
你现在这台机器上：
这个目录一般放：
- ：你的”使用约定/偏好/长期记忆”
- ：每日流水记录
- ：自定义技能（例如 blog-writer）
- ：临时文件
经验：workspace 既是”我读你偏好”的地方，也是我写产物（文档、脚本、草稿）的地方。
关于 OpenClaw 的记忆机制细节，可以参考 OpenClaw 记忆实施策略解析。
默认位置：
它是 JSON5（支持注释、尾逗号），并且 严格 schema 校验：拼错字段会导致 Gateway 拒绝启动。
默认位置：
里面会有 agents 的认证与运行状态（例如 ）。
如果你已经装好了，可以直接跳到第 3 节。
验证：
更多安装细节可参考 OpenClaw 官方文档。
它会帮你配置：
- 模型认证（OAuth / API key）
- Gateway 基本配置
- 渠道（Telegram/WhatsApp/Discord…）
- 配对/白名单（安全默认）
- 可选：安装后台服务（macOS 用 launchd）
如果你之前用过 Moltbot Wizard，这个向导体验类似但更完善，详见 Moltbot Wizard 完全指南。
默认控制台 UI：
- http://127.0.0.1:18789/
老鸟提醒：如果你使用 Telegram/WhatsApp，尽量用 Node 跑，不要用 Bun（有已知兼容性坑）。
排障常用：
最快开聊：
或者直接打开：
- http://127.0.0.1:18789/
适合：
- 第一次验证是否能跑
- 不想配渠道也能先用
- 需要图形化配置/查看会话
只要 Gateway 在跑，执行：
远程连别的机器的 Gateway：
4.2.1 TUI 里最关键的两个点：session 与 deliver
- 默认情况下，TUI 只是把消息发给 Gateway 但不投递到聊天平台。
- 想让回复真的发回 Telegram/WhatsApp：
- 在 TUI 输入：
- 或启动时：
这点是”防误发”的设计：不小心把测试消息发到群里是新手常见事故。
4.2.2 TUI 快捷键（建议背下来）
- ：发送
- ：中止当前运行
- ：清空输入（按两次退出）
- ：退出
- ：模型选择器
- ：智能体选择器
- ：会话选择器
- ：工具输出折叠/展开
- ：切换思考可见性（会重新加载历史）
4.2.3 TUI 斜杠命令（常用）
- ：帮助
- ：当前连接/会话/模型状态
- 、
- 、
- 、
- 或
4.2.4 老鸟惊叹技巧：TUI 里直接跑本地 shell（）
在 TUI 输入：
注意：
- 第一次会提示授权（每个会话一次）
- 每条 都是独立的非交互 shell（不会记住上一次 ）
这在排障和自动化时非常爽：你可以在一个界面里”边聊边执行命令”。
适合：
- 自动化
- 写脚本/CI
- 验证某个渠道出站是否正常
- 限制谁能私信触发机器人（allowFrom / pairing）
- 群里是否需要 @ 提及才回复（requireMention）
- 工作区路径（workspace）
OpenClaw 支持 profile，把 state/config 隔离到：
例如你要一个”实验环境”不影响正式：
再配合：
- ：开发隔离模式（端口也会偏移）
当你的配置越来越大（多个 agent、多渠道、多白名单），别把所有东西塞一个文件。
：
优点：
- 结构清晰
- 好审计
- 适合 git 管理
典型玩法：
- ：只允许工作群触发，工具权限更严格
- ：私聊全权限
- ：专门做检索/汇总
核心就是：
- 定义多个 agent
- 把某个渠道/账号/群/私聊 路由到不同 agent
这块建议你确定”你想怎么分工”，再按你的真实渠道（Telegram 群/私聊）写一份可用的配置骨架。
关于 OpenClaw 作者自己的开发方法论和工作流思路，推荐阅读 OpenClaw 作者的 Claude Code 开发方法论。
的安全提示里有一条常见告警：
- “多个 Telegram 私信可能共享 main session，可能泄露上下文”
解决思路：把 DM scope 改成按用户隔离（具体字段因版本而异，一般在 / / 附近）。
如果你把你当前 里 session 段贴出来（打码 token），就可以对照调整成最安全的写法。
- 先用 Dashboard 验证（最快）：
- 再用 TUI 形成”命令行肌肉记忆”：
- 最后再接入 Telegram/WhatsApp，避免一开始就踩权限/配对坑。
这个循序渐进的思路也适用于其他 AI 工具的上手过程，关于 AI 工作流的更多建议可参考 AI 工作流实战手册。
- 群聊：
- 只对特定关键词触发：配置
- 入站防抖：把连续多条消息合并（）
- ：收到消息先用表情确认
- ：自动加前缀（比如显示模型/think level）
- 多 agent：一个负责写作，一个负责检索，一个负责运维
你可以用 OpenClaw 的 cron 做”准点提醒/定时任务”。
- 一次性：比如 20 分钟后提醒
- 周期性：比如每天早上 9 点
在聊天里可以直接让 AI 帮你配（需要告诉它：时间、内容、发到哪个渠道/对象）。
- 先看 Gateway 是否运行：
- 看日志：
- 检查渠道状态：
- 如果你在用 TUI：确认有没有开投递
- 在 TUI：
- 看 schema 错误
- 回滚
- 修改后再
这通常不是”OpenClaw 坏了”，而是：
- 命令跑太久被外部杀
- 你手动关了终端/会话
- 工具进程被系统回收
应对：
- 用 看真实原因
- 把长任务放到后台（或拆分）
选择：Telegram 私聊用、暂时不用群、先不拆多 agent。
目标：
- 私聊按用户隔离会话（避免”不同私信共享上下文/串台”）
- 禁用群聊（最省心）
- 保持单一 agent（简单）
把下面保存到：（JSON5，支持注释/尾逗号）。
改完配置后重启 Gateway：
如果你想验证”隔离是否生效”：用两个不同 TG 账号分别私聊机器人，问它”我是谁/我们刚聊了什么”，它不应该互相串上下文。
如果你后面要启用群、或者要拆 agent：确定你的目标后，再补 和 的**实践版本。
这一节解决三个最常见的新手问题：
- 我现在到底用的是哪份配置？
- 我改了配置，怎么确认生效？
- 我把配置改坏了，怎么快速回滚？
默认配置文件路径：
（macOS 上展开后一般是：）
小技巧：如果你是多 profile（），配置/状态目录会变成 ，不要改错地方。
最常用的三条：
- ：确认服务在不在
- ：看整体健康、渠道、更新提示
- ：你重启后这里会直接告诉你配置校验有没有报错
配置是启动时加载的，所以你改完后需要重启 Gateway：
如果你是前台手动跑的（不是 daemon/launchd）：
- 停掉
- 再 启动
OpenClaw 提供了配置助手命令，适合小幅调整：
- 读取：
- 设置（注意：如果值不是纯字符串，通常要加 ，按 JSON5 解析）：
- 删除：
注意：改完同样需要 才会生效。
第一次能正常跑起来后，建议你先备份一份”可用配置”：
如果你改崩了（Gateway 起不来/一直报 schema 错）：
OpenClaw 的配置是 严格 schema，字段错一个字母都不行。
排查顺序：
- 先跑 doctor 看诊断：
- 再跟日志看具体哪个字段不对：
- 必要时用 把信息一次性收集齐：
- 把 JSON 当 JSON5：JSON5 允许注释/尾逗号；但如果你在某些编辑器里自动格式化成严格 JSON，可能会把你注释删掉或改乱结构。
- profile 搞混： 用的是 ，你改 不会生效。
- 忘了重启：改文件后不重启，等于没改。
- 以为 TUI 默认会”发回 Telegram”：TUI 默认不投递，记得 （或者启动时 ）。
OpenClaw 的核心价值在于：一个本地网关，连接所有聊天平台和 AI 模型。掌握了 Gateway + Agent + Session 这三个概念，再配合 TUI 和 Dashboard，你就能把它玩出花来。
对于新手，建议按照 Dashboard → TUI → Telegram 的顺序渐进上手；对于老鸟， 隔离环境、 配置拆分、多智能体路由是最值得探索的三个方向。
最后，记住排障三板斧：、、。90% 的问题都能靠这三条命令定位。
- ClawdBot：海外爆火的个人 AI 管家，30 分钟搭建指南
- Moltbot 深度解析：从爆火到改名，个人 AI Agent 的机遇与暗礁
- Moltbot Wizard 完全指南：打造你的私人 AI 助手
- OpenClaw 作者的 Claude Code 开发方法论
- OpenClaw 记忆实施策略解析：工具驱动的 RAG 与”按需回忆”
- Moltbook 深度解析：AI Agent 专属社交网络的疯狂实验
- AI 工作流实战手册：从提示词到编程，真正把 AI 用起来
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容，请联系我们，一经查实，本站将立刻删除。
如需转载请保留出处：https://51itzy.com/kjqy/212446.html