OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Guides

CLI otomasyonu

Kurulumu betiklerle yapmak için openclaw onboard --non-interactive kullanın. Bu komut --accept-risk gerektirir: 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.

Temel etkileşimsiz örnek

bash
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 bu değeri 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 başvuru ({ source: "env", provider: "default", id: "<ENV_VAR>" }) saklar. 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.
bash
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
bash
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
bash
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
bash
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
bash
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
bash
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
bash
openclaw onboard --non-interactive --accept-risk \  --mode local \  --auth-choice ollama \  --custom-model-id "qwen3.5:27b" \  --gateway-bind loopback
OpenCode örneği
bash
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çeneklerine geçin.

Synthetic örneği
bash
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
bash
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
bash
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
bash
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ğrulama gerektirmez. Belirtilmezse ilk katılım işlemi, ortamda CUSTOM_API_KEY değerini denetler. --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, görüntü girdisi desteğini bilinen görsel model kimliği kalıplarından (gpt-4o, claude-3/4, gemini, -vl/vision son ekleri ve benzerleri) çıkarır. Tanınmayan bir görsel model için desteği zorunlu olarak etkinleştirmek üzere --custom-image-input, yalnızca metin kullanımını zorunlu kılmak üzere --custom-text-input ekleyin.

apiKey değerini { source: "env", provider: "default", id: "CUSTOM_API_KEY" } olarak saklayan başvuru modu çeşidi:

bash
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 mevcut olduğunda OpenClaw, Claude CLI oturumunun 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ına, oturumlarına ve kimlik doğrulama profillerine sahip ayrı bir aracı oluşturur. Komutu --workspace olmadan (ve başka hiçbir bayrak olmadan) çalıştırmak etkileşimli sihirbazı başlatır; --workspace, --model, --agent-dir, --bind veya --non-interactive seçeneklerinden herhangi birini iletmek komutu etkileşimsiz olarak çalıştırır ve ardından --workspace seçeneğini zorunlu kılar.

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

Komutun yazdığı yapılandırma anahtarları (yeni aracı kimliği için agents.list[] 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]> yinelenebilir; 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

Was this useful?
On this page

On this page