OpenClaw 教程 · 小白

OpenClaw 是什么,适合做什么

OpenClaw 是一个自托管、多渠道的 AI Agent Gateway,通过一个 Gateway 连接聊天渠道、Control UI、会话、工具与多个隔离 Agent。

  • OpenClaw
  • 概览
更新于 2026-07-26

一句话结论

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 替代品

解决步骤

  1. 按官方安装页安装 OpenClaw,并运行 `openclaw onboard --install-daemon` 完成模型、Gateway 和服务引导
  2. 运行 `openclaw doctor` 与 `openclaw gateway status`,确认配置和 Gateway 状态
  3. 用 `openclaw dashboard` 打开本地 Control UI,先完成一次最小对话
  4. 再按官方 channel 文档接入一个渠道,例如 Telegram;先限制访问范围并人工测试
  5. 确有多个角色时再创建隔离 Agent 和 bindings;顺序多步流程需明确选择 Task Flow、Lobster 或插件实现

仍然不行怎么办

  • 启动失败先看 OpenClaw Gateway 启动失败怎么办
  • 不熟 API Key 先看 API Key 是什么
  • 想要更轻量的方案,可以用 Codex 或 Claude Code 跑命令行任务

小白先准备什么

  1. 一台受支持的 macOS、Linux 或 Windows 电脑;普通安装不要求 Docker
  2. 受支持的 Node 运行时(Node 24.15+ 推荐,Node 22.22.3+ 仍支持)或按官方 Docker 流程准备 Compose v2
  3. 一个来自所选模型服务的专用 API Key,并确认所在地和用途符合平台条款
  4. (可选)一个 Telegram Bot Token,如果想接 Telegram
  5. 先预留时间完成 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。