CodeRoadMap
首页路线题库资源库文章社区
CodeRoadMap

程序员的学习成长路线图。内容免费开放,登录后可同步路线图与课时进度。

由 程序员柏风 独立维护 · 关于作者

学习

  • 路线图
  • 课程
  • 面试题
  • 文章
  • 我

更多

  • 资源
  • 社区
  • 关于作者
  • 内容说明

© 2026 CodeRoadMap

津ICP备2026012044号-1·津公网安备12011002026155号·coderoadmap@126.com
OpenClaw 实战入门/课时/OpenClaw 概览
RawBlame
课时目录12 节

OpenClaw 实战入门

  1. 01OpenClaw 概览
  2. 02安装与部署
  3. 03Workspace 文件
  4. 04Gateway 与上下文
  5. 05模型与 Provider
  6. 06Channels 集成
  7. 07Skills 生态
  8. 08Memory 系统
  9. 09Agents 与路由
  10. 10自动化
  11. 11安全
  12. 12运维与插件

OpenClaw 概览

Agent 平台与使用场景。

30 分钟

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 装成常驻服务。
    加载本节练习…
    下一课 →安装与部署