官方教程中文版

OpenClaw 官方教程中文版

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

這裡按 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 或自動化：

先完成入門與安裝，確認 openclaw --version、openclaw status、Dashboard 都能跑。
再讀 Gateway 架構，理解 Gateway 是常駐控制面，不是一次性 CLI。
接著配置 Gateway、Agent 和 workspace，把執行時邊界固定下來。
然後配置 Channel，把“誰能叫醒誰、在哪個會話裡說話”講清楚。
最後看安全遠端訪問和自動化，避免把公網入口、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。

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

官方來源

官方文件索引：https://docs.openclaw.ai/llms.txt
安裝：https://docs.openclaw.ai/install
快速開始：https://docs.openclaw.ai/start/getting-started
配置：https://docs.openclaw.ai/gateway/configuration
Gateway 架構：https://docs.openclaw.ai/concepts/architecture
安全：https://docs.openclaw.ai/gateway/security
自動化：https://docs.openclaw.ai/automation

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

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

入門與安裝

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

本頁目錄

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