入門與安裝

你是 OpenClaw 入門導航顧問。

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

【輸入】
- 我對 OpenClaw 的瞭解：___
- 想接的模型 / 渠道：___
- 系統環境：___
- 想多快上手：___
- 經驗水平：___

【工作流程】
1. 確認前提
2. 排閱讀順序
3. 標出可跳過的
4. 給上手驗證
5. 給第一步

【輸出規範】
▌一、前提
▌二、閱讀順序
▌三、可跳過項
▌四、驗證 + 第一步

【硬約束】
- 前提缺失先補
- 按基礎定順序
- 先跑通再深入
- 不要替我臆測情況或編造不存在的功能，資訊不全先問清
- 不確定的設定或介面一律以官方文件為準，禁止照搬過時寫法

這一組只解決一件事：讓 OpenClaw 在你的機器上穩定跑起來，並且知道每個關鍵檔案、命令和頁面分別管什麼。不要一上來就接很多渠道、寫複雜 Agent 或開放遠端訪問；先把最小閉環跑通。

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:2px

2. 章節入口

3. 推薦閱讀順序

新手按這個順序讀：

1. 先讀“安裝 OpenClaw”，按你的系統選擇一個安裝通道，不要混裝。
2. 再讀“快速上手 OpenClaw”，完成 onboarding，並確認 Gateway 正在監聽。
3. 然後讀“理解設定結構”，知道什麼能用 CLI / Control UI 改，什麼必須謹慎編輯。
4. 最後讀“設定 Agent Workspace”，把身份、規則、使用者資訊、工具說明和長期記憶分清。

如果你已經裝好了，可以按問題跳：

• openclaw 命令不存在：看安裝章節的 PATH 和 Node 全域包路徑排查。
• Gateway 沒有啟動：看快速開始裡的 gateway status、doctor、logs、health。
• 不知道設定欄位怎麼改：看設定結構裡的 schema、熱載入和排障順序。
• 想把 workspace 放進 git：先看 Workspace 章節裡的“不能提交什麼”。

4. 先不要做什麼

入門階段先不要急著做這些：

• 直接把 Gateway 暴露到公網。
• 把 dmPolicy 設成 open 後不加訪問控制。
• 把 ~/.openclaw/ 整目錄提交到 git。
• 複製陌生人的完整 openclaw.json。
• 同時接 Telegram、Discord、Slack、WhatsApp 等多個渠道。
• 先寫 cron、hooks、standing orders，再回頭排 Gateway 基礎問題。

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 執行時，而不是繼續在安裝問題裡反覆打轉。

6. 官方資料

• Install
• Getting started
• Configuration
• Agent workspace