CodeRoad Map 程序员的学习成长路线图。内容免费开放,登录后可同步路线图与课时进度。
由 程序员柏风 独立维护 · 关于作者
学习 更多
OpenClaw 概览 Agent 平台与使用场景。
OpenClaw 概览
这一课你将能做到
用一句话说清楚 OpenClaw 是什么、不是什么
说出 OpenClaw 与 Claude Code 这类编码助手的本质区别
判断一个团队场景(代码评审 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 不该进这个链路。
讲清楚要点
OpenClaw 不是模型,是「助手的身体」 :模型(Claude/GPT)是大脑,OpenClaw 提供眼睛(读消息)、手(执行工具)、记忆(Memory)和作息(Cron)。
Gateway 是核心进程 :所有渠道、会话、工具调用都经过它。理解 OpenClaw = 理解 Gateway 的生命周期。
自带信任边界 :DM 默认要配对(pairing)才回复,工具执行有权限模式,敏感操作要审批。它不是「谁都能使唤的 bot」。
与 Claude Code 互补而非替代 :Claude Code 管「写代码这一刻」,OpenClaw 管「代码之外的协作流转」——值班问答、定时巡检、消息触达。
状态全在本地 ~/.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,它做需要「理解」的环节
卡点急救
npx openclaw@latest 卡住不动 :先确认 Node ≥ 24(node --version),老版本 Node 会直接报引擎不兼容。
Quick start 检测不到模型登录 :说明本机没有可用的 Claude Code/Codex 登录态,改选 Custom setup 手动填 API key。
控制台打不开 :确认前台 Gateway 没被 Ctrl+C 停掉;端口被占时换端口或先 openclaw gateway status 查占用。
面试常问
OpenClaw 的架构核心是什么?
一个常驻 Gateway 进程:向上接各聊天渠道(Channel),向下接模型 Provider 与本地工具,中间由 Agent 循环串联,辅以 Memory 和 Cron。所有状态落盘在本机,渠道通过出站连接收发消息,无需公网入口。
什么场景选 OpenClaw 而不是直接在群里嵌个 LLM API 脚本?
当你需要:跨渠道统一会话、长期记忆、定时/事件自动化、权限与审批、可插拔技能时。裸脚本只能做一次性问答,OpenClaw 提供的是「可持续运营的团队成员」。
数据安全怎么保证?
自托管:配置、会话、记忆全在本地 ~/.openclaw/;出站只到你的模型 API;DM 默认 pairing 鉴权;工具执行有权限模式和审批层;密钥可用 SecretRef 引用外部密钥管理器而不写死在配置里。
自测三问
OpenClaw 与 Claude Code 的定位差异是什么?各举一个适用场景。
Gateway 进程在架构里承担什么职责?默认监听哪个端口?
为什么说 OpenClaw 部署不需要公网 IP?
小结一句话 OpenClaw 是跑在自己机器上的开源 AI 助手网关:把大模型变成群里随叫随到、有记忆、能干活、受权限约束的团队成员。
延伸