Skip to content

建立 2026-09-15 更新 2026-09-15

新手引導

新手引導把「模型怎麼連、閘道怎麼開、設定寫到哪」一次做完。安裝腳本通常會自動帶你進來;若當時跳過了,再執行:

openclaw onboard

完整參考:Onboarding (CLI)。介面有正體中文:

OPENCLAW_LOCALE=zh-TW openclaw onboard

產品名稱、指令、設定鍵與模型 ID 仍維持英文。

Quick start 與 Custom setup

全新本機、互動式安裝會先指向安全說明,再讓你選:

選項 行為
Quick start 偵測現有 Claude Code/Codex 登入、環境變數裡的 API 金鑰、本機 Ollama/LM Studio;你選一條路線,它用真正的 completion 驗證後才寫入。預設 agent 名稱 main、完整工具權限、前景閘道並打開儀表板。
Custom setup 走完整引導:agent 名稱、權限模式、遙測、記憶匯入等都會問。
Skip for now 準備 workspace 與本機閘道設定後結束,不啟動閘道、不開聊天。

驗證失敗時不會偷偷改選別家供應商;你要自己重試、換一家,或略過。之後若要改模型或驗證方式,再跑一次 openclaw onboard。頻道、搜尋、skills 等非推論設定用 openclaw configure

工具權限不是玩具

有工具的 agent 能讀檔、跑指令。Quick start 預設 full access,適合你自己的機器。若這台電腦會給別人碰、或之後要把閘道接到公網,請先讀 安全

裝成背景服務

Quick start 的閘道佔著目前終端機。Ctrl+C 停下後:

openclaw gateway install

這會在 macOS 裝 LaunchAgent、在 Linux/WSL2 裝 systemd 使用者單元、在 Windows 裝工作排程(失敗則退回啟動資料夾捷徑)。設定檔不會因為前景閘道被關掉而消失。

安裝腳本若你當時選了 --install-daemon,這一步可能已經做過。用 openclaw gateway status 確認。

Classic wizard

需要逐步勾選 workspace、頻道、daemon、skills,或要連遠端閘道時:

openclaw onboard --classic

本機模式大致會問:workspace 目錄(預設 ~/.openclaw/workspace)、模型/驗證、閘道埠與綁定、頻道、網頁搜尋、skills、背景服務、健康檢查。遠端模式(--mode remote)只把這台機器設成連到別處的閘道,不會去改遠端主機。

不要加 --reset,除非你真的要清掉設定;預設重置範圍是設定、憑證與會話,--reset-scope full 連 workspace 也丟進垃圾桶。

小團隊

引導建立第一個 agent 時可選「一個 agent」或「小團隊」(幕僚長 + 研究員/寫手/審稿)。團隊成員各有 workspace 與角色說明。既有安裝請改用 openclaw agents team create,不要再對已有 roster 跑 --team

驗證沒過怎麼辦

openclaw doctor
openclaw triage

doctor 讀設定、指出問題;triage 做唯讀健康檢查,可選擇把消毒過的診斷交給本機的 coding agent。秘密、token、原始聊天與 log 不會被放進那份 prompt。

畫面跟做 Quick start(接 Anthropic、先開 Control UI 再補頻道),可看 Adrian Twarog Crash Course

下一步:打開 Control UI 打第一句話。