CLI otomasyonu

Komut dosyasıyla kurulum yapmak için openclaw onboard --non-interactive kullanın. Bunun için --accept-risk gerekir: etkileşimsiz kurulum, onay istemi olmadan kimlik bilgilerini ve daemon yapılandırmasını yazabilir; bu nedenle bayrak, riskin açıkça kabul edildiğini belirtir.

--json etkileşimsiz mod anlamına gelmez. Komut dosyaları için --non-interactive --accept-risk seçeneğini açıkça iletin.

Temel etkileşimsiz örnek

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

Makine tarafından okunabilir bir özet için --json ekleyin.

--gateway-port varsayılan olarak 18789 değerini kullanır; yalnızca geçersiz kılmak için iletin.
--skip-bootstrap, kendi çalışma alanını önceden hazırlayan otomasyonlar için varsayılan çalışma alanı dosyalarının oluşturulmasını atlar.
--secret-input-mode ref, düz metin anahtar yerine kimlik doğrulama profilinde ortam değişkeni destekli bir referans ({ source: "env", provider: "default", id: "<ENV_VAR>" }) depolar. Etkileşimsiz ref modunda sağlayıcının ortam değişkeni, işlem ortamında önceden ayarlanmış olmalıdır: eşleşen ortam değişkeni olmadan satır içi anahtar bayrağı iletmek işlemin hemen başarısız olmasına neden olur.

openclaw onboard --non-interactive --accept-risk \
  --mode local \
  --auth-choice openai-api-key \
  --secret-input-mode ref

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

Anthropic API anahtarı örneği

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

Cloudflare AI Gateway örneği

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 örneği

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

Mistral örneği

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

Moonshot örneği

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

Ollama örneği

openclaw onboard --non-interactive --accept-risk \
  --mode local \
  --auth-choice ollama \
  --custom-model-id "qwen3.5:27b" \
  --gateway-bind loopback

OpenCode örneği

openclaw onboard --non-interactive --accept-risk \
  --mode local \
  --auth-choice opencode-zen \
  --opencode-zen-api-key "$OPENCODE_API_KEY" \
  --gateway-bind loopback

Go kataloğu için --auth-choice opencode-go --opencode-go-api-key "$OPENCODE_API_KEY" seçeneğine geçin.

Synthetic örneği

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 örneği

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 örneği

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

Özel sağlayıcı örneği

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 isteğe bağlıdır; bazı uç noktalar kimlik doğrulaması gerektirmez. Belirtilmezse ilk katılım işlemi ortamda CUSTOM_API_KEY değerini kontrol eder. --custom-provider-id isteğe bağlıdır ve belirtilmediğinde temel URL’den otomatik olarak türetilir. --custom-compatibility varsayılan olarak openai değerini kullanır (diğer değerler: openai-responses, anthropic).OpenClaw, bilinen görüntü modeli kimliği kalıplarından (gpt-4o, claude-3/4, gemini, -vl/vision son ekleri ve benzerleri) görüntü girdisi desteğini çıkarır. Tanınmayan bir görüntü modeli için bunu zorla etkinleştirmek üzere --custom-image-input, yalnızca metni zorunlu kılmak üzere --custom-text-input ekleyin.apiKey değerini { source: "env", provider: "default", id: "CUSTOM_API_KEY" } olarak depolayan referans modu varyantı:

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 kurulum belirteciyle kimlik doğrulama desteklenmeye devam eder ancak yerel bir Claude CLI oturumu mevcutsa OpenClaw, Claude CLI’ın yeniden kullanılmasını tercih eder. Üretim ortamında Anthropic API anahtarını tercih edin.

Başka bir aracı ekleme

openclaw agents add <name>, kendi çalışma alanı, oturumları ve kimlik doğrulama profilleri bulunan ayrı bir aracı oluşturur. --workspace olmadan (ve başka bayrak belirtilmeden) çalıştırılması etkileşimli sihirbazı başlatır; --workspace, --model, --agent-dir, --bind veya --non-interactive seçeneklerinden herhangi birinin iletilmesi komutu etkileşimsiz çalıştırır ve ardından --workspace gerektirir.

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

Yazdığı yapılandırma anahtarları (yeni aracı kimliği için agents.entries.* girdisi):

name
workspace
agentDir
model (yalnızca --model iletildiğinde)

Notlar:

Varsayılan çalışma alanı (etkileşimli sihirbazda --workspace belirtilmediğinde): ~/.openclaw/workspace-<agentId>.
--bind <channel[:accountId]> tekrarlanabilir; gelen mesajları yeni aracıya yönlendirmek için bağlamalar ekleyin (sihirbaz bunu etkileşimli olarak da yapabilir).
Aracı adı, geçerli bir aracı kimliğine dönüştürülür; main ayrılmıştır.

İlgili belgeler

İlk katılım merkezi: İlk Katılım (CLI)
Tam başvuru: CLI Kurulum Başvurusu
Komut başvurusu: openclaw onboard

Genel bakis

Ilk adimlar

Guides

Temel etkileşimsiz örnek

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

Başka bir aracı ekleme

İlgili belgeler

​Temel etkileşimsiz örnek

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

​Başka bir aracı ekleme

​İlgili belgeler

Temel etkileşimsiz örnek

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

Başka bir aracı ekleme

İlgili belgeler