CLI Backends（本地 AI CLI 后备）

OpenClaw 支持将本地 AI CLI（如 Codex CLI、Claude CLI、Gemini CLI）作为 API 提供商不可用时的文本后备。

核心特性

仅文本后备，不直接注入 OpenClaw 工具（除非启用 bundleMcp: true）
支持 JSONL 流式输出
支持会话连续性（follow-up 保持上下文）
支持图片透传

快速开始

无需配置直接使用 Codex CLI：

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

配置绝对路径（适用于 launchd/systemd 环境）：

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

作为 fallback 使用

{
  agents: {
    defaults: {
      model: {
        primary: "anthropic/claude-opus-4-6",
        fallbacks: ["codex-cli/gpt-5.5"],
      },
    },
  },
}

配置结构

所有 CLI backends 配置在 agents.defaults.cliBackends 下，key 为 provider id，model ref 格式为 <provider>/<model>。

关键配置字段：

字段	说明
`command`	CLI 可执行文件路径
`args`	启动参数
`output`	输出格式：`json`/`jsonl`/`text`
`input`	输入方式：`arg`/`stdin`
`modelArg`	指定模型的参数名
`sessionArg`	会话 ID 参数名
`sessionMode`	`always`/`existing`/`none`
`imageArg`	图片路径参数名
`bundleMcp`	是否通过 MCP loopback 桥接 gateway 工具

内置 Backend 说明

claude-cli：

保持 Claude stdio 进程存活，follow-up 复用同一进程
映射 /think 级别到 Claude Code 的 --effort 参数
使用前需先登录：claude auth login

codex-cli：

通过 model_instructions_file 传递系统提示
默认参数包含 --sandbox workspace-write

google-gemini-cli：

需安装 gemini CLI：brew install gemini-cli
从 JSON response 字段读取回复文本

Bundle MCP 工具桥接

启用 bundleMcp: true 后，OpenClaw 会：

启动 loopback HTTP MCP 服务器，暴露 gateway 工具给 CLI 进程
用 per-session token 认证桥接
按当前 session/account/channel 上下文限制工具访问

Wiki AI

目录