mcpField
I
install-ori-harness

install-ori-harness

github.com/openrouterteamAgent 工作流309154 次安装1 天前更新
代码仓库

关于 install-ori-harness

install-ori-harness 是指导安装和使用 Ori 的 Agent 技能,面向希望通过 Ori 运行现有编码 Agent 的用户。内容涵盖 OpenRouter OAuth 登录、模型选择和升级,同时保留原有 Agent 命令与参数。

主要功能

  1. 01安装并验证 Ori 命令行
  2. 02通过 OpenRouter OAuth 登录
  3. 03运行现有编码 Agent
  4. 04选择 OpenRouter 模型
  5. 05升级 Ori

适用场景

  1. 01首次安装并配置 Ori
  2. 02通过 Ori 启动现有 Agent
  3. 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 被拒绝,请报告准确的命令输出,并先修复对应的设置问题,再确认安装成功。

评论

支持 Markdown