服务商

OpenRouter

Agent 怎样通过 KeyKeeper 拿到 OpenRouter 的 key,在 openrouter.ai 该选什么,KeyKeeper 怎么验证。

模板 idopenrouter(别名 open-router)
字段openrouter-api-key → OPENROUTER_API_KEY · 密钥
key 长什么样创建时只显示一次
创建页面openrouter.ai
KeyKeeper 的验证GET https://openrouter.ai/api/v1/key——reads this key's limits and usage
模板核实日期2026-09-15

Agent 做什么

keykeeper providers show openrouter
keykeeper save --provider openrouter --from-clipboard --create --purpose "这个任务是做什么的"
keykeeper run -c openrouter -- <你的命令>

--provider openrouter 会补上凭据 ID 和字段名。这些环境变量就是 OpenRouter 自家工具读的那个,不需要任何映射。

只有你能做的

Sign in to OpenRouter
Choose the workspace
Set a credit limit and optional expiration
复制 key,然后在 KeyKeeper 的窗口里确认保存。

该选什么

Create a separate key for this project with the lowest practical credit limit and an expiration.

Agent 被告知的是同一件事。它替你打开页面、说明该选什么;它从不替你登录、过 2FA 或付费。

KeyKeeper 检查什么

  • 写入前: 值必须像一把 OpenRouter 的 key(没有形状规则)。贴错了会在存入之前被拒绝,并告诉 Agent 原因——不含值。
  • 保存后: KeyKeeper 自己发送 GET https://openrouter.ai/api/v1/key,key 放在 Authorization 请求头里(reads this key's limits and usage)。Agent 收到的是「接受」「拒绝」或「联系不上」——从不是值。

接入地址

这把 key 是下面这些地址的 bearer token。keykeeper run 只设置上面的环境变量,base URL 要你自己在客户端里指。

  • OpenAI——https://openrouter.ai/api/v1

轮换与过期

No universal expiry policy was confirmed for this credential type. Record the date shown by the provider, or leave it unknown. 在 openrouter.ai 轮换或撤销。