WorkBuddy 接入 Clawsocket API：自定义模型配置步骤
WorkBuddy 支持通过设置界面添加自定义模型。接入 Clawsocket 前，准备好 API Key 和控制台提供的 Model ID；WorkBuddy 的标准自定义协议使用 OpenAI Chat Completions 格式，因此本文按 /chat/completions 接口配置。
WorkBuddy 与 Clawsocket 分别管理自己的服务和计费。调用自定义模型时，WorkBuddy 会将请求发往所配置的模型服务，模型是否支持工具调用、图片输入和推理模式，取决于服务端及模型本身。请先阅读 WorkBuddy 官方模型配置说明，并在 Clawsocket 控制台确认当前可用配置。
获取 Clawsocket API 配置
在控制台准备以下三项：
- API Key：用于请求鉴权。
- Model ID：复制接口调用使用的准确名称。
- API Base URL：
https://api.clawsocket.com/v1。
如果 WorkBuddy 的自定义模型页面提供“API 格式”或“自定义 API”选项，选择兼容 OpenAI Chat Completions 的配置。若界面字段名称因版本不同而变化，以当前界面和 WorkBuddy 文档为准。
在 WorkBuddy 中添加模型
打开 WorkBuddy，进入“设置”中的“模型”页面。
在自定义模型区域选择“添加模型”，再选择“自定义”或“自定义 API”。
填写模型显示名称，例如
Clawsocket；显示名称只用于本地识别。填写 API Key，并选择或输入控制台给出的 Model ID。
配置请求地址与协议：
- 如果界面自动补全标准路径，填写 Base URL：
https://api.clawsocket.com/v1，保持“自定义协议”关闭。 - 如果打开“自定义协议”，填写完整地址：
https://api.clawsocket.com/v1/chat/completions。
- 如果界面自动补全标准路径，填写 Base URL：
保存后，在 WorkBuddy 对话界面的模型选择器中切换到刚添加的模型。
注意不要同时填写完整 endpoint 并开启自动拼接路径，否则可能生成重复的 /chat/completions。
验证连接
先发一条简短请求，确认模型选择器中的自定义模型能够正常回复。接着测试与你的用途相关的能力：如果准备让 WorkBuddy 处理代码或调用工具，检查对应能力开关，并用一个无破坏性的任务验证结果。
保存成功只表示 WorkBuddy 接受了配置；实际能否调用仍取决于 API Key、模型权限、Model ID 和请求协议是否匹配。
常见问题
请求返回 401
检查 API Key 是否复制完整，是否误用了 Clawsocket 登录密码或其他服务的密钥，并确认当前账户可访问所选模型。
请求返回 404
检查 URL 是否重复拼接 /v1 或 /chat/completions。自动补全模式填 Base URL；只有打开自定义协议时才填完整 endpoint。
聊天正常，但工具或图片不能用
Chat Completions 请求成功不代表每个模型都支持工具调用或图像输入。到 Clawsocket 控制台确认模型能力，再在 WorkBuddy 的模型设置中启用对应能力。
自定义模型保存了，但列表里找不到
检查模型是否已启用，并确认在对话的模型选择器中查看自定义模型分组。必要时重启 WorkBuddy 后重新选择模型。
配置前先分清四类信息
WorkBuddy 中的模型显示名称、API 模型 ID、请求地址和密钥承担不同作用。最容易出现的情况是把模型显示名称当成接口 ID，或把登录平台使用的密码当成 API Key。建议先在 Clawsocket 控制台整理一份不包含密钥的配置记录，再进入 WorkBuddy 填写。
| 配置项 | 应填写的内容 | 容易混淆的内容 |
|---|---|---|
| 展示名称 | 自己容易识别的名称 | 不决定服务端实际模型 |
| 模型 ID | 控制台的 API Model ID | 不等于宣传页上的系列名称 |
| 服务地址 | Base URL 或完整 endpoint | 取决于是否自动拼接路径 |
| API Key | Clawsocket 创建的调用凭据 | 不是 WorkBuddy 登录信息 |
| 能力设置 | 模型实际支持的能力 | 开启开关不会补上服务端能力 |
记录中还可以写明使用日期和协议选择。后续遇到模型列表变化时，先对照这份记录检查，而不是同时更换密钥、地址和模型。一次只调整一个因素，能明显减少重复尝试。
用办公任务检验接入结果
先做纯文本整理
第一轮可以给 WorkBuddy 一段自己编写的会议记录，要求按“已决定事项、待确认问题、负责人”整理，并明确没有写出的信息要标为未提供。这个任务不需要外部工具，便于确认模型能否正常回复、中文格式是否合适，以及有没有自行补出不存在的负责人或日期。
回答内容合理后，再查看当前对话确实选择了 Clawsocket 自定义模型。只在设置里添加模型，却继续使用默认模型，不能证明自定义接口已经运行。若产品界面展示请求信息，可结合界面与 Clawsocket 的用量记录核对，但不要公开包含密钥的截图。
再处理本地文件
准备一份可以分享的测试文件，让 WorkBuddy 读取后提取标题、日期或指定字段。检查它是否引用了原文，遇到空白项有没有说明缺失。这个步骤主要观察文件处理与模型回答的衔接，不应把私人合同或真实客户资料作为第一份测试材料。
文件内容较长时，可以先指定页码、章节或字段范围。若只需要比对合同中的付款条款，就先让它定位相关部分，而不是要求一次处理所有附件。这样既便于检查遗漏，也能减少不必要的上下文输入。
最后测试工具与连续任务
如果计划使用 WorkBuddy 调用工具或生成文件，验证时应覆盖完整过程：理解要求、读取材料、调用工具、检查输出。普通聊天成功不代表这些环节都兼容。遇到中断时，记录中断发生在哪一步，这比笼统说“自定义模型不能用”更有助于定位问题。
| 场景 | 测试方法 | 人工检查重点 |
|---|---|---|
| 会议纪要 | 按原文整理决定与待办 | 是否编造负责人和日期 |
| 文档提取 | 指定章节提取字段 | 是否漏项或引用错误 |
| 内容改写 | 保留事实调整语气 | 是否改变确定程度 |
| 工具任务 | 生成并检查小文件 | 文件是否存在、内容是否正确 |
任务说明怎样写才容易复查
面向办公内容，可以先说明材料来源，再给出输出格式和不能改动的事实。例如“根据下方记录整理周报，保留原有数字，未说明完成状态的事项列入待确认”。这类要求比“写一份专业周报”更容易验收，也能减少模型用套话填补信息缺口。
如果想让 WorkBuddy 先给方案，可以明确分两步执行：先列需要的数据和处理方式，得到确认后再生成最终文件。对需要发送、发布或覆盖原文件的任务，还应区分准备工作和最终动作。模型接入方式变了，任务权限与业务审批仍然要按原流程执行。
对于反复使用的任务，保存一份去掉敏感资料的模板。模板应记录字段含义、缺失信息的处理方式和结果检查标准，而不是堆积“准确、全面、专业”等形容词。每次更换模型后用同一组样例试跑，观察格式是否保持一致。
从报错到解决：按顺序检查
如果连第一条文本都失败，先检查 Key、模型 ID 和最终请求地址。鉴权问题解决前，不必调整图片能力或工具选项。若提示接口不存在，重点检查自定义协议开关与完整地址是否配套；若提示模型不可用，核对模型权限及 ID 的版本后缀。
如果短任务正常、长任务失败，再缩小材料范围，检查是否只有某种文件或某个工具触发错误。长任务失败可能涉及上下文、客户端超时或服务端限制，不能只凭一次失败认定模型能力不足。保留错误发生的时间、任务阶段及脱敏错误文本，便于进一步排查。
使用一段时间后，再根据实际用量调整任务拆分方式。Clawsocket 的调用费用应以控制台记录为准，WorkBuddy 自身的订阅和第三方模型费用需要分别确认。不要把接口接通理解成免费额度通用，也不要在缺少实际统计时承诺固定的任务成本。