OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Guides

命令列介面自動化

使用 openclaw onboard --non-interactive 以指令碼方式進行設定。此命令需要 --accept-risk：非互動式設定可在不顯示確認提示的情況下寫入認證資料與常駐程式設定，因此此旗標表示明確確認已知風險。

非互動式基準範例

bash
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 模式中，供應商的環境變數必須已設定於程序環境中：若傳入內嵌金鑰旗標但未設定對應的環境變數，命令會立即失敗。
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice openai-api-key \  --secret-input-mode ref

供應商專用範例

Anthropic API 金鑰範例
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice apiKey \  --anthropic-api-key "$ANTHROPIC_API_KEY" \  --gateway-bind loopback
Cloudflare AI Gateway 範例
bash
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 範例
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice gemini-api-key \  --gemini-api-key "$GEMINI_API_KEY" \  --gateway-bind loopback
Mistral 範例
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice mistral-api-key \  --mistral-api-key "$MISTRAL_API_KEY" \  --gateway-bind loopback
Moonshot 範例
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice moonshot-api-key \  --moonshot-api-key "$MOONSHOT_API_KEY" \  --gateway-bind loopback
Ollama 範例
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice ollama \  --custom-model-id "qwen3.5:27b" \  --gateway-bind loopback
OpenCode 範例
bash
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 範例
bash
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 範例
bash
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 範例
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice zai-api-key \  --zai-api-key "$ZAI_API_KEY" \  --gateway-bind loopback
自訂供應商範例
bash
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" }：

bash
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。

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

此命令會寫入的設定鍵（新代理程式 ID 的 agents.list[] 項目）：

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

注意事項：

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

相關文件

Was this useful?
On this page

On this page