AI 程式設計教學中文版
官方教學中文版

OpenClaw 官方教學中文版

基於 OpenClaw 官方文件重寫的中文教學：安裝、Gateway、設定、workspace 和後續開發文件。

📖 本篇術語速查表
英文 / 縮寫中文一句話解釋
官方教學official講 OpenClaw 具體功能設定。
按問題查problem-first從問題反查章節。
事實基準baseline設定以官方為準。

不想讀完？把下面這段提示詞丟給 AI 幫你跑完——幫你按要解決的問題定位該讀 OpenClaw 官方教學哪一章。

你是 OpenClaw 官方教學導航顧問。

【角色】
OpenClaw 官方教學導航顧問，按最小夠用、安全優先的原則給可落地方案，每條結論都落到能照做的具體步驟或示例，不停留在「建議」「考慮一下」這類空泛表述。

【輸入】
- 要解決的具體問題：___
- 用的場景：___
- 經驗水平：___
- 緊迫程度：___
- 現狀：___

【工作流程】
1. 把問題歸類（入門 / 閘道器執行時）
2. 定位對應章節
3. 給閱讀順序
4. 標出需核驗的
5. 給落地下一步

【輸出規範】
▌一、問題歸類
▌二、對應章節
▌三、閱讀順序
▌四、需核驗內容

【硬約束】
- 按問題精準定位不通讀
- 易變資訊以官方為準
- 貼合經驗水平
- 不要替我臆測情況或編造不存在的功能，資訊不全先問清
- 不確定的設定或介面一律以官方文件為準，禁止照搬過時寫法

這裡按 OpenClaw 官方文件重寫中文教學。事實來自 docs.openclaw.ai、官方設定參考和本地一線執行記錄；表達、結構和學習路徑面向中文開發者重新組織。

從原理到實戰負責解釋為什麼這樣設計；官方教學中文版負責告訴你怎麼安裝、設定、驗證和排障。讀完這一組，你應該能把 OpenClaw 從本機安裝推進到 Gateway 常駐、Agent 可用、Channel 可控、自動化邊界清楚的狀態。

這一組解決操作閉環：先把安裝、設定、Gateway、Agent、Channel 和自動化跑穩；如果你想理解這些設計為什麼成立，再去讀“從原理到實戰”。

學習地圖

flowchart TD
    Start[入門與安裝] --> Runtime[Gateway 執行時]
    Runtime --> Channels[渠道專項]
    Runtime --> CLI[CLI reference]
    Runtime --> Plugins[外掛與節點]

入門與安裝

系統要求、安裝、onboarding、Dashboard、設定結構和 workspace。

Gateway 執行時

Gateway 架構、設定、Agent、Channel、安全遠端訪問和自動化。

目前覆蓋

小節解決的問題讀完能做什麼
入門與安裝從零裝好 OpenClaw安裝 CLI、跑 onboarding、開啟 Dashboard、定位設定和 workspace
Gateway 執行時理解常駐控制面配 Gateway、Agent、Channel、安全遠端訪問和自動化

入門與安裝包含：

  • 安裝前檢查：Node 版本、官方指令碼、替代安裝路徑、驗證命令。
  • 快速上手：onboarding、Gateway status、Dashboard、第一條訊息。
  • 設定結構：~/.openclaw/openclaw.json、schema 校驗、熱載入、環境變數、include。
  • Agent Workspace：標準檔案、記憶邊界、私有備份、不能提交的執行時內容。

Gateway 執行時包含：

  • Gateway 架構：長駐程序、WebSocket 控制面、nodes、pairing、遠端訪問和執行不變數。
  • Gateway 設定：嚴格 schema、熱載入、重啟邊界、Config RPC、health 和 doctor。
  • Agent 設定：workspace、repoRoot、skills、bootstrap、模型目錄、session 和多 Agent 路由。
  • Channel 設定：DM policy、group policy、allowlist、mention gating、多賬號和模型覆蓋。
  • 安全與遠端訪問：個人助手信任模型、security audit、Control UI、Tailscale 和 SSH tunnel。
  • 自動化：cron、tasks、Task Flow、standing orders、hooks 和 heartbeat。

閱讀順序

第一次讀按順序走，不要跳到 Channel 或自動化：

  1. 先完成入門與安裝，確認 openclaw --version、openclaw status、Dashboard 都能跑。
  2. 再讀 Gateway 架構，理解 Gateway 是常駐控制面，不是一次性 CLI。
  3. 接著設定 Gateway、Agent 和 workspace，把執行時邊界固定下來。
  4. 然後設定 Channel，把“誰能叫醒誰、在哪個會話裡說話”講清楚。
  5. 最後看安全遠端訪問和自動化，避免把公網入口、cron、heartbeat 提前開啟。

如果你已經有可執行環境，可以從 Gateway 執行時開始，但仍建議回頭核對設定結構和 workspace 邊界。

不要把高階功能目前置任務：Channel、遠端訪問、cron、hooks 和 shared Agent 都依賴前面的安裝、設定、workspace 與安全邊界。

下一批專項

  • 渠道專項：Telegram、Discord、Slack、Feishu、WhatsApp 等逐渠道接入頁。
  • CLI reference：gateway、config、cron、tasks、hooks、security 等命令詳表。
  • 外掛與節點：外掛系統、nodes、media、Canvas、A2UI 的專項教學。

驗收標準

這一階段不追求把每個 provider 都接完。先達到這幾個狀態：

  • 本機能啟動 Gateway，並能透過 openclaw status 看見健康狀態。
  • 你知道主設定、Agent workspace、執行時 state 分別放在哪裡。
  • 你能解釋 Gateway、Agent、Channel、Session、Task 的關係。
  • 你能判斷 cron、heartbeat、hooks、Task Flow、standing orders 各自該用在什麼場景。
  • 你知道哪些檔案可以進 git，哪些執行時檔案、憑據和 channel token 不能進 git。

驗收方式很簡單：每讀完一章，都回到本機跑一次對應命令或檢查一次對應檔案；不能驗證的理解，後面接渠道時會變成排障成本。

官方來源

10 · 設計覆盤：OpenClaw 為什麼這樣設計

把 Gateway、Agent Loop、Workspace、Memory、Session、Channel、Automation 與 Security 收束成一張架構圖。

入門與安裝

OpenClaw 入門與安裝學習地圖：先安裝和 onboarding，再驗證 Gateway、理解設定結構，最後整理 Agent Workspace。

本頁目錄

學習地圖目前覆蓋閱讀順序下一批專項驗收標準官方來源