Chatbox 第三方 API 配置教程：OpenAI-compatible 与 ClawSocket 接入指南

Chatbox 接入第三方 API 的核心思路很简单：在设置里新增一个自定义模型提供方，选择 OpenAI API Compatible，然后填入 API Key、API Host、API Path 和模型名。

如果你准备使用 api.clawsocket.com，可以把 Chatbox 当成一个 OpenAI-compatible 客户端来配置。这样做的好处是，Chatbox 里不只可以接一个模型，还可以把 GPT、Claude、Gemini、Grok 等模型入口尽量统一到一套 API 网关里。

Chatbox 的第三方 API 接入，本质是把模型提供方配置成 OpenAI-compatible 服务。

快速结论

• Chatbox 官方文档支持添加自定义模型提供方。
• 第三方 API 通常选择 OpenAI API Compatible。
• 官方文档说明，API Path 默认可以使用 /v1/chat/completions。
• 使用 ClawSocket 时，API Host 可以填 https://api.clawsocket.com。
• 如果你的 Chatbox 版本显示的是 Base URL，则优先填 https://api.clawsocket.com/v1。
• 模型名不要凭空猜，要以 ClawSocket 控制台当前可用模型 ID 为准。

Chatbox 第三方 API 配置入口在哪里

按 Chatbox 官方文档的配置路径，通常在这里：

1. 打开 Chatbox。
2. 进入 Settings 或 设置。
3. 找到 Model Provider 或 模型提供方。
4. 点击 Add 或 添加。
5. 选择 OpenAI API Compatible。
6. 填写 API Key、API Host、API Path 和模型名。
7. 点击 Check 检查连接。
8. 保存配置，并在聊天窗口选择对应模型。

不同版本的 Chatbox 界面文案可能略有差异，但配置逻辑基本一致：先新增提供方，再填连接参数，最后检查连接。

使用 ClawSocket 时怎么填写

如果你使用 ClawSocket，可以参考下面这组配置：

配置项	推荐填写
Provider Name	ClawSocket
API Mode	OpenAI API Compatible
API Key	你在 ClawSocket 控制台获取的 Key
API Host	https://api.clawsocket.com
API Path	/v1/chat/completions
Model	控制台当前可用的模型 ID

如果你的 Chatbox 版本不是分开填写 API Host 和 API Path，而是只显示 API Base URL，则可以改成：

API Base URL: https://api.clawsocket.com/v1

关键点是不要同时重复拼接路径。例如，有的版本需要填 https://api.clawsocket.com 加 /v1/chat/completions；有的版本只需要填 https://api.clawsocket.com/v1。如果你把 /v1 或 /chat/completions 重复填两次，就容易出现连接失败。

Chatbox 接入 ClawSocket 的三步：获取 Key、新增 Provider、检查连接。

第一步：在 ClawSocket 获取 API Key

打开：

• https://api.clawsocket.com

登录控制台后，进入和 API Key、令牌或模型调用相关的页面，创建或复制自己的 Key。后台入口可能随版本调整，具体按钮名称以控制台当前展示为准。

拿到 Key 后，不建议截图发给别人，也不要写进公开文档或公开仓库。Chatbox 是本地客户端，但 API Key 仍然属于敏感凭据，应按项目和设备妥善管理。

第二步：在 Chatbox 新增 OpenAI-compatible Provider

进入 Chatbox 设置后，新增模型提供方。这里建议这样命名：

Provider Name: ClawSocket

API 类型选择：

OpenAI API Compatible

然后填入：

API Key: 你的 ClawSocket API Key
API Host: https://api.clawsocket.com
API Path: /v1/chat/completions

如果是 Base URL 模式：

API Base URL: https://api.clawsocket.com/v1

第三步：填写模型 ID

模型 ID 必须以控制台可用列表为准。不要直接复制旧教程里的模型名，因为模型上下架、命名方式和路由规则都可能变化。

更稳的做法是：

1. 在 ClawSocket 控制台查看当前可用模型。
2. 复制你要使用的模型 ID。
3. 粘贴到 Chatbox 的模型配置里。
4. 保存后用 Check 测试。

