OpenClaw 小龍蝦中文教程

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 狀態，出錯只能盲調
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 暴露成公共機器人

兩條互補路徑

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，不要以“看懂概念”為完成標準，要以可觀察結果為準：

openclaw --help 或安裝命令可執行。
openclaw onboard --install-daemon 的執行路徑清楚，知道是否安裝了 daemon。
openclaw dashboard 能開啟 Control UI。
Dashboard 裡能看到 chat、config、sessions 或 nodes 相關入口。
~/.openclaw/openclaw.json 的職責說得清。
至少一個 channel 的 allowlist 或 mention rule 已經規劃。
遠端訪問方式沒有繞過 Tailscale、SSH 或官方建議路徑。
不同 sender、workspace、agent 的 session 隔離策略能解釋。

這 8 項跑通後，再進入多渠道、移動節點、自動化和真實專案接入。

三層職責與編輯原則

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

層	裝什麼	不裝什麼
教程站（本倉）	OpenClaw 公開手冊、術語、架構、使用路徑	翔宇個人專案覆盤
翔宇主站	OpenClaw 個人實踐、產品判斷、一人公司案例	可復現的安裝命令清單
GitHub 儲存庫	可追蹤的公開內容源、文件演進	實踐故事

教程頁可復現操作，主站文章真實實踐與判斷，GitHub 保留可追蹤源——三類資訊分開後，使用者從搜尋進來不會被打斷。

官方事實以 docs.openclaw.ai 為準。本教程不復制英文文件結構，而是按中文新手最容易踩坑的順序重寫。具體編輯原則：

職責邊界寫在命令之前——讀者要先明白"為什麼做"才看得懂"怎麼做"。
驗收標準寫在配置之前——配完沒驗證 = 不算配完。
workspace / state / config / credentials 的差異寫在自動化之前——基礎概念錯位時，自動化只會放大錯誤。
安全、遠端訪問、channel allowlist 預設收緊——一開始就放開，後續很難收回。

三類內容不要混：官方事實用於操作教程，系統判斷用於原理文章，真實專案覆盤放回主站實踐文章。

官方資料

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

延伸學習

OpenClaw 實戰文章：xiangyugongzuoliu.com/tag/openclaw
翔宇 AI 程式設計實操課：檢視課程介紹與學習路徑
OpenClaw 教程公開儲存庫：github.com/xiangyugongzuoliu/openclaw-tutorial

OpenClaw 小龍蝦中文教程

官方教程中文版

從原理到實戰

本頁目錄