关于 install-ori-harness
install-ori-harness 是指导安装和使用 Ori 的 Agent 技能,面向希望通过 Ori 运行现有编码 Agent 的用户。内容涵盖 OpenRouter OAuth 登录、模型选择和升级,同时保留原有 Agent 命令与参数。
主要功能
- 01安装并验证 Ori 命令行
- 02通过 OpenRouter OAuth 登录
- 03运行现有编码 Agent
- 04选择 OpenRouter 模型
- 05升级 Ori
适用场景
- 01首次安装并配置 Ori
- 02通过 Ori 启动现有 Agent
- 03为 Agent 指定 OpenRouter 模型
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ openrouterteam/ skills --skill install-ori-harness安装后在 Claude Code 中输入/install-ori-harness确认已加载。
附带文件README.md
详细介绍
安装并运行 Ori Harness
当用户想要安装 Ori、通过 Ori 运行现有编码 Agent、登录 Ori、升级 Ori,或为本地 Agent 选择 OpenRouter 模型时,请使用此操作指南。不要将其用于模型评测、普通单元测试,或用户只想在不使用 Ori 的情况下直接运行已安装的 Agent。
1. 安装 Ori
运行官方安装程序:
curl -fsSL https://openrouter.ai/labs/ori/install.sh | bash
安装程序会将 ori 可执行文件放在用户的本地安装位置。除非用户明确选择系统级安装位置,否则不要使用 sudo。
2. 验证 CLI
运行:
ori --version
该命令必须打印版本号并成功退出。如果 shell 找不到 ori,请检查安装程序报告的目录,并确保用户的本地二进制文件目录位于 PATH 中,然后启动新的 shell 或更新 PATH,再继续操作。
3. 使用 OpenRouter OAuth 登录
运行:
ori login
Ori 会打开用户的浏览器,让用户使用现有 OpenRouter 账户通过 OAuth 登录,并为 CLI 保存相应凭据。用户无需创建、复制或粘贴 API 密钥。如果无法打开浏览器,请使用 ori login --no-browser,并将打印出的 URL 提供给用户。
OAuth 可用时,不要要求用户粘贴密钥。用户已有明确导出的 OPENROUTER_API_KEY 时,Ori 仍可使用该密钥,但此设置不需要它。
4. 运行用户现有的 Agent CLI
Ori 会运行用户的 PATH 中已安装的 Agent CLI。它不会替换用户的 Agent,也不会让用户学习新的 Agent 工作流。目前支持的启动命令如下:
ori claude
ori codex
ori opencode
ori hermes
如果所选 Agent 尚未安装,Ori 会打印推荐的安装命令和该 Agent 的文档链接。请按照说明操作,然后重新运行相同的 ori <harness> 命令。
在 Ori 标志后传入用户常用的 Agent 参数。Ori 不处理的所有内容都会原样转发给 Agent。例如:
ori claude -p "Review the authentication changes"
ori codex --full-auto
ori opencode
5. 选择任意 OpenRouter 模型
使用 --model 指定任意有效的 OpenRouter 模型 ID:
ori claude --model claude-opus-latest
ori codex --model gpt-5.2
ori hermes --model gemini-3-pro
模型值会通过 OpenRouter 路由。请在 Ori 标志后保留用户现有的 Agent 参数。
6. 升级 Ori
使用以下命令升级已安装的版本:
ori update
然后再次验证当前版本:
ori --version
不要将在源代码检出目录中运行 ori update 当作安装已发布 CLI 的替代方案。
7. 确认设置正常
登录后,使用无害的提示词运行所选 Agent,以确认请求能够到达 OpenRouter:
ori claude --model openrouter/auto -p "Reply with exactly: Ori is connected"
如果用户选择了其他 Agent,请使用等效的 ori codex、ori opencode 或 ori hermes 命令。请确认 Agent 已启动、提示词已完成处理,并且已返回响应。如果 Agent 缺失、身份验证失败或模型 ID 被拒绝,请报告准确的命令输出,并先修复对应的设置问题,再确认安装成功。