Ana içeriğe atla

CLI Otomasyonu

openclaw onboard işlemini otomatikleştirmek için --non-interactive kullanın.
--json, etkileşimsiz modu ima etmez. Betikler için --non-interactive (ve --workspace) kullanın.

Temel etkileşimsiz örnek

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
Makine tarafından okunabilir bir özet için --json ekleyin. Düz metin değerler yerine auth profillerinde env destekli ref’leri saklamak için --secret-input-mode ref kullanın. Env ref’leri ile yapılandırılmış sağlayıcı ref’leri (file veya exec) arasında etkileşimli seçim onboarding akışında kullanılabilir. Etkileşimsiz ref modunda, sağlayıcı env değişkenleri süreç ortamında ayarlanmış olmalıdır. Eşleşen env değişkeni olmadan satır içi anahtar bayraklarını geçirmek artık hızlıca başarısız olur. Örnek:
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice openai-api-key \
  --secret-input-mode ref \
  --accept-risk

Sağlayıcıya özgü örnekler

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 kataloğu için --auth-choice opencode-go --opencode-go-api-key "$OPENCODE_API_KEY" kullanarak değiştirin.
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 \
  --gateway-port 18789 \
  --gateway-bind loopback
--custom-api-key isteğe bağlıdır. Atlanırsa onboarding CUSTOM_API_KEY değişkenini kontrol eder.Ref modu varyantı:
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
Bu modda onboarding, apiKey değerini { source: "env", provider: "default", id: "CUSTOM_API_KEY" } olarak saklar.
Anthropic setup-token, desteklenen bir onboarding token yolu olarak kullanılmaya devam eder, ancak OpenClaw artık mevcut olduğunda Claude CLI yeniden kullanımını tercih eder. Üretim için bir Anthropic API anahtarı tercih edin.

Başka bir agent ekle

Kendi workspace’i, oturumları ve auth profilleri olan ayrı bir agent oluşturmak için openclaw agents add <name> kullanın. --workspace olmadan çalıştırmak sihirbazı başlatır.
openclaw agents add work \
  --workspace ~/.openclaw/workspace-work \
  --model openai/gpt-5.4 \
  --bind whatsapp:biz \
  --non-interactive \
  --json
Ayarladıkları:
  • agents.list[].name
  • agents.list[].workspace
  • agents.list[].agentDir
Notlar:
  • Varsayılan workspace’ler ~/.openclaw/workspace-<agentId> biçimini izler.
  • Gelen mesajları yönlendirmek için bindings ekleyin (sihirbaz bunu yapabilir).
  • Etkileşimsiz bayraklar: --model, --agent-dir, --bind, --non-interactive.

İlgili belgeler