SuperAPI AI 工具集

omniroute-cli

部署与运维

查看项目

更新于 10-22 16:16

技能介绍

OmniRoute CLI 是 OmniRoute 服务器的命令行入口,以 omniroute 二进制形式随服务器一同发布,同时承担服务器启动器和完整管理 CLI 两种角色,包含 250+ 条命令、分布在 39 个命令组中。

安装与验证 可通过 npm 全局安装:npm install -g omniroute;也可使用桌面应用内捆绑的二进制。运行环境要求 Node.js ≥20.20.2、≥22.22.2 或 ≥24。安装后可用 omniroute --version 查看版本,用 omniroute --help 查看完整命令树。

连接配置 所有与服务器通信的 CLI 命令读取两个值:基础 URL(来自 OMNIROUTE_BASE_URL 环境变量或 --base-url 参数,默认 http://localhost:20128)和 API 密钥(来自 OMNIROUTE_API_KEY 环境变量或 --api-key 参数,密钥可在 Dashboard → API Manager 获取)。连接远程服务器时,只需将 OMNIROUTE_BASE_URL 设置为远程地址。

全局标志 包括 --base-url 覆盖服务器 URL、--api-key 覆盖密钥、--output 选择输出格式(table 默认、json、jsonl、csv)、--json 作为 --output json 的简写、--non-interactive 禁用交互提示以适配 CI 与 shell 脚本、--no-open 禁止启动时自动打开浏览器、--port 覆盖默认端口 20128,以及 --help/-h 和 --version/-v。

输出格式 所有列表类命令均支持输出格式切换。例如 omniroute combo list 默认输出人类可读的表格,添加 --output json 输出 JSON 数组,--output jsonl 每行一个 JSON 对象,--output csv 输出带表头的 CSV。

快速开始 典型流程为三步:先运行 omniroute 启动服务器;首次运行时执行 omniroute setup 进入交互式设置向导;最后运行 omniroute doctor 验证整体健康状况。

能力技能索引 资料列出四个 CLI 能力技能文档链接,分别覆盖服务器管理与备份、提供商与密钥管理、云代理(Codex / Devin / Jules)、评估与基准测试,均指向 GitHub raw 内容。若需直接使用 HTTP 而非 CLI,可参考 OmniRoute 入口技能中的 REST API 部分。

常见错误处理 连接被拒绝表示服务器未运行,可运行 omniroute 或 omniroute serve;401 Unauthorized 表示 API 密钥错误或缺失;command not found: omniroute 表示不在 PATH 中,可检查 npm root -g 或重新安装;doctor 报告 SQLite 不兼容时,可在应用目录执行 npm rebuild better-sqlite3。

适用场景与限制 该 CLI 适合需要通过命令行管理 OmniRoute 服务器、提供商密钥、云代理和评估任务的用户,尤其便于在 CI 或脚本中自动化操作。资料未说明具体收费、价格、平台支持范围及全部命令细节,这些内容暂未提供。