AI 编程教程中文版

OpenClaw 小龙虾中文教程

翔宇自研多 Agent 协作框架的中文教程，连接主站个人实践和开源内容源。

OpenClaw（小龙虾）是翔宇自研的多 Agent 协作框架，给 AI 一个 24 小时常驻的"家"：不只是聊天工具，更是有工位、有记忆、能接电话的 AI 员工容器。

这个教程仓的定位是 OpenClaw 的公开手册和中文说明源。它要像成熟产品文档一样清楚、可查、可复现，但表达和学习路径按中文开发者重写。翔宇主站负责记录个人实践、真实项目复盘和方法论判断。

这个入口解决选路问题：想先安装和配置，看"官方教程中文版"；想理解系统为什么这样设计，看"从原理到实战"。

官方定位

OpenClaw 官方文档把它定义为 self-hosted gateway（自托管聊天网关）：用一个 Gateway 进程把多个聊天平台和 AI coding agent 连起来。当前支持 10+ 渠道，常用的有 Telegram、Slack、Discord、WhatsApp、iMessage 等，完整列表以 官方文档 为准。它的重点不是"多一个聊天机器人"，而是把聊天入口、Agent 会话、workspace、工具、媒体、移动节点和控制台集中到一个自托管运行时里。

官方首页强调三件事：

  • Gateway 是 sessions、routing 和 channel connections 的 single source of truth（唯一可信源）。
  • 默认可以使用 bundled Pi binary in RPC mode（远程调用模式），并为不同 sender 建立独立 session。
  • 配置文件位于 ~/.openclaw/openclaw.json，安全收紧从 channel allowlist（渠道白名单）和 group mention rules（群组提及规则）开始。

最低环境以官方 getting-started 当前推荐的 Node LTS 为准（避免在教程里写死版本号，LTS 持续滚动）。安装入口是 npm install -g openclaw@latest；首次上手跑 openclaw onboard --install-daemon，再用 openclaw dashboard 打开本地 Control UI。

核心能力地图

能力官方事实何时用不做会怎样
Gateway单一进程负责 channel、session、routing第一天必跑——所有其他能力都依赖它没有 Gateway，就没有路由层；接 channel 也无意义
Control UI启动时打印的本地地址（默认 http://127.0.0.1:18789/）验收 + 日常运维 + 排障看不到 sessions 状态，出错只能盲调
ChannelsTelegram、Slack、Discord、WhatsApp、iMessage、Teams 等每次只接一个，先做 allowlist 再放开一开始接 5 个会让排障困难，allowlist 没设会被陌生人调用
Multi-agent routing可按 agent、workspace、sender 隔离 session多项目并行 / 团队共享 Gateway项目和联系人混用一个会话，上下文会脏，模型容易跑偏
NodesiOS、Android、Canvas、camera、voice 工作流主流程稳定后再扩第一天就开移动节点，调试维度爆炸
Media图片、音频、文档的收发真实业务流程定下来后再开没设大小 / 隐私限制时，敏感文件会被外发
Securitytokens、allowlists、mention rules、远程访问第一天就收紧默认全开 = 个人 Gateway 暴露成公共机器人

两条互补路径

flowchart LR
    A[OpenClaw 中文教程] --> B[官方教程中文版]
    A --> C[从原理到实战]
    B --> D[安装 / Gateway / 配置 / Channel / 自动化]
    C --> E[概念 / 设计 / 实践复盘]

官方教程中文版

安装、Gateway、配置、Agent、Channel、安全远程访问和自动化。

从原理到实战

10 篇核心讲解，从概念、架构到设计复盘。

第一次接触 OpenClaw，先读官方教程中文版；想理解为什么要这样设计，再读从原理到实战。不要反过来从设计复盘开始，否则很容易把产品判断和可执行配置混在一起。

先跑起来，再谈设计复盘：没有本机 Gateway、Dashboard、workspace 和第一条消息，很多架构概念会变成空判断。

适合谁读

  • 想把 OpenClaw 跑起来的中文开发者。
  • 想理解 Gateway、Agent、Channel、Session、Task 边界的人。
  • 想把 AI 助手从聊天窗口推进到常驻工作流的人。
  • 想给自己的 Agent 设计 workspace、长期记忆、远程入口和自动化规则的人。

这不是泛泛介绍多 Agent 的文章合集。每一篇都应该回答三个问题：这个机制解决什么问题、什么时候该用、怎么验证它真的工作。

建议路径

阶段先读什么目标
跑起来官方教程中文版 / 入门与安装安装、onboarding、Dashboard、workspace
稳下来官方教程中文版 / Gateway 运行时配置 Gateway、Agent、Channel、安全和自动化
想清楚从原理到实战理解 AI home、记忆、渠道和设计取舍
接项目主站实践文章看真实项目复盘和方法论判断

第一轮验收标准

第一次学习 OpenClaw，不要以“看懂概念”为完成标准，要以可观察结果为准：

  1. openclaw --help 或安装命令可执行。
  2. openclaw onboard --install-daemon 的执行路径清楚，知道是否安装了 daemon。
  3. openclaw dashboard 能打开 Control UI。
  4. Dashboard 里能看到 chat、config、sessions 或 nodes 相关入口。
  5. ~/.openclaw/openclaw.json 的职责说得清。
  6. 至少一个 channel 的 allowlist 或 mention rule 已经规划。
  7. 远程访问方式没有绕过 Tailscale、SSH 或官方建议路径。
  8. 不同 sender、workspace、agent 的 session 隔离策略能解释。

这 8 项跑通后，再进入多渠道、移动节点、自动化和真实项目接入。

三层职责与编辑原则

教程站、翔宇主站、GitHub 三层分工各有去向：

层装什么不装什么
教程站（本仓）OpenClaw 公开手册、术语、架构、使用路径翔宇个人项目复盘
翔宇主站OpenClaw 个人实践、产品判断、一人公司案例可复现的安装命令清单
GitHub 仓库可追踪的公开内容源、文档演进实践故事

教程页可复现操作，主站文章真实实践与判断，GitHub 保留可追踪源——三类信息分开后，用户从搜索进来不会被打断。

官方事实以 docs.openclaw.ai 为准。本教程不复制英文文档结构，而是按中文新手最容易踩坑的顺序重写。具体编辑原则：

  • 职责边界写在命令之前——读者要先明白"为什么做"才看得懂"怎么做"。
  • 验收标准写在配置之前——配完没验证 = 不算配完。
  • workspace / state / config / credentials 的差异写在自动化之前——基础概念错位时，自动化只会放大错误。
  • 安全、远程访问、channel allowlist 默认收紧——一开始就放开，后续很难收回。

三类内容不要混：官方事实用于操作教程，系统判断用于原理文章，真实项目复盘放回主站实践文章。

官方资料

延伸学习

OpenClaw 从原理到实战

10 篇 OpenClaw 深度讲解的阅读地图：从 AI 为什么需要一个家，到消息旅程、记忆、Workspace、多 Agent、心跳、安全和设计复盘。

本页目录

官方定位核心能力地图两条互补路径适合谁读建议路径第一轮验收标准三层职责与编辑原则官方资料延伸学习