返回文档首页
更多客户端
这一页汇总 OpenClaw、Hermes Agent、Cursor、Windsurf 和 Cherry Studio 的接入要点。它们大多支持 OpenAI Compatible 或自定义 Provider，核心字段仍然是 Base URL、API Key 和 Model。
OpenClaw
| 项目 | 填写建议 |
|---|---|
| Provider | 自定义 OpenAI Compatible |
| Base URL | /v1 |
| API Key | qimoq API Key |
| Model | GPT / Codex 或 Claude 模型 ID，按客户端支持情况选择 |
OpenClaw 如果同时支持多种模型类型，建议按用途创建多个 Provider，避免一个 Key 同时跑多类模型导致排查困难。
Hermes Agent
Hermes Agent 通常通过自定义端点接入：
- 新增自定义 Provider。
- Base URL 填
/v1。 - API Key 填完整 qimoq Key。
- 模型 ID 从「模型广场」复制。
- 保存后发起一次短任务验证。
如果 Hermes 支持 Provider 切换，确认当前任务使用的是 qimoq Provider。
Cursor
Cursor 可通过自定义 OpenAI Provider 接入 GPT / Codex 类模型：
| 字段 | 填写 |
|---|---|
| OpenAI API Key | qimoq API Key |
| Override OpenAI Base URL | /v1 |
| Model | 从「模型广场」复制 |
如需 Claude 模型，先确认当前 Cursor 版本是否允许自定义 Claude 兼容端点。不可配置时，建议改用 Claude Code 或 VS Code 扩展路线。
Windsurf
Windsurf 的自定义模型能力会随版本变化。优先路线是：
- 使用 Codex IDE 扩展路线接入 GPT / Codex 模型。
- 或使用 Claude Code VS Code 扩展路线接入 Claude 模型。
- 如果当前版本支持自定义 OpenAI Base URL，再填写
/v1和 qimoq Key。
遇到入口缺失时，不要强行照搬其它客户端配置，先确认 Windsurf 当前版本是否开放对应设置。
Cherry Studio
Cherry Studio 适合把多个 qimoq Provider 放在同一个聊天应用里切换：
| Provider | Base URL | 用途 |
|---|---|---|
| qimoq GPT | /v1 | GPT / Codex 聊天或代码 |
| qimoq Claude | /v1 | Claude 聊天 |
| qimoq Image | /v1 | 生图模型，按模型广场名称填写 |
建议每个模型类型使用独立 Key。这样一旦费用异常，可以直接从「使用日志」按 Key 筛选。
排查
| 现象 | 处理 |
|---|---|
| 客户端没有 OpenAI Compatible 入口 | 找 Custom Provider、OpenAI Base URL 或 API Host 设置 |
| 保存后仍走旧服务 | 检查当前会话是否选中了 qimoq Provider |
| Claude / Gemini 不可用 | 确认客户端是否真的支持自定义 Claude / Gemini Endpoint |
| 消费无法对应 | 为不同客户端创建不同 Key，再按 Key 查日志 |