OmniRoute 接入配置
给一套自建 OmniRoute AI 路由服务,把它接进 Opencode 作为默认模型或 OpenAI 兼容端点,配好 MCP 服务、多供应商组合和 A2A 智能体编排。
功能与用途
一套用于将 OmniRoute AI 统一路由服务接入开发环境的配置指南。它能把 OpenAI、Anthropic、Gemini、DeepSeek 等多家大模型聚合至单个兼容端点,具备智能负载均衡、提供商健康巡检、熔断降级与用量成本核算能力。开发者通过配置即可为对话、编码、复杂推理等场景绑定最佳模型组合,并可快速启用内置的 16 项 MCP 工具与 A2A 跨智能体协作协议,打造稳定高可用的模型调度底层架构。
适用场景
- 多厂商模型统一聚合接入:将主流大模型厂商收拢为一个兼容端点,支持故障时自动熔断切换与备选降级。
- 开发环境分场景模型绑定:在配置文件中将对话、代码生成、深度推理分别指定到性价比最优的模型组合。
- 智能体协议与工具集挂载:启用 OmniRoute 的 MCP 16 项工具及 A2A 协议,支撑多 Agent 协作与配额管控。
适用人群
- 自建 LLM 网关的平台工程师
- 做多模型路由与成本管控的 AI 基础设施负责人
- 用 Opencode 做智能体编排的开发者
使用步骤
- 先把 OmniRoute 服务跑起来(systemctl start omniroute),用 GET /status 和日志确认健康。
- 在 http://localhost:20128/api/v1/providers/ 下接入并管理各个供应商。
- 按任务场景选定组合(best-chat、best-coding、best-reasoning 等),用 /api/v1/combos/ 查看和维护。
- 在 Opencode 的 config.json 里把 OmniRoute 配成 mcp 远端服务和默认 model,或用 OpenAI 兼容方式指向 http://localhost:20128/v1。
- 接 MCP 客户端到 /mcp/stream,用 16 个工具做供应商切换、配额检查、成本报表和预算守护。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- AI工作流
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 专业
- 版本
- main
- 最近更新
- 2026-09-09
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Use when integrate with OmniRoute AI Router for multi-provider LLM routing,
使用前准备
- 需要一台可运行 OmniRoute 的机器、systemd 服务管理权限,以及至少一个已配置的 LLM 供应商凭证
- 生产接入还需 OAuth Token 管理。
依赖与权限
- PORT
- JWT_SECRET
- 读取用户主动提供的内容