Agent 配置教程

在 Hermes Desktop、Kilo Code（VS Code / Cursor 扩展）、OpenClaw、OpenCode Desktop 等 Agent 中，用 APIMaster.ai 的 OpenAI 兼容 Key 与模型 ID 接入上游 LLM。

建议先 获取 API Key。发消息失败时可使用 API 连通性测试 辅助排查。

目录

文档	说明
Hermes Desktop	Windows / macOS：.env 写 Key、Base URL，设置里选模型
Kilo Code	VS Code / Cursor：Providers 添加 Custom provider，图形界面选模型
OpenClaw	本地 Agent 平台：openclaw onboard 选 Custom Provider，网页对话
OpenCode	OpenCode Desktop：设置 → 提供商 → 自定义提供商，图形界面选模型
Claude Code Desktop	桌面 App：Developer Mode → 第三方推理网关 → Code 模式对话
Pi Coding Agent	终端 Agent：~/.pi/agent/models.json + APIMaster provider
Cline	VS Code / Cursor：OpenAI Compatible + Model ID
Codex Desktop	官方订阅 ↔ APIMaster：codex-provider-switcher + 历史同步

与 CLI / 编辑器教程的区别

类型	位置	场景
CLI 配置教程	Claude Code、Codex 等	终端命令行
API 接入教程	Cursor 内置模型设置等	编辑器直连
本节	Hermes、Kilo、OpenClaw、OpenCode、Pi 等 Agent	桌面、扩展、终端或本地 Agent 内配置 Provider / 模型

通用要点

• Base URL（OpenAI 兼容）：https://apimaster.ai/v1（末尾 /v1 不要漏）
• API Key：来自 控制台
• 模型 ID：与 模型广场 一致，如 gpt-5.4、claude-sonnet-4-6

各 Agent 的具体点击路径见上表分篇教程。