快速上手 OpenClaw：使用 CLI 引導程式輕鬆完成配置

每次安裝新的開發工具，最煩人的就是手動編輯一堆設定檔，還要擔心環境變數有沒有漏掉。你可能只是想趕快讓機器人跑起來開始聊天，卻花了大半天在處理 Gateway 連線、連接埠衝突或權限認證。

OpenClaw 提供的 Onboarding Wizard 就是為了幫你解決這些瑣事。它會引導你完成 macOS、Linux 或 Windows (WSL2) 的環境配置，讓你把精力花在開發機器人的功能上。

需要準備的東西

• macOS, Linux 或 Windows (強烈建議使用 WSL2)
• 準備好你的 Model Provider API key (如 OpenAI, Anthropic 或其他相容 API)
• 如果需要聯網功能，準備好搜尋服務的 API key (Perplexity, Brave, Gemini, Grok 或 Kimi)

快速開始

這是完成設定最快的路徑。直接在你的終端機輸入：

openclaw onboard

如果你想跳過頻道設定，直接在瀏覽器裡跟機器人對話，可以使用 Dashboard 模式：

openclaw dashboard

如果你之後需要修改設定或新增 Agent，可以使用這些指令：

# 修改現有設定
openclaw configure

# 新增一個獨立的 Agent
openclaw agents add <name>

QuickStart 預設值

當你選擇 QuickStart 模式時，系統會自動套用以下設定：

• 使用 Local Gateway (loopback)
• Gateway Port 為 18789
• 自動生成 Gateway Auth Token
• Tool policy 預設為 "coding"
• Telegram 和 WhatsApp 預設開啟 allowlist（會詢問你的電話號碼）
• Tailscale 預設為 Off

Onboarding Wizard 會幫你設定什麼？

在 Local mode（預設）下，引導程式會走過這幾個步驟：

1. Model/Auth：選擇你的 Provider 並貼上 API key。如果你要讓 Agent 執行工具，建議選用最強大的最新一代模型來避免 Prompt Injection。在非互動模式下，你可以使用 --secret-input-mode ref 透過環境變數來管理金鑰。
2. Workspace：設定 Agent 檔案的存放位置（預設在 ~/.openclaw/workspace）。
3. Gateway：配置連接埠、綁定地址以及驗證模式。
4. Channels：設定你要串接的通訊軟體，支援 WhatsApp, Telegram, Discord, Google Chat, Mattermost, Signal, BlueBubbles 或 iMessage。
5. Daemon：在 macOS 安裝 LaunchAgent 或在 Linux/WSL2 安裝 systemd 服務，讓程式在背景執行。
6. Health check：自動啟動 Gateway 並確認一切運作正常。
7. Skills：安裝建議的技能與相關依賴套件。

如果你只想讓本地端連線到現有的遠端 Gateway，選擇 Remote mode 即可，這不會改動遠端主機的任何設定。

疑難排解

設定檔無效或格式錯誤

如果你的設定檔包含舊版的 Key 或格式不正確，Wizard 會要求你先執行：

openclaw doctor

想要完全重來

重新執行 Wizard 不會刪除你的資料，除非你明確選擇 Reset。如果你想透過 CLI 徹底重設：

# 重設設定、憑證與 Session
openclaw onboard --reset

# 連同 Workspace 一併刪除
openclaw onboard --reset --reset-scope full

Daemon 安裝失敗

如果你使用了 SecretRef 管理 Token，但該環境變數尚未設定或無法解析，Daemon 的安裝程序會被阻斷並提供修復建議。

---

如果你在設定過程中遇到任何問題，可以直接詢問 AI Setup Assistant 獲取即時協助。

下一步

• CLI 指令完整參考：openclaw onboard
• 了解設定細節：CLI Onboarding Reference
• 桌面端安裝指南：macOS app onboarding
• 第一次啟動 Agent：Agent Bootstrapping