如果你不确定先用哪个模型，可以先选择一个文本对话模型跑通连接，再根据速度、成本和输出质量切换。

第四步：点击 Check 检查连接

Chatbox 官方文档提到，配置完成后可以使用 Check 检查模型提供方是否可用。

如果检查通过，说明至少这几项大概率没问题：

• API Key 能被识别。
• API Host 或 Base URL 能访问。
• API Path 没有明显拼错。
• 模型 ID 可以被当前服务识别。

如果检查失败，不要急着重装 Chatbox，先按下面的排查清单检查。

常见错误排查

1. API Host 和 Base URL 填混了

这是最常见的问题。

如果界面要求填 API Host，通常填：

https://api.clawsocket.com

如果界面要求填 API Base URL，通常填：

https://api.clawsocket.com/v1

不要在同一个配置里重复加两次 /v1。

2. API Path 多写或少写

Chatbox 官方文档里 OpenAI-compatible 的默认 API path 是：

/v1/chat/completions

如果你的界面已经通过 Base URL 包含了 /v1，再单独写 path 时要确认最终请求不会变成 /v1/v1/chat/completions。

3. 模型名不对

第三方 API 失败时，很多人第一反应是 Key 错了。实际上，模型名写错也很常见。

建议直接从 ClawSocket 控制台复制模型 ID，避免手打。

4. Key 复制时多了空格

复制 API Key 时，前后多一个空格也可能导致鉴权失败。建议重新复制一次，粘贴后确认没有换行、空格或引号。

5. 当前网络或客户端版本问题

如果 Key、Host、Path、Model 都确认没问题，但仍然失败，可以尝试：

• 升级 Chatbox 到新版本。
• 重启 Chatbox。
• 换一个模型测试。
• 用 curl 或 SDK 单独测试 ClawSocket 接口。

Chatbox 适合接哪些第三方 API

Chatbox 适合接入支持 OpenAI-compatible 的服务。对开发者来说，重点不是“界面里能不能多填一个地址”，而是这套地址能否长期稳定维护：

• 是否有明确的 API Key 管理方式
• 是否有可查看的模型列表
• 是否支持常用对话接口
• 是否方便切换模型
• 是否能和你已有的 SDK、工具和团队流程兼容

这也是为什么用 ClawSocket 这类统一 API 网关更省事。你可以先把 Chatbox 配通，再把同一套思路延展到 Codex、Claude Code、OpenClaw、Cline 或后端服务里。

Chatbox + ClawSocket 配置模板

如果你只想快速复制配置，可以按这个模板检查：

Provider Name: ClawSocket
Provider Type: OpenAI API Compatible
API Key: sk-xxxxxxxx
API Host: https://api.clawsocket.com
API Path: /v1/chat/completions
Model: 以 ClawSocket 控制台为准

如果是 Base URL 模式：

Provider Name: ClawSocket
Provider Type: OpenAI API Compatible
API Key: sk-xxxxxxxx
API Base URL: https://api.clawsocket.com/v1
Model: 以 ClawSocket 控制台为准

FAQ

Chatbox 支持第三方 API 吗？

支持。Chatbox 官方文档提供了自定义模型提供方配置方式，并支持 OpenAI API compatible 类型。

Chatbox 接 ClawSocket 要填哪个地址？

如果是 API Host，填 https://api.clawsocket.com。如果是 API Base URL，填 https://api.clawsocket.com/v1。具体取决于你当前 Chatbox 版本的表单字段。

API Path 填什么？

OpenAI-compatible 对话接口通常使用 /v1/chat/completions。如果 Chatbox 版本已经内置默认 path，可以先保留默认值，不要重复添加。

模型 ID 从哪里来？

从 api.clawsocket.com 控制台查看并复制。不要随便猜模型名。

配好以后还是失败怎么办？

优先检查 API Key、API Host/Base URL、API Path、模型 ID 四项。再确认是否重复拼接 /v1，以及 Key 前后是否有空格。

参考资料

• Chatbox 官方模型提供方文档
• Chatbox OpenAI Compatible API 文档
• ClawSocket 控制台