跳到內容

CLI 自動化指南:快速配置 openclaw

每次在伺服器上部署或是寫自動化腳本時,最煩的就是遇到那種一定要你手動選選項的互動式介面。這對單次安裝沒問題,但如果你要在大規模環境跑,這會讓你沒辦法直接把流程寫進腳本裡。

幸好 openclaw 提供了非互動模式,讓你用一行指令就能搞定所有配置,完全不需要手動干預。

  • 已安裝 openclaw CLI
  • 你打算使用的 Provider API key(例如 Anthropic 或 Gemini)

要讓 openclaw onboard 自動執行,關鍵在於使用 --non-interactive 參數。

這裡是一個最基本的例子,使用 Anthropic API 並安裝 daemon:

Terminal window
openclaw onboard --non-interactive \
--mode local \
--auth-choice apiKey \
--anthropic-api-key "$ANTHROPIC_API_KEY" \
--gateway-port 18789 \
--gateway-bind loopback \
--install-daemon \
--daemon-runtime node \
--skip-skills

如果你需要機器可讀的摘要,可以加上 --json 參數。

針對不同的模型供應商,參數會稍微不同。你可以參考以下幾種常見的配置:

Terminal window
openclaw onboard --non-interactive \
--mode local \
--auth-choice gemini-api-key \
--gemini-api-key "$GEMINI_API_KEY" \
--gateway-port 18789 \
--gateway-bind loopback
Terminal window
openclaw onboard --non-interactive \
--mode local \
--auth-choice ai-gateway-api-key \
--ai-gateway-api-key "$AI_GATEWAY_API_KEY" \
--gateway-port 18789 \
--gateway-bind loopback
Terminal window
openclaw onboard --non-interactive \
--mode local \
--auth-choice cloudflare-ai-gateway-api-key \
--cloudflare-ai-gateway-account-id "your-account-id" \
--cloudflare-ai-gateway-gateway-id "your-gateway-id" \
--cloudflare-ai-gateway-api-key "$CLOUDFLARE_AI_GATEWAY_API_KEY" \
--gateway-port 18789 \
--gateway-bind loopback
Terminal window
openclaw onboard --non-interactive \
--mode local \
--auth-choice moonshot-api-key \
--moonshot-api-key "$MOONSHOT_API_KEY" \
--gateway-port 18789 \
--gateway-bind loopback

如果你想建立一個獨立的 Agent,並擁有自己的 workspace 和 auth 設定,可以使用 openclaw agents add <name>。如果在執行時沒有帶上 --workspace,系統會啟動設定嚮導,所以自動化時記得帶上參數。

Terminal window
openclaw agents add work \
--workspace ~/.openclaw/workspace-work \
--model openai/gpt-5.2 \
--bind whatsapp:biz \
--non-interactive \
--json

這個指令會自動設定以下內容:

  • agents.list[].name:Agent 的名稱
  • agents.list[].workspace:工作區路徑
  • agents.list[].agentDir:Agent 目錄
  • bindings:路由傳入訊息的設定

預設的工作區通常會放在 ~/.openclaw/workspace-<agentId>。

我加了 —json 但還是跳出互動提示?

Section titled “我加了 —json 但還是跳出互動提示?”

請注意,--json 參數只是讓輸出格式變成機器可讀,它並不代表「非互動模式」。如果你在寫腳本,請務必同時加上 --non-interactive(建議也一併加上 --workspace)來確保流程不會中斷。


如果你在自動化配置過程中遇到任何問題,可以直接詢問我們的 AI Setup Assistant。

OpenClaw

OpenClaw Expert

還是卡住了?

如果這篇文件沒有解決你的情境,直接問 OpenClaw Expert,拿到可執行步驟。