核心用法
OpenClaw LLM Router 是一个统一的大语言模型路由网关,通过单一 API 密钥 (AISA_API_KEY) 即可访问包括 GPT-4、Claude、Gemini、Grok、Llama、Mistral 在内的 70+ 主流 AI 模型。其核心功能包括:
- 多模型对话:通过修改
model参数即可在不同模型间无缝切换,无需重写代码 - OpenAI SDK 兼容:支持直接替换
base_url和api_key使用现有 OpenAI SDK - 流式响应:支持 Server-Sent Events (SSE) 实时输出
- 视觉分析:支持 GPT-4o 等模型的图像理解能力
- 函数调用:支持结构化工具调用输出
- 模型对比:内置多模型并行对比功能
显著优点
1. 极简集成:一个 API 密钥替代 10+ 服务商的密钥管理,大幅降低运维复杂度
2. 成本优化:支持智能路由策略,可将简单查询路由至低价模型(如 Gemini-Flash),复杂任务使用 GPT-4/Claude
3. 高可用性:内置自动故障转移机制,单模型失效时自动切换备选模型
4. 统一计费:单一账单管理多模型用量,附带详细的 usage.cost 和 credits_remaining 响应字段
5. 灵活接入:同时支持标准 HTTP API、Python CLI 客户端和原生 SDK 三种方式
潜在缺点与局限性
- 第三方依赖:所有请求经由 AIsa 中转,存在服务可用性和数据隐私的额外信任链
- 模型版本滞后:实际可用模型列表可能滞后于官方最新版本(如 GPT-5 系列标注为预览状态)
- 定价透明度:仅提供"近似成本"参考,实际计费需依赖平台实时定价页
- 功能裁剪风险:部分原生模型特性(如 Claude 的 extended thinking)可能未完全暴露
- 地域合规:未明确说明数据存储位置及 GDPR/等合规认证细节
适合人群
- 需要快速对比多模型效果的 AI 产品团队
- 希望统一管控 AI 成本的中小企业
- 构建多模型容错架构的生产级应用开发者
- 不愿维护多 SDK 依赖的独立开发者
常规风险
- API 密钥泄露:单一密钥权限覆盖所有模型,泄露后果较直接调用单一服务商更严重
- 供应商锁定:深度集成后迁移至直接 API 需修改 base_url 及潜在适配层
- 速率限制:统一网关可能引入额外的并发瓶颈,高流量场景需提前测试
- 数据隐私:敏感数据经第三方中转,需评估 AIsa 的安全审计与数据处理协议