一句话结论
OpenClaw 的核心是自托管 Gateway:把 Telegram、WhatsApp、Slack、WebChat 等渠道路由到带 workspace、memory、skills 和工具的 Agent。
适用场景
- 想把个人 AI 助手接到 Telegram、WhatsApp、Slack、WebChat 等渠道
- 想在自己的机器或服务器运行 Gateway,并保留对配置和数据的控制
- 想让多个隔离 Agent 按渠道、账号或发送者路由
常见现象
- 听过 OpenClaw 但不确定能做什么
- 在 OpenClaw、Dify、n8n、Coze 之间挑不出来
- 不确定它是否符合自己的场景
原因解释
- Gateway 是会话、路由和渠道连接的中心;Control UI 主要用于聊天、配置、会话和节点管理
- 每个 Agent 可以拥有独立 workspace、状态目录、模型配置和会话历史
- skills、plugins、memory 和工具负责扩展能力;它不是默认就具备拖拽式 RAG 或可视化 pipeline 的 Dify 替代品
解决步骤
- 按官方安装页安装 OpenClaw,并运行 `openclaw onboard --install-daemon` 完成模型、Gateway 和服务引导
- 运行 `openclaw doctor` 与 `openclaw gateway status`,确认配置和 Gateway 状态
- 用 `openclaw dashboard` 打开本地 Control UI,先完成一次最小对话
- 再按官方 channel 文档接入一个渠道,例如 Telegram;先限制访问范围并人工测试
- 确有多个角色时再创建隔离 Agent 和 bindings;顺序多步流程需明确选择 Task Flow、Lobster 或插件实现
仍然不行怎么办
- 启动失败先看 OpenClaw Gateway 启动失败怎么办
- 不熟 API Key 先看 API Key 是什么
- 想要更轻量的方案,可以用 Codex 或 Claude Code 跑命令行任务
小白先准备什么
- 一台受支持的 macOS、Linux 或 Windows 电脑;普通安装不要求 Docker
- 受支持的 Node 运行时(Node 24.15+ 推荐,Node 22.22.3+ 仍支持)或按官方 Docker 流程准备 Compose v2
- 一个来自所选模型服务的专用 API Key,并确认所在地和用途符合平台条款
- (可选)一个 Telegram Bot Token,如果想接 Telegram
- 先预留时间完成 onboarding、权限检查和一个最小渠道测试
验收标准
- `openclaw doctor` 没有阻断项,`openclaw gateway status` 显示 Gateway 正常
- `openclaw dashboard` 能打开 Control UI(本地默认地址为 http://127.0.0.1:18789/)
- 默认 Agent 能完成最小对话;接入渠道后,受控测试账号能收到回复
- 能说出 OpenClaw 和 Dify / n8n / Coze 的核心区别
可复制提示词
安装并完成 onboarding 后,可先用默认 Agent 发送这段提示词验证最小对话;不必为了测试先创建多个 Agent:
你是一个测试助手。用户发任何消息,你都回复:
1. 收到的消息内容
2. 当前时间
3. 一句鼓励的话
如果用户说「测试结束」,回复「OpenClaw 接入成功,可以开始正式配置了」。
常见误区
- 误区:OpenClaw 是拖拽式工作流面板 → 它的核心是 Gateway、渠道、Agent runtime、workspace、memory、skills 和路由
- 误区:完全不需要技术基础 → 自托管仍要理解凭据、配置、权限、日志、网络暴露和备份
- 误区:装好就能直接接管业务 → 应先完成 onboarding、最小对话、渠道权限和失败兜底测试
- 误区:多 Agent 就是顺序 pipeline → bindings 负责把入站消息路由到隔离 Agent;多步编排需 Task Flow、Lobster 或插件
还卡着?
仅把删除凭证、客户数据和环境变量值后的必要截图、日志片段、需求说明或当前页面链接发到 zhemuy@gmail.com。