OpenClaw 概览

这一课你将能做到

1. 用一句话说清楚 OpenClaw 是什么、不是什么
2. 说出 OpenClaw 与 Claude Code 这类编码助手的本质区别
3. 判断一个团队场景（代码评审 bot、值班问答、定时任务）适不适合用 OpenClaw 落地

为什么要学

你已经在用 ChatGPT、Claude Code 这类工具了，但它们有一个共同短板：它们活在网页或终端里，你不去找它，它永远不会来找你。而团队真正需要的是：Slack 里有人 @ 一下就回答值班问题的机器人、每天早上 9 点自动发 PR 汇总、收到 webhook 就自动评审代码的 bot。

OpenClaw 就是干这个的：一个跑在你自己机器上的开源 AI 助手网关（Gateway），把大模型接入你已经在用的聊天软件——Slack、Telegram、Discord、WhatsApp、iMessage、飞书等。它 MIT 协议开源、数据留在本地、由独立非营利组织维护，没有订阅费，模型 API key 用你自己的。

人话：Claude Code 是「坐在你旁边的结对程序员」，OpenClaw 是「住在群里、7×24 在线的团队成员」。

先建立图像

OpenClaw 的核心架构一句话：一个常驻 Gateway 进程，一边连聊天渠道，一边连模型，中间挂着你的工具、记忆和自动化。

 Slack / Telegram / Discord / WebChat
        │   ▲
  消息进来 │   │ 回复出去
        ▼   │
   ┌─────────────────────────┐
   │   OpenClaw Gateway       │  ← 常驻进程，默认端口 18789
   │  ┌───────────────────┐  │
   │  │ Agent（大模型）     │  │  ← Claude / GPT / Ollama
   │  ├───────────────────┤  │
   │  │ Skills / Tools     │  │  ← 可插拔能力
   │  ├───────────────────┤  │
   │  │ Memory / Cron      │  │  ← 记忆与自动化
   │  └───────────────────┘  │
   └─────────────────────────┘
        │
   你的文件、shell、浏览器（受权限控制）

一次对话的完整旅程：同事在 Slack 发消息 → Gateway 收到 → 查记忆和权限 → 调模型 → 可能执行工具（查日志、跑脚本）→ 回复到 Slack。全程消息不经过任何第三方服务器中转，除了你自己的模型 API 调用。

跟着做

步骤 1：确认环境

OpenClaw 基于 Node.js，需要 Node 24+：

node --version

步骤 2：一行命令体验

不安装任何东西，先跑一次：

npx openclaw@latest

如果你机器上已有 Claude Code 或 Codex CLI 的登录态，选 Quick start，OpenClaw 会自动复用它并完成一次真实模型调用做验证。

步骤 3：看仪表盘

Quick start 会前台启动 Gateway 并打开 Web 控制台（Control UI）。在聊天框里发一句「你是谁」，收到回复说明：模型通了、Gateway 活了。

步骤 4：认清三种形态

形态	用法	适合
CLI + Gateway 服务	npm i -g openclaw	开发者、服务器部署
桌面 App（macOS/Win/Linux）	下载安装包	不想碰命令行的成员
Docker	官方镜像	VPS、团队共享实例

步骤 5：场景速判

对照你的需求判断 OpenClaw 是否合适：

• 代码评审 bot：合适。GitHub webhook 触发 → reviewer agent 读 diff → 评论到 PR。
• 值班问答：合适。值班同事在群里 @ bot → 查记忆里的 runbook → 给排查步骤。
• 定时数据报表：合适但大材小用。纯 SQL 报表用 cron + 脚本更稳，OpenClaw 适合「需要理解上下文才能写」的摘要。
• 替代 CI/CD：不合适。构建、测试、部署必须确定性，LLM 不该进这个链路。

讲清楚要点

