​

CLI arka uçları (yedek çalışma zamanı)

• Araçlar devre dışıdır (araç çağrısı yok).
• Metin gir → metin çık (güvenilir).
• Oturumlar desteklenir (takip eden turların tutarlı kalması için).
• CLI görüntü yollarını kabul ediyorsa, görüntüler iletilebilir.

​

Yeni başlayanlar için hızlı başlangıç

openclaw agent --message "hi" --model claude-cli/opus-4.6

openclaw agent --message "hi" --model codex-cli/gpt-5.3-codex

{
  agents: {
    defaults: {
      cliBackends: {
        "claude-cli": {
          command: "/opt/homebrew/bin/claude",
        },
      },
    },
  },
}

​

Yedek olarak kullanma

{
  agents: {
    defaults: {
      model: {
        primary: "anthropic/claude-opus-4-6",
        fallbacks: ["claude-cli/opus-4.6", "claude-cli/opus-4.5"],
      },
      models: {
        "anthropic/claude-opus-4-6": { alias: "Opus" },
        "claude-cli/opus-4.6": {},
        "claude-cli/opus-4.5": {},
      },
    },
  },
}

• agents.defaults.models (izin listesi) kullanıyorsanız, claude-cli/... eklemelisiniz.
• Birincil sağlayıcı başarısız olursa (kimlik doğrulama, oran sınırlamaları, zaman aşımları), OpenClaw sıradaki olarak CLI arka ucunu dener.

​

Yapılandırmaya genel bakış

agents.defaults.cliBackends

<provider>/<model>

​

Örnek yapılandırma

{
  agents: {
    defaults: {
      cliBackends: {
        "claude-cli": {
          command: "/opt/homebrew/bin/claude",
        },
        "my-cli": {
          command: "my-cli",
          args: ["--json"],
          output: "json",
          input: "arg",
          modelArg: "--model",
          modelAliases: {
            "claude-opus-4-6": "opus",
            "claude-opus-4-5": "opus",
            "claude-sonnet-4-5": "sonnet",
          },
          sessionArg: "--session",
          sessionMode: "existing",
          sessionIdFields: ["session_id", "conversation_id"],
          systemPromptArg: "--system",
          systemPromptWhen: "first",
          imageArg: "--image",
          imageMode: "repeat",
          serialize: true,
        },
      },
    },
  },
}

​

Nasıl çalışır

1. Bir arka uç seçer, sağlayıcı önekine göre (claude-cli/...).
2. Bir sistem istemi oluşturur, aynı OpenClaw istemi + çalışma alanı bağlamını kullanarak.
3. CLI’yi çalıştırır, geçmişin tutarlı kalması için (destekleniyorsa) bir oturum kimliğiyle.
4. Çıktıyı ayrıştırır (JSON veya düz metin) ve nihai metni döndürür.
5. Oturum kimliklerini kalıcılaştırır, böylece takip eden istekler aynı CLI oturumunu yeniden kullanır.

​

Sessions

• CLI oturumları destekliyorsa, sessionArg (örn. --session-id) veya kimliğin birden fazla bayrağa eklenmesi gerektiğinde sessionArgs (yer tutucu {sessionId}) ayarlayın.
• CLI farklı bayraklara sahip bir resume alt komutu kullanıyorsa, resumeArgs ayarlayın (devam ederken args yerine geçer) ve isteğe bağlı olarak resumeOutput (JSON olmayan devamlar için).
• sessionMode:
  • always: her zaman bir oturum kimliği gönder (saklı yoksa yeni bir UUID).
  • existing: yalnızca daha önce saklanmış bir oturum kimliği varsa gönder.
  • none: asla oturum kimliği gönderme.

​

Görüntüler (iletim)

imageArg: "--image",
imageMode: "repeat"

​

Girdiler / çıktılar

• output: "json" (varsayılan) JSON’u ayrıştırmayı ve metin + oturum kimliğini çıkarmayı dener.
• output: "jsonl", JSONL akışlarını (Codex CLI --json) ayrıştırır ve mevcutsa son ajan mesajını ve thread_id’u çıkarır.
• output: "text", stdout’u nihai yanıt olarak ele alır.

• input: "arg" (varsayılan) istemi son CLI argümanı olarak iletir.
• input: "stdin", istemi stdin üzerinden gönderir.
• İstem çok uzunsa ve maxPromptArgChars ayarlıysa, stdin kullanılır.

​

Varsayılanlar (yerleşik)

• command: "claude"
• args: ["-p", "--output-format", "json", "--dangerously-skip-permissions"]
• resumeArgs: ["-p", "--output-format", "json", "--dangerously-skip-permissions", "--resume", "{sessionId}"]
• modelArg: "--model"
• systemPromptArg: "--append-system-prompt"
• sessionArg: "--session-id"
• systemPromptWhen: "first"
• sessionMode: "always"

• command: "codex"
• args: ["exec","--json","--color","never","--sandbox","read-only","--skip-git-repo-check"]
• resumeArgs: ["exec","resume","{sessionId}","--color","never","--sandbox","read-only","--skip-git-repo-check"]
• output: "jsonl"
• resumeOutput: "text"
• modelArg: "--model"
• imageArg: "--image"
• sessionMode: "existing"

​

Sınırlamalar

• OpenClaw araçları yok (CLI arka ucu hiçbir zaman araç çağrıları almaz). Bazı CLI’ler kendi ajan araçlarını yine de çalıştırabilir.
• Akış yok (CLI çıktısı toplanır, sonra döndürülür).
• Yapılandırılmış çıktılar, CLI’nin JSON formatına bağlıdır.
• Codex CLI oturumları, metin çıktısı üzerinden devam eder (JSONL yoktur); bu, ilk --json çalıştırmasına kıyasla daha az yapılandırılmıştır. OpenClaw oturumları yine de normal şekilde çalışır.

​

Sorun Giderme

• CLI bulunamadı: command’i tam bir yol olarak ayarlayın.
• Yanlış model adı: modelAliases kullanarak provider/model → CLI model eşlemesi yapın.
• Oturum sürekliliği yok: sessionArg’in ayarlı olduğundan ve sessionMode’un none olmadığından emin olun (Codex CLI şu anda JSON çıktısıyla devam edemez).
• Görüntüler yok sayılıyor: imageArg’i ayarlayın (ve CLI’nin dosya yollarını desteklediğini doğrulayın).