OpenClaw 作为开源本地优先的 AI 智能体执行网关，其 API 选择的核心，本质是围绕 "让 AI 从对话走向自主执行" 的目标，构建一套兼容、可控、可扩展的模型与能力调度体系 。它不只是简单接入大模型接口，而是通过标准化 API 设计，实现模型、技能、渠道、设备的高效协同，最终完成 "理解指令 --- 规划任务 --- 调用能力 --- 反馈结果" 的完整执行闭环。以下从核心原则、关键维度、选型逻辑三方面，拆解 OpenClaw 选择 API 的核心逻辑。
一、核心原则：API 选型的底层逻辑
OpenClaw 的 API 选型始终围绕三大核心原则，这是其区别于普通 AI 接口工具的关键：
- 模型无关，兼容优先 不绑定单一模型厂商，API 设计完全兼容 OpenAI 规范，同时支持 Claude、Gemini、通义千问、DeepSeek 等国内外主流大模型，甚至本地部署的开源模型。核心是让用户可自由切换模型，无需修改业务代码，实现 "一次接入，多模型可用"openclawapi.org。
- 本地优先，安全可控 所有 API 交互、会话数据、执行记录默认存储在本地设备或自建服务器，不依赖第三方云服务存储核心数据openclawapi.org。API 鉴权、数据传输、权限控制均采用本地加密机制，确保企业与个人数据隐私不泄露，满足合规与安全需求。
- 执行导向，能力聚合 API 的核心价值不是 "生成文本"，而是 "执行任务"。选型时优先支持Function Calling、工具调用、技能联动 的接口，让 AI 能通过 API 调用本地文件、浏览器、终端、第三方系统（如 ERP、CRM）等能力，将自然语言指令转化为实际操作。
二、关键维度：API 选型的核心考量
基于上述原则，OpenClaw 选择 API 时，会从以下 5 个核心维度评估，缺一不可：
1. 协议兼容性：降低接入成本
- 必须兼容OpenAI Completions/ Chat Completions 标准协议，支持v1/chat/completions等核心接口，参数结构（如model、messages、temperature）与 OpenAI 完全对齐。
- 场景适配 ：按任务类型匹配模型 API：轻量问答选低成本、快响应的模型（如 Qwen2-7B）；复杂自动化、代码生成选高性能模型（如 Claude 3、GPT-4）；多模态交互选支持图片、语音的模型 API。
3. 稳定性与性能：保障执行可靠
- 可用性 ：API 服务可用性≥99.9%，支持重试机制、熔断策略，避免因接口故障导致任务中断。
- 延迟 ：实时交互场景（如聊天机器人）延迟≤500ms；自动化任务场景延迟≤2s，确保执行效率。
- 并发 ：支持高并发请求，企业级场景需满足 QPS≥100，适配多用户、多任务同时执行。
三、选型逻辑：不同场景的 API 选择策略
结合 OpenClaw 的使用场景，API 选型可分为 4 类核心策略，覆盖个人、团队、企业全场景：
1. 个人 / 轻量测试场景
- 核心需求：低成本、易接入、快速验证
- 推荐 API：147API、PoloAPI 等性价比中转平台，或直接接入开源模型本地 API（如 Ollama）。
- 选型重点：优先兼容 OpenAI 协议、无复杂配置、支持免费额度，满足个人自动化、简单任务执行需求。
2. 团队 / 开发验证场景
- 核心需求：灵活调度、多模型对比、稳定可靠
- 推荐 API：OpenRouter （全球模型路由，覆盖广、策略灵活）、阿里云百炼 API（国内模型适配，支持 Qwen 系列）。
- 选型重点：支持多模型同时接入、热重载切换、详细调用日志，方便团队开发调试、模型效果对比。
