​

CLI-бэкенды (резервная среда выполнения)

• Инструменты отключены (без вызовов инструментов).
• Текст на вход → текст на выход (надёжно).
• Сеансы поддерживаются (поэтому последующие реплики остаются связными).
• Изображения могут передаваться при условии, что CLI принимает пути к изображениям.

​

Быстрый старт для начинающих

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

​

Использование в качестве резервного варианта

{
  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 (список разрешённых), необходимо включить claude-cli/....
• Если основной провайдер не отвечает (аутентификация, лимиты, тайм-ауты), OpenClaw попробует CLI-бэкенд следующим.

​

Обзор конфигурации

agents.defaults.cliBackends

<provider>/<model>

​

Пример конфигурации

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

​

Как это работает

1. Выбирает бэкенд по префиксу провайдера (claude-cli/...).
2. Формирует системный prompt с использованием того же prompt OpenClaw + контекста рабочего пространства.
3. Выполняет CLI с идентификатором сеанса (если поддерживается), чтобы история оставалась согласованной.
4. Разбирает вывод (JSON или обычный текст) и возвращает финальный текст.
5. Сохраняет идентификаторы сеансов для каждого бэкенда, чтобы последующие запросы переиспользовали тот же сеанс CLI.

​

Сеансы

• Если CLI поддерживает сеансы, установите sessionArg (например, --session-id) или sessionArgs (заглушка {sessionId}), когда идентификатор нужно подставлять в несколько флагов.
• Если CLI использует подкоманду возобновления с другими флагами, установите resumeArgs (заменяет args при возобновлении) и при необходимости resumeOutput (для возобновлений без JSON).
• sessionMode:
  • always: всегда отправлять идентификатор сеанса (новый UUID, если ничего не сохранено).
  • existing: отправлять идентификатор сеанса только если он был сохранён ранее.
  • none: никогда не отправлять идентификатор сеанса.

​

Изображения (сквозная передача)

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

​

Ввод / вывод

• output: "json" (по умолчанию) пытается разобрать JSON и извлечь текст + идентификатор сеанса.
• output: "jsonl" разбирает потоки JSONL (Codex CLI --json) и извлекает последнее сообщение агента, а также thread_id при наличии.
• output: "text" рассматривает stdout как финальный ответ.

• input: "arg" (по умолчанию) передаёт prompt как последний аргумент CLI.
• input: "stdin" отправляет prompt через stdin.
• Если prompt очень длинный и задан maxPromptArgChars, используется stdin.

​

Значения по умолчанию (встроенные)

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

​

Ограничения

• Без инструментов OpenClaw (CLI-бэкенд никогда не получает вызовы инструментов). Некоторые CLI всё же могут запускать собственные агентные инструменты.
• Без потоковой передачи (вывод CLI собирается целиком, затем возвращается).
• Структурированные выводы зависят от JSON-формата CLI.
• Сеансы Codex CLI возобновляются через текстовый вывод (без JSONL), что менее структурировано, чем первоначальный запуск --json. Сеансы OpenClaw при этом продолжают работать нормально.

​

Устранение неполадок

• CLI не найден: задайте command как полный путь.
• Неверное имя модели: используйте modelAliases для сопоставления provider/model → модель CLI.
• Нет непрерывности сеанса: убедитесь, что задан sessionArg и что sessionMode не равен none (Codex CLI в настоящее время не может возобновляться с JSON-выводом).
• Изображения игнорируются: установите imageArg (и убедитесь, что CLI поддерживает пути к файлам).