Providers

OpenClaw 可以通过 pi‑ai 的 Bedrock Converse 流式提供商使用 Amazon Bedrock 模型。Bedrock 认证使用 AWS SDK 默认凭证链，而非 API 密钥。 pi‑ai 支持的功能 提供商：amazon-bedrock API：bedrock-converse-stream 认证：AWS 凭证（环境变量、共享配置或实例角色） 区域：AWS_REGION 或 AWS_DEFAULT_REGION（默认：us-east-1） 自动模型发现 如果检测到 AWS 凭证，OpenClaw 可以自动发现支持流式传输和文本输出的 Bedrock 模型。发现功能使用 bedrock:ListFoundationModels，并会被缓存（默认：1 小时）。 配置选项位于 models.bedrockDiscovery 下： { models: { bedrockDiscovery: { enabled: true, region: "us-east-1", providerFilter: ["anthropic", "amazon"], refreshInterval: 3600, defaultContextWindow: 32000, defaultMaxTokens: 4096, }, }, } 注意事项： enabled 在存在 AWS 凭证时默认为 true。 region 默认为 AWS_REGION 或 AWS_DEFAULT_REGION，然后是 us-east-1。 providerFilter 匹配 Bedrock 提供商名称（例如 anthropic）。 refreshInterval 单位为秒；设置为 0 可禁用缓存。 defaultContextWindow（默认：32000）和 defaultMaxTokens（默认：4096）用于已发现的模型（如果你知道模型限制，可以覆盖这些值）。 设置（手动） 确保 AWS 凭证在 Gateway 网关主机上可用： export AWS_ACCESS_KEY_ID="AKIA..." export AWS_SECRET_ACCESS_KEY="..." export AWS_REGION="us-east-1" # 可选： export AWS_SESSION_TOKEN="..." export AWS_PROFILE="your-profile" # 可选（Bedrock API 密钥/Bearer 令牌）： export AWS_BEARER_TOKEN_BEDROCK="..." 在配置中添加 Bedrock 提供商和模型（无需 apiKey）： { models: { providers: { "amazon-bedrock": { baseUrl: "https://bedrock-runtime.us-east-1.amazonaws.com", api: "bedrock-converse-stream", auth: "aws-sdk", models: [ { id: "anthropic.claude-opus-4-5-20251101-v1:0", name: "Claude Opus 4.5 (Bedrock)", reasoning: true, input: ["text", "image"], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 200000, maxTokens: 8192, }, ], }, }, }, agents: { defaults: { model: { primary: "amazon-bedrock/anthropic.claude-opus-4-5-20251101-v1:0" }, }, }, } EC2 实例角色 当在附加了 IAM 角色的 EC2 实例上运行 OpenClaw 时，AWS SDK 会自动使用实例元数据服务（IMDS）进行认证。但是，OpenClaw 的凭证检测目前只检查环境变量，不检查 IMDS 凭证。 ...

Anthropic 构建了 Claude 模型系列，并通过 API 提供访问。 在 OpenClaw 中，你可以使用 API 密钥或 setup-token 进行认证。 选项 A：Anthropic API 密钥 适用于： 标准 API 访问和按用量计费。 在 Anthropic Console 中创建你的 API 密钥。 CLI 设置 openclaw onboard # 选择：Anthropic API key # 或非交互式 openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY" 配置片段 { env: { ANTHROPIC_API_KEY: "sk-ant-..." }, agents: { defaults: { model: { primary: "anthropic/claude-opus-4-5" } } }, } 提示缓存（Anthropic API） OpenClaw 支持 Anthropic 的提示缓存功能。这是仅限 API；订阅认证不支持缓存设置。 配置 在模型配置中使用 cacheRetention 参数： ...

