入門與安裝
OpenClaw 入門與安裝學習地圖：先安裝和 onboarding，再驗證 Gateway、理解配置結構，最後整理 Agent Workspace。
這一組只解決一件事：讓 OpenClaw 在你的機器上穩定跑起來，並且知道每個關鍵檔案、命令和頁面分別管什麼。不要一上來就接很多渠道、寫複雜 Agent 或開放遠端訪問；先把最小閉環跑通。
適合從這裡開始的人：第一次安裝 OpenClaw、換機器重灌、openclaw 命令找不到、Gateway 狀態不清楚、openclaw.json 不敢改，或者 workspace 和 ~/.openclaw/ 經常混在一起。
1. 這一組包含什麼
入門與安裝一共 4 章：
- 安裝 OpenClaw：按系統選擇官方指令碼、包管理器、本地 prefix 或原始碼安裝，並完成版本、doctor 和 Gateway 驗證。
- 快速上手 OpenClaw：用 onboarding 跑通模型認證、Gateway、Dashboard 和第一條訊息。
- 理解配置結構：分清
openclaw.json、JSON5、strict schema、熱載入、環境變數和金鑰邊界。 - 配置 Agent Workspace：理解 Agent（智慧代理）的長期工作現場，以及哪些內容不能放進 workspace git。
flowchart TD
Install["安裝 OpenClaw"]
Onboard["跑 onboarding"]
Gateway["驗證 Gateway"]
Config["理解配置結構"]
Workspace["整理 Agent Workspace"]
Runtime["進入 Gateway 執行時"]
Install --> Onboard
Onboard --> Gateway
Gateway --> Config
Config --> Workspace
Workspace --> Runtime
style Install fill:#e0f2fe,stroke:#0284c7,stroke-width:2px
style Gateway fill:#dcfce7,stroke:#22c55e,stroke-width:2px
style Config fill:#fef3c7,stroke:#f59e0b,stroke-width:2px
style Runtime fill:#ede9fe,stroke:#8b5cf6,stroke-width:2px2. 章節入口
安裝 OpenClaw
系統要求、安裝指令碼、Node 版本、替代安裝路徑和安裝後驗證。
快速上手 OpenClaw
從 onboarding 到 Gateway、Dashboard、第一條訊息和下一步渠道選擇。
理解配置結構
openclaw.json、JSON5、strict schema、熱載入、環境變數和排障順序。
配置 Agent Workspace
workspace 檔案地圖、長期記憶、私有備份、sandbox 和遷移邊界。
3. 推薦閱讀順序
新手按這個順序讀：
- 先讀“安裝 OpenClaw”，按你的系統選擇一個安裝通道，不要混裝。
- 再讀“快速上手 OpenClaw”，完成 onboarding，並確認 Gateway 正在監聽。
- 然後讀“理解配置結構”，知道什麼能用 CLI / Control UI 改，什麼必須謹慎編輯。
- 最後讀“配置 Agent Workspace”，把身份、規則、使用者資訊、工具說明和長期記憶分清。
如果你已經裝好了，可以按問題跳：
openclaw命令不存在：看安裝章節的 PATH 和 Node 全域性包路徑排查。- Gateway 沒有啟動：看快速開始裡的
gateway status、doctor、logs、health。 - 不知道配置欄位怎麼改：看配置結構裡的 schema、熱載入和排障順序。
- 想把 workspace 放進 git：先看 Workspace 章節裡的“不能提交什麼”。
跳讀也要先定位問題層：命令找不到是安裝層；Gateway 不回是執行層；配置不生效是 schema / reload 層；身份和記憶混亂才是 workspace 層。
4. 先不要做什麼
入門階段先不要急著做這些：
- 直接把 Gateway 暴露到公網。
- 把
dmPolicy設成open後不加訪問控制。 - 把
~/.openclaw/整目錄提交到 git。 - 複製陌生人的完整
openclaw.json。 - 同時接 Telegram、Discord、Slack、WhatsApp 等多個渠道。
- 先寫 cron、hooks、standing orders，再回頭排 Gateway 基礎問題。
先跑通最小閉環：能安裝、能 onboarding、能看到 Gateway、能在 Dashboard 發第一條訊息，才進入 Gateway 執行時和渠道配置。
入門階段不要擴大暴露面：Channel、遠端訪問和自動化都會放大基礎配置問題；最小閉環沒過，先不要接外部入口。
5. 完成後的驗收標準
讀完這一組，你應該能做到：
- 能解釋 OpenClaw 為什麼需要一個長期執行的 Gateway。
- 能在自己的系統上安裝並驗證
openclaw --version。 - 能執行
openclaw doctor、openclaw gateway status和openclaw dashboard。 - 能說清
~/.openclaw/openclaw.json是配置檔案，不是 workspace 內容。 - 能判斷一個配置改動是否可能熱載入，還是需要重啟 Gateway。
- 能整理 workspace 標準檔案，並避免把 token、OAuth、session 和 auth profiles 放進 git。
- 能進入下一組 Gateway 執行時，而不是繼續在安裝問題裡反覆打轉。
這一組的結束狀態：不是“看完四篇”，而是你能在本機復現安裝、診斷、啟動、開啟 Dashboard 和確認 workspace 邊界。