Ana içeriğe atla

CLI Otomasyonu

openclaw onboard otomasyonunu yapmak 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. Auth profillerinde düz metin değerler yerine ortam destekli ref’leri depolamak için --secret-input-mode ref kullanın. Ortam 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ı ortam değişkenleri süreç ortamında ayarlanmış olmalıdır. Eşleşen ortam değişkeni olmadan satır içi anahtar bayraklarını geçirmek artık hızlıca hata verir. Ö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 anthropic-cli \
  --gateway-port 18789 \
  --gateway-bind loopback
Claude CLI aracının aynı gateway host üzerinde zaten kurulmuş ve oturum açılmış olmasını gerektirir.
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" ile 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. Belirtilmezse onboarding CUSTOM_API_KEY değerini 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 depolar.
Anthropic setup-token yeniden eski/el ile onboarding yolu olarak kullanılabilir. Bunu, Anthropic’in OpenClaw kullanıcılarına OpenClaw Claude-login yolunun Extra Usage gerektirdiğini söylediği beklentisiyle kullanın. Üretim için Anthropic API anahtarını tercih edin.

Başka bir ajan ekleyin

Kendi çalışma alanı, oturumları ve auth profilleri olan ayrı bir ajan 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 çalışma alanları ~/.openclaw/workspace-<agentId> düzenini izler.
  • Gelen mesajları yönlendirmek için bindings ekleyin (sihirbaz bunu yapabilir).
  • Etkileşimsiz bayraklar: --model, --agent-dir, --bind, --non-interactive.

İlgili belgeler