1. OpenClaw 不是模型，是「助手的身体」：模型（Claude/GPT）是大脑，OpenClaw 提供眼睛（读消息）、手（执行工具）、记忆（Memory）和作息（Cron）。
2. Gateway 是核心进程：所有渠道、会话、工具调用都经过它。理解 OpenClaw = 理解 Gateway 的生命周期。
3. 自带信任边界：DM 默认要配对（pairing）才回复，工具执行有权限模式，敏感操作要审批。它不是「谁都能使唤的 bot」。
4. 与 Claude Code 互补而非替代：Claude Code 管「写代码这一刻」，OpenClaw 管「代码之外的协作流转」——值班问答、定时巡检、消息触达。
5. 状态全在本地 ~/.openclaw/：配置、会话、记忆都在你自己磁盘上，可备份、可迁移、可审计。

你可能会懵的地方

• OpenClaw 和 Clawdbot 什么关系？ 同一个项目。早期叫 Clawdbot，后更名 OpenClaw，所以你搜老资料会看到旧名和旧文档域名。

• 它和 Dify、Coze 这类低代码 bot 平台区别在哪？ 那些是托管 SaaS，数据和逻辑在别人服务器上；OpenClaw 自托管，能直接碰你本地的文件、脚本和内网服务，这是团队自动化场景的关键差异。

• 它是免费的吗？ 软件免费（MIT），但模型调用要花 API 费用，key 是你自己的 Anthropic/OpenAI 账号。也可以接 Ollama 本地模型做到零 API 成本。

• 没有公网服务器能用吗？ 能。Gateway 默认绑 loopback（127.0.0.1），Telegram 等渠道是 Gateway 主动出站长连接，不需要公网 IP 和域名。

• 手机上怎么用？ OpenClaw 本身没有手机 App，它寄生在 Telegram/Slack 这些你已有的 App 里——给 bot 发消息就是用法。

错法对照

错法	问题	正解
把 OpenClaw 当 ChatGPT 网页用	它是基础设施，不是成品应用	用它搭「团队 bot」，不是「个人聊天窗口」
一上来就接所有渠道	配置面爆炸，难排查	先接一个渠道（推荐 Telegram，只要 bot token）跑通再扩
跳过 pairing 直接开放 DM	陌生人能指挥你的 agent 执行本地命令	保持默认 pairing，只放行白名单成员
用生产服务器裸跑前台进程	终端关掉 bot 就死	用 openclaw gateway install 装成系统服务
指望它替代 CI/CD	它是 LLM agent，非确定性	确定性流水线仍用 CI，它做需要「理解」的环节

卡点急救

1. npx openclaw@latest 卡住不动：先确认 Node ≥ 24（node --version），老版本 Node 会直接报引擎不兼容。
2. Quick start 检测不到模型登录：说明本机没有可用的 Claude Code/Codex 登录态，改选 Custom setup 手动填 API key。
3. 控制台打不开：确认前台 Gateway 没被 Ctrl+C 停掉；端口被占时换端口或先 openclaw gateway status 查占用。

面试常问

• OpenClaw 的架构核心是什么？ 一个常驻 Gateway 进程：向上接各聊天渠道（Channel），向下接模型 Provider 与本地工具，中间由 Agent 循环串联，辅以 Memory 和 Cron。所有状态落盘在本机，渠道通过出站连接收发消息，无需公网入口。

• 什么场景选 OpenClaw 而不是直接在群里嵌个 LLM API 脚本？ 当你需要：跨渠道统一会话、长期记忆、定时/事件自动化、权限与审批、可插拔技能时。裸脚本只能做一次性问答，OpenClaw 提供的是「可持续运营的团队成员」。

• 数据安全怎么保证？ 自托管：配置、会话、记忆全在本地 ~/.openclaw/；出站只到你的模型 API；DM 默认 pairing 鉴权；工具执行有权限模式和审批层；密钥可用 SecretRef 引用外部密钥管理器而不写死在配置里。

自测三问

1. OpenClaw 与 Claude Code 的定位差异是什么？各举一个适用场景。
2. Gateway 进程在架构里承担什么职责？默认监听哪个端口？
3. 为什么说 OpenClaw 部署不需要公网 IP？

小结一句话

OpenClaw 是跑在自己机器上的开源 AI 助手网关：把大模型变成群里随叫随到、有记忆、能干活、受权限约束的团队成员。

延伸

• OpenClaw 官方文档
• GitHub 仓库 openclaw/openclaw
• 下一课：安装与部署——本地、Docker 与 VPS 三条路径，把 Gateway 装成常驻服务。