用途:该技能用于在 AgentBox 实例上把 OpenRouter 配置为 LLM 提供方。OpenRouter 通过单个 API Key 提供 Anthropic、OpenAI、Google、Meta 等厂商的模型访问。当用户想使用 OpenRouter 上的模型、询问配置其他 LLM 提供方、提到 OpenRouter,或需要访问默认 blockrun 提供方之外的模型时使用。
主要能力与流程:
- 检查账号:询问是否已有 OpenRouter 账号;没有则引导访问 https://openrouter.ai 注册(支持 Google/GitHub 登录),再到 https://openrouter.ai/keys 点击 Create Key,复制以 sk-or- 开头的密钥。
- 获取 API Key:要求用户提供以 sk-or- 开头的密钥。
- 选择模型:若用户已指定则沿用;否则推荐 openrouter/anthropic/claude-sonnet-4-5,其他可选 openrouter/anthropic/claude-opus-4-6、openrouter/openai/gpt-4o、openrouter/google/gemini-2.5-pro 等。
- 配置 OpenClaw:先用 cat ~/.openclaw/openclaw.json 读取当前配置,再用 jq 写入 env.OPENROUTER_API_KEY 与 agents.defaults.model.primary 两个字段,然后写回。必须读取完整配置后再修改,不可写入不完整配置。
- 重启网关:执行 openclaw gateway restart,等待数秒后用 openclaw status 验证。
- 确认:告知用户默认模型已设置,建议发送测试消息验证。
模型引用格式为 openrouter/<provider>/<model>,完整列表见 https://openrouter.ai/models。后续切换模型时可不重输密钥,仅用 jq 更新 agents.defaults.model.primary 并执行 openclaw gateway restart。
限制与排错:Invalid API key 需确认密钥以 sk-or- 开头且 https://openrouter.ai/credits 有余额;模型无响应可能是该模型在 OpenRouter 上不可用或故障;配置损坏通常是 JSON 格式错误,可用 cat ~/.openclaw/openclaw.json | jq . 检查;配置改动后必须执行 openclaw gateway restart 才生效。费用、价格与具体配额暂未提供。