命令列介面自動化

使用 openclaw onboard --non-interactive 編寫設定指令碼。它需要 --accept-risk：非互動式設定可以在沒有確認提示的情況下寫入認證資訊和常駐程式設定，因此此旗標代表明確確認接受風險。

--json 不代表非互動模式。指令碼必須明確傳入 --non-interactive --accept-risk。

​

基準非互動式範例

openclaw onboard --non-interactive --accept-risk \
  --mode local \
  --auth-choice apiKey \
  --anthropic-api-key "$ANTHROPIC_API_KEY" \
  --secret-input-mode plaintext \
  --gateway-bind loopback \
  --install-daemon \
  --daemon-runtime node \
  --skip-bootstrap \
  --skip-skills

加入 --json 以取得機器可讀的摘要。

• --gateway-port 預設為 18789；只有在需要覆寫時才傳入。
• --skip-bootstrap 會略過建立預設工作區檔案，適用於預先植入自有工作區的自動化流程。
• --secret-input-mode ref 會在驗證設定檔中儲存以環境變數為後端的參照（{ source: "env", provider: "default", id: "<ENV_VAR>" }），而非明文金鑰。在非互動式 ref 模式下，供應商環境變數必須已設定於處理程序環境中：若傳入內嵌金鑰旗標，卻未設定對應的環境變數，系統會立即失敗。

openclaw onboard --non-interactive --accept-risk \
  --mode local \
  --auth-choice openai-api-key \
  --secret-input-mode ref

​

各供應商專用範例

Anthropic API 金鑰範例

openclaw onboard --non-interactive --accept-risk \
  --mode local \
  --auth-choice apiKey \
  --anthropic-api-key "$ANTHROPIC_API_KEY" \
  --gateway-bind loopback

Cloudflare AI Gateway 範例

openclaw onboard --non-interactive --accept-risk \
  --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-bind loopback

Gemini 範例

openclaw onboard --non-interactive --accept-risk \
  --mode local \
  --auth-choice gemini-api-key \
  --gemini-api-key "$GEMINI_API_KEY" \
  --gateway-bind loopback

Mistral 範例

openclaw onboard --non-interactive --accept-risk \
  --mode local \
  --auth-choice mistral-api-key \
  --mistral-api-key "$MISTRAL_API_KEY" \
  --gateway-bind loopback

Moonshot 範例

openclaw onboard --non-interactive --accept-risk \
  --mode local \
  --auth-choice moonshot-api-key \
  --moonshot-api-key "$MOONSHOT_API_KEY" \
  --gateway-bind loopback

Ollama 範例

openclaw onboard --non-interactive --accept-risk \
  --mode local \
  --auth-choice ollama \
  --custom-model-id "qwen3.5:27b" \
  --gateway-bind loopback

OpenCode 範例

openclaw onboard --non-interactive --accept-risk \
  --mode local \
  --auth-choice opencode-zen \
  --opencode-zen-api-key "$OPENCODE_API_KEY" \
  --gateway-bind loopback

若要使用 Go 目錄，請改用 --auth-choice opencode-go --opencode-go-api-key "$OPENCODE_API_KEY"。

Synthetic 範例

openclaw onboard --non-interactive --accept-risk \
  --mode local \
  --auth-choice synthetic-api-key \
  --synthetic-api-key "$SYNTHETIC_API_KEY" \
  --gateway-bind loopback

Vercel AI Gateway 範例

openclaw onboard --non-interactive --accept-risk \
  --mode local \
  --auth-choice ai-gateway-api-key \
  --ai-gateway-api-key "$AI_GATEWAY_API_KEY" \
  --gateway-bind loopback

Z.AI 範例

openclaw onboard --non-interactive --accept-risk \
  --mode local \
  --auth-choice zai-api-key \
  --zai-api-key "$ZAI_API_KEY" \
  --gateway-bind loopback

自訂供應商範例

openclaw onboard --non-interactive --accept-risk \
  --mode local \
  --auth-choice custom-api-key \
  --custom-base-url "https://llm.example.com/v1" \
  --custom-model-id "foo-large" \
  --custom-api-key "$CUSTOM_API_KEY" \
  --custom-provider-id "my-custom" \
  --custom-compatibility anthropic \
  --custom-image-input \
  --gateway-bind loopback

--custom-api-key 為選填；部分端點不需要驗證。若省略，初始設定會檢查環境中的 CUSTOM_API_KEY。--custom-provider-id 為選填，省略時會依據基底 URL 自動衍生。--custom-compatibility 預設為 openai（其他值：openai-responses、anthropic）。

OpenClaw 會根據已知的視覺模型 ID 模式（gpt-4o、claude-3/4、gemini、-vl/vision 後綴及類似模式）推斷是否支援影像輸入。若要為無法辨識的視覺模型強制啟用，請加入 --custom-image-input；若要強制僅使用文字，則加入 --custom-text-input。

參照模式變體，將 apiKey 儲存為 { source: "env", provider: "default", id: "CUSTOM_API_KEY" }：

export CUSTOM_API_KEY="your-key"
openclaw onboard --non-interactive --accept-risk \
  --mode local \
  --auth-choice custom-api-key \
  --custom-base-url "https://llm.example.com/v1" \
  --custom-model-id "foo-large" \
  --secret-input-mode ref \
  --custom-provider-id "my-custom" \
  --custom-compatibility anthropic \
  --custom-image-input \
  --gateway-bind loopback

系統仍支援 Anthropic 設定權杖驗證，但若本機已有 Claude CLI 登入，OpenClaw 會優先重複使用 Claude CLI。正式環境建議使用 Anthropic API 金鑰。

​

新增另一個代理程式

openclaw agents add <name> 會建立獨立的代理程式，並擁有自己的工作區、工作階段與驗證設定檔。不使用 --workspace（且沒有其他旗標）執行時，會啟動互動式精靈；傳入 --workspace、--model、--agent-dir、--bind 或 --non-interactive 中任一項時，會以非互動方式執行，且必須再傳入 --workspace。

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

它會寫入的設定鍵（新代理程式 ID 的 agents.entries.* 項目）：

• name
• workspace
• agentDir
• model（僅在傳入 --model 時）

注意事項：

• 預設工作區（在互動式精靈中省略 --workspace 時）：~/.openclaw/workspace-<agentId>。
• --bind <channel[:accountId]> 可重複使用；加入繫結可將傳入訊息路由至新的代理程式（精靈也能以互動方式執行此操作）。
• 代理程式名稱會正規化為有效的代理程式 ID；main 為保留值。

​

相關文件

• 初始設定中心：初始設定（命令列介面）
• 完整參考：命令列介面設定參考
• 命令參考：openclaw onboard