claude-max-api-proxy 是一个社区工具，将你的 Claude Max/Pro 订阅暴露为 OpenAI 兼容的 API 端点。这使你可以将订阅与任何支持 OpenAI API 格式的工具配合使用。 为什么使用它？ 方式 费用 适用场景 Anthropic API 按 token 计费（Opus 约 $15/M 输入，$75/M 输出） 生产应用、高流量场景 Claude Max 订阅 每月固定 $200 个人使用、开发、无限用量 如果你有 Claude Max 订阅并希望与 OpenAI 兼容工具配合使用，这个代理可以帮你节省大量费用。 工作原理 你的应用 → claude-max-api-proxy → Claude Code CLI → Anthropic（通过订阅） （OpenAI 格式） （转换格式） （使用你的登录凭据） 该代理： 在 http://localhost:3456/v1/chat/completions 接受 OpenAI 格式的请求 将其转换为 Claude Code CLI 命令 以 OpenAI 格式返回响应（支持流式传输） 安装 # 需要 Node.js 20+ 和 Claude Code CLI npm install -g claude-max-api-proxy # 验证 Claude CLI 已认证 claude --version 使用方法 启动服务器 claude-max-api # 服务器运行在 http://localhost:3456 测试 # 健康检查 curl http://localhost:3456/health # 列出模型 curl http://localhost:3456/v1/models # 聊天补全 curl http://localhost:3456/v1/chat/completions \ -H "Content-Type: application/json" \ -d '{ "model": "claude-opus-4", "messages": [{"role": "user", "content": "Hello!"}] }' 与 OpenClaw 配合使用 你可以将 OpenClaw 指向该代理作为自定义 OpenAI 兼容端点： ...

Deepgram 是一个语音转文字 API。在 OpenClaw 中，它通过 tools.media.audio 用于接收音频/语音消息的转录。 启用后，OpenClaw 会将音频文件上传到 Deepgram，并将转录文本注入回复管道（{{Transcript}} + [Audio] 块）。这不是流式处理；它使用的是预录音转录端点。 网站：https://deepgram.com 文档：https://developers.deepgram.com 快速开始 设置你的 API 密钥： DEEPGRAM_API_KEY=dg_... 启用提供商： { tools: { media: { audio: { enabled: true, models: [{ provider: "deepgram", model: "nova-3" }], }, }, }, } 选项 model：Deepgram 模型 ID（默认：nova-3） language：语言提示（可选） tools.media.audio.providerOptions.deepgram.detect_language：启用语言检测（可选） tools.media.audio.providerOptions.deepgram.punctuate：启用标点符号（可选） tools.media.audio.providerOptions.deepgram.smart_format：启用智能格式化（可选） 带语言参数的示例： { tools: { media: { audio: { enabled: true, models: [{ provider: "deepgram", model: "nova-3", language: "en" }], }, }, }, } 带 Deepgram 选项的示例： ...

什么是 GitHub Copilot？ GitHub Copilot 是 GitHub 的 AI 编程助手。它为你的 GitHub 账户和订阅计划提供 Copilot 模型的访问权限。OpenClaw 可以通过两种不同的方式将 Copilot 用作模型提供商。 在 OpenClaw 中使用 Copilot 的两种方式 1）内置 GitHub Copilot 提供商（github-copilot） 使用原生设备登录流程获取 GitHub 令牌，然后在 OpenClaw 运行时将其兑换为 Copilot API 令牌。这是默认且最简单的方式，因为它不需要 VS Code。 2）Copilot Proxy 插件（copilot-proxy） 使用 Copilot Proxy VS Code 扩展作为本地桥接。OpenClaw 与代理的 /v1 端点通信，并使用你在其中配置的模型列表。当你已经在 VS Code 中运行 Copilot Proxy 或需要通过它进行路由时，选择此方式。你必须启用该插件并保持 VS Code 扩展运行。 使用 GitHub Copilot 作为模型提供商（github-copilot）。登录命令运行 GitHub 设备流程，保存认证配置文件，并更新你的配置以使用该配置文件。 CLI 设置 openclaw models auth login-github-copilot 系统会提示你访问一个 URL 并输入一次性代码。请保持终端打开直到流程完成。 ...

