openclaw 网盘下载
OpenClaw
Ctrl K

文档

首页 > 文档 > CLI 自动化

CLI 自动化

使用 --non-interactive 自动化 openclaw onboard。

--json 并不意味着非交互模式。对于脚本，请使用 --non-interactive（以及 --workspace）。

基础非交互式示例

“`bash theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}}
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-skills


添加 `--json` 可获得机器可读的摘要。

使用 `--secret-input-mode ref` 可在认证配置文件中存储基于环境变量的引用，而不是明文值。
在设置向导流程中，支持在环境变量引用与已配置的提供商引用（`file` 或 `exec`）之间进行交互式选择。

在非交互式 `ref` 模式下，必须在进程环境中设置提供商环境变量。
如果传入了内联密钥标志，但缺少匹配的环境变量，现在会快速失败。

示例：

```bash  theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --non-interactive 
  --mode local 
  --auth-choice openai-api-key 
  --secret-input-mode ref 
  --accept-risk

提供商专用示例

bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --non-interactive
--mode local
--auth-choice gemini-api-key
--gemini-api-key "$GEMINI_API_KEY"
--gateway-port 18789
--gateway-bind loopback

bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --non-interactive
--mode local
--auth-choice zai-api-key
--zai-api-key "$ZAI_API_KEY"
--gateway-port 18789
--gateway-bind loopback

bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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

bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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

bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --non-interactive
--mode local
--auth-choice moonshot-api-key
--moonshot-api-key "$MOONSHOT_API_KEY"
--gateway-port 18789
--gateway-bind loopback

bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --non-interactive
--mode local
--auth-choice mistral-api-key
--mistral-api-key "$MISTRAL_API_KEY"
--gateway-port 18789
--gateway-bind loopback

bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --non-interactive
--mode local
--auth-choice synthetic-api-key
--synthetic-api-key "$SYNTHETIC_API_KEY"
--gateway-port 18789
--gateway-bind loopback

bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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"`。

bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --non-interactive
--mode local
--auth-choice ollama
--custom-model-id "qwen3.5:27b"
--accept-risk
--gateway-port 18789
--gateway-bind loopback

bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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
--gateway-port 18789
--gateway-bind loopback

`--custom-api-key` 是可选的。如果省略，新手引导会检查 `CUSTOM_API_KEY`。

`ref` 模式变体：

```bash  theme={"theme":{"light":"min-light","dark":"min-dark"}}
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 
  --gateway-port 18789 
  --gateway-bind loopback
```

在此模式下，新手引导会将 `apiKey` 存储为 `{ source: "env", provider: "default", id: "CUSTOM_API_KEY" }`。

添加另一个智能体

使用 openclaw agents add <name> 创建一个单独的智能体，它拥有自己的工作区、
会话和认证配置文件。不带 --workspace 运行会启动向导。

bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw agents add work
--workspace ~/.openclaw/workspace-work
--model openai/gpt-5.2
--bind whatsapp:biz
--non-interactive
--json

它会设置：

  • agents.list[].name
  • agents.list[].workspace
  • agents.list[].agentDir

说明：

  • 默认工作区遵循 ~/.openclaw/workspace-<agentId>。
  • 添加 bindings 以路由入站消息（向导可以完成这项操作）。
  • 非交互式标志：--model、--agent-dir、--bind、--non-interactive。

相关文档