---
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="/zh-Hant/docs/openclaw/official" />
  <Card title="從原理到實戰" description="10 篇核心講解，從概念、架構到設計覆盤。" href="/zh-Hant/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)