GLM 是一个模型系列（而非公司），通过 Z.AI 平台提供。在 OpenClaw 中，GLM 模型通过 zai 提供商访问，模型 ID 格式如 zai/glm-4.7。 CLI 设置 openclaw onboard --auth-choice zai-api-key 配置片段 { env: { ZAI_API_KEY: "sk-..." }, agents: { defaults: { model: { primary: "zai/glm-4.7" } } }, } 注意事项 GLM 版本和可用性可能会变化；请查阅 Z.AI 的文档获取最新信息。 示例模型 ID 包括 glm-4.7 和 glm-4.6。 有关提供商的详细信息，请参阅 /providers/zai。

MiniMax 是一家构建 M2/M2.1 模型系列的 AI 公司。当前面向编程的版本是 MiniMax M2.1（2025 年 12 月 23 日），专为现实世界的复杂任务而构建。 来源：MiniMax M2.1 发布说明 模型概述（M2.1） MiniMax 强调 M2.1 的以下改进： 更强的多语言编程能力（Rust、Java、Go、C++、Kotlin、Objective-C、TS/JS）。 更好的 Web/应用开发和美观输出质量（包括原生移动端）。 改进的复合指令处理，适用于办公风格的工作流程，基于交错思考和集成约束执行。 更简洁的响应，更低的 token 使用量和更快的迭代循环。 更强的工具/智能体框架兼容性和上下文管理（Claude Code、Droid/Factory AI、Cline、Kilo Code、Roo Code、BlackBox）。 更高质量的对话和技术写作输出。 MiniMax M2.1 vs MiniMax M2.1 Lightning 速度： Lightning 是 MiniMax 定价文档中的"快速"变体。 成本： 定价显示相同的输入成本，但 Lightning 的输出成本更高。 编程计划路由： Lightning 后端在 MiniMax 编程计划中不能直接使用。MiniMax 自动将大多数请求路由到 Lightning，但在流量高峰期会回退到常规 M2.1 后端。 选择设置方式 MiniMax OAuth（编程计划）— 推荐 适用于： 通过 OAuth 快速设置 MiniMax 编程计划，无需 API 密钥。 ...

