---
title: "OpenClaw 小龙虾中文教程"
description: "Aaron自研多 Agent 协作框架的中文教程，连接主站个人实践和开源内容源。"
verifiedAt: "2026-05-07"
---

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

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

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

## 官方定位

OpenClaw 官方文档把它定义为 self-hosted gateway（自托管聊天网关）：用一个 Gateway 进程把多个聊天平台和 AI coding agent 连起来。当前支持 10+ 渠道，常用的有 Telegram、Slack、Discord、WhatsApp、iMessage 等，完整列表以 [官方文档](https://docs.openclaw.ai) 为准。它的重点不是"多一个聊天机器人"，而是把聊天入口、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](https://docs.openclaw.ai/start/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 状态，出错只能盲调 |
| Channels | Telegram、Slack、Discord、WhatsApp、iMessage、Teams 等 | 每次只接一个，先做 allowlist 再放开 | 一开始接 5 个会让排障困难，allowlist 没设会被陌生人调用 |
| Multi-agent routing | 可按 agent、workspace、sender 隔离 session | 多项目并行 / 团队共享 Gateway | 项目和联系人混用一个会话，上下文会脏，模型容易跑偏 |
| Nodes | iOS、Android、Canvas、camera、voice 工作流 | 主流程稳定后再扩 | 第一天就开移动节点，调试维度爆炸 |
| Media | 图片、音频、文档的收发 | 真实业务流程定下来后再开 | 没设大小 / 隐私限制时，敏感文件会被外发 |
| Security | tokens、allowlists、mention rules、远程访问 | **第一天就收紧** | 默认全开 = 个人 Gateway 暴露成公共机器人 |

## 两条互补路径

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

<Cards>
  <Card title="官方教程中文版" description="安装、Gateway、配置、Agent、Channel、安全远程访问和自动化。" href="/docs/openclaw/official" />
  <Card title="从原理到实战" description="10 篇核心讲解，从概念、架构到设计复盘。" href="/docs/openclaw/understanding" />
</Cards>

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

> [!IMPORTANT]
> **先跑起来，再谈设计复盘**：没有本机 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 项跑通后，再进入多渠道、移动节点、自动化和真实项目接入。

## 三层职责与编辑原则

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

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

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

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

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

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

## 官方资料

- OpenClaw docs：[https://docs.openclaw.ai](https://docs.openclaw.ai)
- Documentation index：[https://docs.openclaw.ai/llms.txt](https://docs.openclaw.ai/llms.txt)
- Getting Started：[https://docs.openclaw.ai/start/getting-started](https://docs.openclaw.ai/start/getting-started)
- Configuration：[https://docs.openclaw.ai/gateway/configuration](https://docs.openclaw.ai/gateway/configuration)
- Security：[https://docs.openclaw.ai/gateway/security](https://docs.openclaw.ai/gateway/security)

## 延伸阅读

- OpenClaw 实践：[xiangyugongzuoliu.com/tag/openclaw](https://xiangyugongzuoliu.com/tag/openclaw)
- AI 编程实操课：[FlowUS 课程页](https://flowus.cn/xiangyugongzuoliu/share/d392dcad-b537-44ee-a3e2-56ff5af02bce)
- 公开仓库：[github.com/xiangyugongzuoliu/openclaw-tutorial](https://github.com/xiangyugongzuoliu/openclaw-tutorial)
