CLI Onboarding 全攻略：輕鬆搞定 OpenClaw 環境設定

每次開始一個新專案，最煩人的總是環境設定。API key 要放哪裡？背景執行怎麼搞？通訊軟體串接又要改什麼設定檔？這些瑣事往往在寫出第一行核心邏輯前，就先耗盡了開發者的熱情。

我們都希望有一個工具能自動處理這些繁雜的步驟，讓你把精力放在真正重要的事情上。openclaw onboard 就是為了這個目的而設計的，它能幫你一次搞定模型、閘道器與自動化流程。

需要準備的東西

在開始之前，請確保你已經準備好以下資訊（視你的需求而定）：

• 模型授權：Anthropic API key、OpenAI API key 或相關的 OAuth 權限。
• 運行環境：建議安裝 Node.js（WhatsApp 與 Telegram 頻道必備）。
• 頻道憑證：如果你要串接通訊軟體，需要準備 Telegram bot token、WhatsApp 帳號或 Discord token 等。
• 權限：在 Linux 上安裝 Daemon 時可能需要 sudo 權限。

快速開始

只需 5 分鐘，就能完成最小路徑的開發環境配置：

1. 啟動引導： 在終端機輸入以下指令開始初始化：

   openclaw onboard

2. 選擇模式：

   • Local mode（預設）：在本地機器設定模型、Workspace、Gateway 與 Daemon。
   • Remote mode：將這台機器設定為連線到遠端的 Gateway，不會修改遠端主機。

3. 設定模型與 Auth： 引導程式會偵測你的環境。如果你有 ANTHROPIC_API_KEY 或 OPENAI_API_KEY，它會自動讀取。推薦使用 Anthropic API key，設定最為直覺。

4. 配置 Gateway 與 Workspace： 設定你的 Workspace 路徑（預設為 ~/.openclaw/workspace）以及 Gateway 的 port。即使是本地使用，我也建議開啟 token auth 以確保安全。

5. 串接頻道 (Channels)： 根據提示貼上你的 API token。例如：

   • Telegram: 貼上你的 bot token。
   • WhatsApp: 掃描 QR code 登入。
   • Discord: 貼上你的 bot token。

6. 安裝 Daemon： 最後，引導程式會詢問是否安裝為系統服務（macOS 使用 LaunchAgent，Linux 使用 systemd），讓 Gateway 在背景持續執行。

疑難排解

如果在設定過程中遇到問題，可以參考以下來自源文件的解決方案：

• 設定檔衝突或無效： 如果你的 ~/.openclaw/openclaw.json 已存在或格式錯誤，引導程式會停止。請先執行：

  openclaw doctor

  或者使用 openclaw onboard --reset 來重新開始。

• OAuth 授權卡住： 在 macOS 上使用 OAuth 時，請在系統彈窗選擇「Always Allow」，以免背景服務啟動時被攔截。

• 無 GUI 環境（伺服器）： 如果引導程式偵測不到 GUI，它會印出 SSH port-forward 指令，讓你在本地瀏覽器開啟 Control UI 完成後續操作。

• 權限問題： 在 Linux 上，引導程式會嘗試執行 loginctl enable-linger 確保登出後服務不中斷。如果失敗，請根據提示使用 sudo 權限重試。

---

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

下一步

• 想要更深入了解設定檔結構？參考 Onboarding Wizard (CLI)
• 需要自動化部署腳本？查看 CLI Automation
• 查詢完整命令參數：openclaw onboard