WorkBuddy 如何接入第三方 API
WorkBuddy 适合把“写代码、查资料、执行重复操作”集中到一个工作区里。它的模型调用本质上仍然是 HTTP API：客户端需要一个 API Key、一个接口地址和一个模型名。如果你已经有 ClawSocket 账号，可以使用它的 OpenAI 兼容入口接入，不必为不同模型分别改一套业务配置。
先确认版本与入口
WorkBuddy 的菜单名称会随版本变化，常见入口是 Settings / 设置 → Models、Providers 或 AI 服务商。如果你看到了 OpenAI-compatible、Custom provider 或“自定义模型”，选择这一项；如果只看到环境变量说明，则按本文后面的终端方式配置。
不要把 Key 写在项目代码里。先在 ClawSocket 控制台创建一个专用 Key，再在 WorkBuddy 的设置页面填写：
| 配置项 | 填写内容 |
|---|---|
| Provider | OpenAI Compatible / Custom |
| Base URL | https://api.clawsocket.com/v1 |
| API Key | ClawSocket 控制台生成的 Key |
| Model | 例如 gpt-5、claude-opus-4-1 或 deepseek-v4 |
有些版本会要求完整的 /chat/completions 路径，有些版本只接受 /v1。优先按照输入框旁的示例填写，遇到 404 时只检查这一级路径，不要同时修改模型名和 Key。
用环境变量配置
如果 WorkBuddy 是从终端启动的，可以先设置兼容 OpenAI SDK 的变量：
export OPENAI_API_KEY="你的 ClawSocket Key"
export OPENAI_BASE_URL="https://api.clawsocket.com/v1"然后从同一个终端启动 WorkBuddy。macOS 和 Linux 可以把变量放进 shell 的本地配置文件；团队项目不要把包含真实 Key 的文件提交到 Git。Windows PowerShell 对应写法是：
$env:OPENAI_API_KEY = "你的 ClawSocket Key"
$env:OPENAI_BASE_URL = "https://api.clawsocket.com/v1"第一次调用怎么验证
先选一个成本较低、响应快的模型发送简单请求，确认三件事：能返回文本、流式输出没有卡住、控制台能看到请求记录。不要一开始就用长文档或工具调用测试，因为那会把网络问题、上下文限制和权限问题混在一起。
如果 WorkBuddy 提示模型不存在，先到 ClawSocket 控制台复制实际的模型 ID。显示名称可能是 Claude Opus 4.1，而 API ID 可能是 claude-opus-4-1，两者不一定相同。
常见问题
401 Unauthorized：Key 无效、复制时带入空格，或 Key 属于另一个环境。重新生成一个项目专用 Key 并重启 WorkBuddy。
404 Not Found：Base URL 多写或少写了路径。ClawSocket 的 OpenAI 兼容地址是 https://api.clawsocket.com/v1。
模型返回空白：检查 WorkBuddy 是否启用了“仅流式输出”，并确认客户端支持 SSE；先关闭流式选项测试普通响应。
请求很慢：换一个更快的模型、缩短系统提示词，并确认没有在客户端重复重试。429 错误应使用指数退避，而不是瞬间并发发送更多请求。
安全建议
WorkBuddy 可能会读取工作区文件和执行命令。第三方 API Key 只应授予必要额度，最好按个人、项目和环境分别创建，并开启用量上限。更多 Key 轮换和审计建议可参考生产环境的 Key 管理。
ClawSocket 的统一入口适合在 WorkBuddy 中快速切换模型，但最终的权限边界仍由你的客户端和项目设置决定。完成配置后，可以从模型选择指南开始为不同任务建立自己的模型组合。
配置检查表
| 检查项 | 正确状态 | 失败时先看哪里 |
|---|---|---|
| 地址 | https://api.clawsocket.com/v1 | 是否多写 /chat/completions |
| 鉴权 | Key 来自当前 ClawSocket 项目 | 是否复制了空格或旧 Key |
| 模型 | 使用控制台实际 API ID | 展示名和 ID 是否不同 |
| 权限 | 仅授予所需额度 | 是否触发每日限额 |
FAQ
WorkBuddy 能直接使用 ClawSocket 吗？
只要当前版本提供 OpenAI Compatible、Custom Provider 或自定义模型入口，就可以配置。若版本没有该入口，使用环境变量方式，或升级到支持自定义服务商的版本。
为什么设置了 Base URL 仍然 404？
不同客户端对 Base URL 的要求不同。ClawSocket 的标准入口是 https://api.clawsocket.com/v1；不要把完整请求路径再次拼到末尾，也不要同时填写两个 Base URL。
WorkBuddy 的 Key 会不会泄露？
不要把 Key 放进工作区文件或截图。使用项目专用 Key、每日额度和定期轮换，并在 ClawSocket 控制台检查异常用量。
应该先选哪个模型测试？
先用响应快、成本低的模型测试普通文本请求，再根据代码、长文或推理任务切换模型。确认 API ID 后再开启自动化操作。