Skip to main content

Documentation Index

Fetch the complete documentation index at: https://openclaw.zhcndoc.com/llms.txt

Use this file to discover all available pages before exploring further.

使用 --non-interactive 来自动化 openclaw onboard。
--json 并不表示非交互模式。请在脚本中使用 --non-interactive（以及 --workspace）。

​
基线非交互式示例

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice apiKey \
  --anthropic-api-key "$ANTHROPIC_API_KEY" \
  --secret-input-mode plaintext \
  --gateway-port 18789 \
  --gateway-bind loopback \
  --install-daemon \
  --daemon-runtime node \
  --skip-bootstrap \
  --skip-skills
如需机器可读的摘要，请添加 --json。 当你的自动化流程预先填充了 workspace 文件，并且不希望 onboarding 创建默认的 bootstrap 文件时，请使用 --skip-bootstrap。 使用 --secret-input-mode ref 可将基于环境变量的引用以 auth profiles 中的引用形式存储，而不是明文值。 在 onboarding 流程中，可以在环境变量引用与已配置的提供商引用（file 或 exec）之间进行交互式选择。 在非交互式 ref 模式下，提供商环境变量必须设置在进程环境中。 如果传入了内联密钥标志但没有匹配的环境变量，现在会快速失败。 示例： 
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice openai-api-key \
  --secret-input-mode ref \
  --accept-risk

​
按提供商划分的示例

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

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

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

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

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

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

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

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

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice opencode-zen \
  --opencode-zen-api-key "$OPENCODE_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback
对于 Go 目录，请切换为 --auth-choice opencode-go --opencode-go-api-key "$OPENCODE_API_KEY"。
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice ollama \
  --custom-model-id "qwen3.5:27b" \
  --accept-risk \
  --gateway-port 18789 \
  --gateway-bind loopback

openclaw onboard --non-interactive \
  --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-port 18789 \
  --gateway-bind loopback
--custom-api-key 是可选的。如果省略，onboarding 会检查 CUSTOM_API_KEY。 OpenClaw 会自动将常见的视觉模型 ID 标记为支持图像。对于未知的自定义视觉 ID，请添加 --custom-image-input；或者添加 --custom-text-input 以强制仅文本元数据。ref 模式变体：
export CUSTOM_API_KEY="your-key"
openclaw onboard --non-interactive \
  --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-port 18789 \
  --gateway-bind loopback
在此模式下，onboarding 会将 apiKey 存储为 { source: "env", provider: "default", id: "CUSTOM_API_KEY" }。
Anthropic setup-token 仍然可作为受支持的 onboarding token 路径使用，但在可用时，OpenClaw 现在优先复用 Claude CLI。 在生产环境中，请优先使用 Anthropic API key。

​
添加另一个 agent

使用 openclaw agents add <name> 来创建一个独立的 agent，它拥有自己的 workspace、 sessions 和 auth profiles。不带 --workspace 运行会启动向导。 
openclaw agents add work \
  --workspace ~/.openclaw/workspace-work \
  --model openai/gpt-5.5 \
  --bind whatsapp:biz \
  --non-interactive \
  --json
它会设置：
  • agents.list[].name
  • agents.list[].workspace
  • agents.list[].agentDir
注意：
  • 默认 workspaces 遵循 ~/.openclaw/workspace-<agentId>。
  • 添加 bindings 以路由传入消息（向导可以完成此操作）。
  • 非交互式标志：--model、--agent-dir、--bind、--non-interactive。

​
相关文档