Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

openclaw agent

• --to <dest>
• --session-id <id>
• --agent <id>

• Ajan gönderme aracı: Ajan gönderme

​

Seçenekler

• -m, --message <text>: gerekli ileti gövdesi
• -t, --to <dest>: oturum anahtarını türetmek için kullanılan alıcı
• --session-id <id>: açık oturum kimliği
• --agent <id>: ajan kimliği; yönlendirme bağlamalarını geçersiz kılar
• --model <id>: bu çalıştırma için model geçersiz kılması (provider/model veya model kimliği)
• --thinking <level>: ajan düşünme seviyesi (off, minimal, low, medium, high; ayrıca sağlayıcının desteklediği xhigh, adaptive veya max gibi özel seviyeler)
• --verbose <on|off>: oturum için ayrıntılı seviyesi kalıcı hale getir
• --channel <channel>: teslimat kanalı; ana oturum kanalını kullanmak için atlayın
• --reply-to <target>: teslimat hedefi geçersiz kılması
• --reply-channel <channel>: teslimat kanalı geçersiz kılması
• --reply-account <id>: teslimat hesabı geçersiz kılması
• --local: gömülü ajanı doğrudan çalıştır (Plugin kayıt defteri ön yüklemesinden sonra)
• --deliver: yanıtı seçilen kanala/hedefe geri gönder
• --timeout <seconds>: ajan zaman aşımını geçersiz kıl (varsayılan 600 veya yapılandırma değeri)
• --json: JSON çıktısı ver

​

Örnekler

openclaw agent --to +15555550123 --message "status update" --deliver
openclaw agent --agent ops --message "Summarize logs"
openclaw agent --agent ops --model openai/gpt-5.4 --message "Summarize logs"
openclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium
openclaw agent --to +15555550123 --message "Trace logs" --verbose on --json
openclaw agent --agent ops --message "Generate report" --deliver --reply-channel slack --reply-to "#reports"
openclaw agent --agent ops --message "Run locally" --local

​

Notlar

• Gateway modu, Gateway isteği başarısız olduğunda gömülü ajana geri döner. Baştan gömülü yürütmeyi zorlamak için --local kullanın.
• --local yine de önce Plugin kayıt defterini önceden yükler; böylece Plugin tarafından sağlanan sağlayıcılar, araçlar ve kanallar gömülü çalıştırmalar sırasında kullanılabilir kalır.
• --local ve gömülü geri dönüş çalıştırmaları tek seferlik çalıştırmalar olarak değerlendirilir. Yerel süreç için açılan paketli MCP loopback kaynakları ve sıcak Claude stdio oturumları yanıttan sonra kaldırılır; böylece betikli çağrılar yerel alt süreçleri canlı tutmaz.
• Gateway destekli çalıştırmalar, Gateway’in sahip olduğu MCP loopback kaynaklarını çalışan Gateway süreci altında bırakır; eski istemciler hâlâ geçmiş temizleme bayrağını gönderebilir, ancak Gateway bunu uyumluluk için işlem yapmayan bir seçenek olarak kabul eder.
• --channel, --reply-channel ve --reply-account oturum yönlendirmesini değil, yanıt teslimatını etkiler.
• --json, stdout’u JSON yanıtı için ayrılmış tutar. Gateway, Plugin ve gömülü geri dönüş tanı çıktıları stderr’e yönlendirilir; böylece betikler stdout’u doğrudan ayrıştırabilir.
• Gömülü geri dönüş JSON’u meta.transport: "embedded" ve meta.fallbackFrom: "gateway" içerir; böylece betikler geri dönüş çalıştırmalarını Gateway çalıştırmalarından ayırt edebilir.
• Gateway bir ajan çalıştırmasını kabul eder ancak CLI son yanıtı beklerken zaman aşımına uğrarsa, gömülü geri dönüş yeni ve açık bir gateway-fallback-* oturum/çalıştırma kimliği kullanır ve meta.fallbackReason: "gateway_timeout" ile geri dönüş oturumu alanlarını bildirir. Bu, Gateway’in sahip olduğu transcript kilidiyle yarışmayı veya özgün yönlendirilmiş konuşma oturumunu sessizce değiştirmeyi önler.
• Bu komut models.json yeniden oluşturmayı tetiklediğinde, SecretRef tarafından yönetilen sağlayıcı kimlik bilgileri çözümlenmiş gizli düz metin olarak değil, gizli olmayan işaretçiler olarak kalıcı hale getirilir (örneğin env var adları, secretref-env:ENV_VAR_NAME veya secretref-managed).
• İşaretçi yazımları kaynak açısından belirleyicidir: OpenClaw işaretçileri çözümlenmiş çalışma zamanı gizli değerlerinden değil, etkin kaynak yapılandırma anlık görüntüsünden kalıcı hale getirir.

​

JSON teslimat durumu

{
  "payloads": [{ "text": "Report ready", "mediaUrl": null }],
  "meta": { "durationMs": 1200 },
  "deliveryStatus": {
    "requested": true,
    "attempted": true,
    "status": "sent",
    "succeeded": true,
    "resultCount": 1
  }
}

• requested: nesne mevcut olduğunda her zaman true.
• attempted: dayanıklı gönderim yolu çalıştıktan sonra true; ön kontrol hataları veya görünür payload olmaması durumunda false.
• succeeded: true, false veya "partial"; "partial", status: "partial_failed" ile eşleşir.
• reason: dayanıklı teslimattan veya ön kontrol doğrulamasından gelen küçük harfli snake-case neden. Bilinen nedenler arasında cancelled_by_message_sending_hook, no_visible_payload, no_visible_result, channel_resolved_to_internal, unknown_channel, invalid_delivery_target ve no_delivery_target bulunur; başarısız dayanıklı gönderimler ayrıca başarısız aşamayı bildirebilir. Küme genişleyebileceğinden bilinmeyen değerleri opak olarak ele alın.
• resultCount: kullanılabildiğinde kanal gönderim sonuçlarının sayısı.
• sentBeforeError: kısmi bir hata, hatadan önce en az bir payload gönderdiyse true.
• error: başarısız veya kısmen başarısız gönderimler için boolean true.
• errorMessage: yalnızca altta yatan bir teslimat hata iletisi yakalandığında eklenir. Ön kontrol hataları error ve reason taşır ancak errorMessage içermez.
• payloadOutcomes: kullanılabildiğinde index, status, reason, resultCount, error, stage, sentBeforeError veya hook meta verileriyle isteğe bağlı payload başına sonuçlar.

​

İlgili

• CLI referansı
• Ajan çalışma zamanı