​

Backendy CLI (środowisko wykonawcze awaryjne)

• Narzędzia są wyłączone (brak wywołań narzędzi).
• Tekst na wejściu → tekst na wyjściu (niezawodne).
• Sesje są obsługiwane (kolejne tury zachowują spójność).
• Obrazy mogą być przekazywane (pass-through), jeśli CLI akceptuje ścieżki do obrazów.

​

Przyjazny dla początkujących szybki start

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",
        },
      },
    },
  },
}

​

Użycie jako tryb awaryjny

{
  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": {},
      },
    },
  },
}

• Jeśli używasz agents.defaults.models (lista dozwolonych), musisz uwzględnić claude-cli/....
• Jeśli podstawowy dostawca zawiedzie (uwierzytelnianie, limity, timeouty), OpenClaw spróbuje następnie backendu CLI.

​

Przegląd konfiguracji

agents.defaults.cliBackends

<provider>/<model>

​

Przykładowa konfiguracja

{
  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,
        },
      },
    },
  },
}

​

Jak to działa

1. Wybiera backend na podstawie prefiksu dostawcy (claude-cli/...).
2. Buduje prompt systemowy z użyciem tego samego promptu OpenClaw + kontekstu obszaru roboczego.
3. Wykonuje CLI z identyfikatorem sesji (jeśli obsługiwane), aby historia pozostała spójna.
4. Parsuje wyjście (JSON lub zwykły tekst) i zwraca końcowy tekst.
5. Utrwala identyfikatory sesji per backend, aby kolejne wywołania używały tej samej sesji CLI.

​

Sessions

• Jeśli CLI obsługuje sesje, ustaw sessionArg (np. --session-id) lub sessionArgs (placeholder {sessionId}), gdy identyfikator musi być wstawiony do wielu flag.
• Jeśli CLI używa podpolecenia wznawiania z innymi flagami, ustaw resumeArgs (zastępuje args przy wznawianiu) oraz opcjonalnie resumeOutput (dla wznawiania nie-JSON).
• sessionMode:
  • always: zawsze wysyłaj identyfikator sesji (nowy UUID, jeśli żaden nie jest zapisany).
  • existing: wysyłaj identyfikator sesji tylko wtedy, gdy był wcześniej zapisany.
  • none: nigdy nie wysyłaj identyfikatora sesji.

​

Obrazy (pass-through)

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

​

Wejścia / wyjścia

• output: "json" (domyślnie) próbuje sparsować JSON i wyodrębnić tekst + identyfikator sesji.
• output: "jsonl" parsuje strumienie JSONL (Codex CLI --json) i wyodrębnia ostatnią wiadomość agenta oraz thread_id, gdy jest obecne.
• output: "text" traktuje stdout jako odpowiedź końcową.

• input: "arg" (domyślnie) przekazuje prompt jako ostatni argument CLI.
• input: "stdin" wysyła prompt przez stdin.
• Jeśli prompt jest bardzo długi i ustawiono maxPromptArgChars, używany jest stdin.

​

Ustawienia domyślne (wbudowane)

• 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"

​

Ograniczenia

• Brak narzędzi OpenClaw (backend CLI nigdy nie otrzymuje wywołań narzędzi). Niektóre CLI mogą nadal uruchamiać własne narzędzia agenta.
• Brak strumieniowania (wyjście CLI jest zbierane, a następnie zwracane).
• Wyjścia strukturalne zależą od formatu JSON danego CLI.
• Sesje Codex CLI są wznawiane przez wyjście tekstowe (bez JSONL), co jest mniej ustrukturyzowane niż początkowe uruchomienie --json. Sesje OpenClaw nadal działają normalnie.

​

Rozwiązywanie problemów

• Nie znaleziono CLI: ustaw command na pełną ścieżkę.
• Nieprawidłowa nazwa modelu: użyj modelAliases, aby mapować provider/model → model CLI.
• Brak ciągłości sesji: upewnij się, że ustawiono sessionArg oraz że sessionMode nie jest none (Codex CLI obecnie nie może wznawiać z wyjściem JSON).
• Obrazy ignorowane: ustaw imageArg (i sprawdź, czy CLI obsługuje ścieżki plików).