Moonshot 提供兼容 OpenAI 端点的 Kimi API。配置提供商并将默认模型设置为 moonshot/kimi-k2.5，或使用 Kimi Coding 的 kimi-coding/k2p5。 当前 Kimi K2 模型 ID： {/_ moonshot-kimi-k2-ids:start _/} kimi-k2.5 kimi-k2-0905-preview kimi-k2-turbo-preview kimi-k2-thinking kimi-k2-thinking-turbo {/_ moonshot-kimi-k2-ids:end _/} openclaw onboard --auth-choice moonshot-api-key Kimi Coding： openclaw onboard --auth-choice kimi-code-api-key 注意：Moonshot 和 Kimi Coding 是独立的提供商。密钥不可互换，端点不同，模型引用也不同（Moonshot 使用 moonshot/...，Kimi Coding 使用 kimi-coding/...）。 配置片段（Moonshot API） { env: { MOONSHOT_API_KEY: "sk-..." }, agents: { defaults: { model: { primary: "moonshot/kimi-k2.5" }, models: { // moonshot-kimi-k2-aliases:start "moonshot/kimi-k2.5": { alias: "Kimi K2.5" }, "moonshot/kimi-k2-0905-preview": { alias: "Kimi K2" }, "moonshot/kimi-k2-turbo-preview": { alias: "Kimi K2 Turbo" }, "moonshot/kimi-k2-thinking": { alias: "Kimi K2 Thinking" }, "moonshot/kimi-k2-thinking-turbo": { alias: "Kimi K2 Thinking Turbo" }, // moonshot-kimi-k2-aliases:end }, }, }, models: { mode: "merge", providers: { moonshot: { baseUrl: "https://api.moonshot.ai/v1", apiKey: "${MOONSHOT_API_KEY}", api: "openai-completions", models: [ // moonshot-kimi-k2-models:start { id: "kimi-k2.5", name: "Kimi K2.5", reasoning: false, input: ["text"], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 256000, maxTokens: 8192, }, { id: "kimi-k2-0905-preview", name: "Kimi K2 0905 Preview", reasoning: false, input: ["text"], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 256000, maxTokens: 8192, }, { id: "kimi-k2-turbo-preview", name: "Kimi K2 Turbo", reasoning: false, input: ["text"], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 256000, maxTokens: 8192, }, { id: "kimi-k2-thinking", name: "Kimi K2 Thinking", reasoning: true, input: ["text"], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 256000, maxTokens: 8192, }, { id: "kimi-k2-thinking-turbo", name: "Kimi K2 Thinking Turbo", reasoning: true, input: ["text"], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 256000, maxTokens: 8192, }, // moonshot-kimi-k2-models:end ], }, }, }, } Kimi Coding { env: { KIMI_API_KEY: "sk-..." }, agents: { defaults: { model: { primary: "kimi-coding/k2p5" }, models: { "kimi-coding/k2p5": { alias: "Kimi K2.5" }, }, }, }, } 注意事项 Moonshot 模型引用使用 moonshot/<modelId>。Kimi Coding 模型引用使用 kimi-coding/<modelId>。 如有需要，可在 models.providers 中覆盖定价和上下文元数据。 如果 Moonshot 发布了某个模型的不同上下文限制，请相应调整 contextWindow。 如需使用中国端点，请使用 https://api.moonshot.cn/v1。

Ollama 是一个本地 LLM 运行时，可以轻松在你的机器上运行开源模型。OpenClaw 通过 Ollama 的 OpenAI 兼容 API 进行集成，并且当你通过 OLLAMA_API_KEY（或认证配置）启用且未定义显式的 models.providers.ollama 条目时，可以自动发现支持工具调用的模型。 快速开始 安装 Ollama：https://ollama.ai 拉取模型： ollama pull llama3.3 # 或 ollama pull qwen2.5-coder:32b # 或 ollama pull deepseek-r1:32b 为 OpenClaw 启用 Ollama（任意值即可；Ollama 不需要真实密钥）： # 设置环境变量 export OLLAMA_API_KEY="ollama-local" # 或在配置文件中设置 openclaw config set models.providers.ollama.apiKey "ollama-local" 使用 Ollama 模型： { agents: { defaults: { model: { primary: "ollama/llama3.3" }, }, }, } 模型发现（隐式提供商） 当你设置了 OLLAMA_API_KEY（或认证配置）且未定义 models.providers.ollama 时，OpenClaw 会从本地 Ollama 实例 http://127.0.0.1:11434 发现模型： ...

OpenAI 提供 GPT 模型的开发者 API。Codex 支持ChatGPT 登录进行订阅访问，或API 密钥登录进行按量计费访问。Codex 云端需要 ChatGPT 登录。 方式 A：OpenAI API 密钥（OpenAI Platform） **适用于：**直接 API 访问和按量计费。 从 OpenAI 控制台获取你的 API 密钥。 CLI 设置 openclaw onboard --auth-choice openai-api-key # 或非交互式 openclaw onboard --openai-api-key "$OPENAI_API_KEY" 配置片段 { env: { OPENAI_API_KEY: "sk-..." }, agents: { defaults: { model: { primary: "openai/gpt-5.2" } } }, } 方式 B：OpenAI Code（Codex）订阅 **适用于：**使用 ChatGPT/Codex 订阅访问而非 API 密钥。 Codex 云端需要 ChatGPT 登录，而 Codex CLI 支持 ChatGPT 或 API 密钥登录。 ...