Skip to main content
OpenClaw 提供終端與 macOS App 的新手設定流程。兩者都會先建立推論能力： 它們會偵測現有的 AI 存取權、要求完成一次即時回覆，之後才啟動 OpenClaw 以設定其餘項目。如果可連線且已設定的閘道，其預設代理程式 已有設定好的模型，便會略過新手設定並開啟一般代理程式 UI。終端流程也提供完整的傳統精靈， 以進行詳細設定。

​
我該使用哪種方式？

大多數使用者應從 命令列介面新手設定 開始——它可在任何平台使用，並讓 你擁有最大的控制權。

​
新手設定會設定哪些項目

引導式推論階段只會建立：
  1. 模型供應商與驗證——偵測到的存取權，或已驗證的供應商登入、 API 金鑰或權杖
  2. 已驗證的推論——使用預設代理程式實際生效的 模型完成一次真實回覆
該回覆通過後，OpenClaw 即可設定工作區、閘道、 閘道服務、頻道、代理程式、外掛及其他選用功能。 傳統命令列介面精靈還能設定：
  1. 頻道（選用）——內建及隨附的聊天頻道，例如 Discord、Feishu、Google Chat、iMessage、Mattermost、Microsoft Teams、 Telegram、WhatsApp 等
  2. 進階閘道控制項——遠端模式、網路設定及常駐程式選項

​
命令列介面新手設定

在任何終端中執行：
引導式流程會偵測現有的 AI 存取權、依序即時測試候選項目， 並在失敗時繼續嘗試下一個。若偵測完所有項目仍無結果，會先顯示 OpenAI、 Anthropic、xAI（Grok）、Google 和 OpenRouter。More… 會依供應商群組列出 其餘供應商，第二層選單中包含地區、方案，以及支援的 瀏覽器、裝置、API 金鑰或權杖方式。只有在回覆測試通過後，才會儲存模型 與認證資訊，接著啟動 OpenClaw 以 設定工作區、閘道、頻道、代理程式、外掛及其他選用 功能。Skip for now 會直接結束而不啟動 OpenClaw。流程中不會 轉交至傳統精靈；若要改用傳統精靈，請結束並執行 openclaw onboard --classic。 推論通過後，OpenClaw 可將頻道設定交給使用遮罩輸入的終端 精靈。它不會開啟引導式或傳統供應商設定；若要變更模型供應商或其驗證方式，請結束 OpenClaw 並 執行 openclaw onboard。 使用 openclaw onboard --classic 進行詳細的模型／驗證、頻道、技能、 遠端閘道或匯入設定。加上 --install-daemon 也會選取 傳統流程，並在同一個步驟中安裝背景服務。使用 openclaw openclaw 進行對話式的非推論設定與修復。openclaw onboard --modern 是使用相同即時推論 閘門的相容性別名。 完整參考：新手設定（命令列介面） 命令列介面命令文件：openclaw onboard

​
macOS App 新手設定

開啟 OpenClaw App。如果其已設定的本機或遠端閘道可以連線， 且預設代理程式已有設定好的模型，App 會略過新手設定 與 OpenClaw 設定，並立即開啟一般代理程式 UI。 對於全新或設定不完整的閘道，首次執行流程會偵測現有的 AI 存取權（Claude Code、Codex 或 API 金鑰）、即時測試最佳 選項，並僅在收到真實回覆後儲存——若失敗則自動改用其他選項， 若找不到任何項目，則提供經驗證的手動 API 金鑰步驟。敏感的 認證資訊會使用遮罩輸入。推論通過後，OpenClaw 會啟動並 協助設定其餘項目。 設定完成後，一般代理程式仍可使用 Gemini CLI，但推論 閘門不會提供此選項，因為它無法強制執行不使用工具的探測。 完整參考：新手設定（macOS App）

​
自訂或未列出的供應商

如果你的供應商未列出，請執行 openclaw onboard --classic，選擇 Custom Provider，並輸入：
  • 端點相容性：OpenAI 相容（/chat/completions）、OpenAI Responses 相容（/responses）、Anthropic 相容（/messages），或未知（探測全部三種並自動偵測）
  • 基礎 URL 與 API 金鑰（若端點不需要 API 金鑰，則可省略）
  • 模型 ID 與選用的模型別名
多個自訂端點可以並存——每個端點都會取得自己的端點 ID。

​
相關內容