WorkBuddy 自定义模型接入教程(腾讯)

WorkBuddy 是腾讯推出的桌面 AI 智能体(和 CodeBuddy 同一个团队)。在设置里添加一个「自定义 API」模型,就能让它用 TokenMilo 的 Claude 和 GPT 帮你处理文档、表格和各种办公任务。

更新于 2026-11-16

一、准备 API Key

在 TokenMilo 控制台注册并充值,到「API 密钥」页面创建一个 Key(以 sk- 开头)。

二、添加自定义模型

  1. 打开 WorkBuddy,点左下角头像 → 设置 → 模型。
  2. 点 添加模型,接入方式选 自定义 API。
  3. 按下表填写,勾选工具调用,点测试连接,通过后保存。
字段填写内容
接口地址https://api.tokenmilo.com/v1
API Key你的 TokenMilo Key
模型名称claude-sonnet-5-5(也可以填 claude-opus-5-5、gpt-6.1-sol)
能力勾选「工具调用」

想同时用多个模型,就重复添加几次,每次换一个模型名。保存后在对话框的模型选择里切换到它即可。

不同版本的按钮文字可能略有差别,找「模型」或「自定义模型」相关的设置即可。

三、用配置文件添加(可选)

也可以直接编辑用户目录下 WorkBuddy 的 models.json(通常在 ~/.workbuddy/ 文件夹里),注意这里要写完整的 /chat/completions 地址:

{
  "models": [
    {
      "id": "claude-sonnet-5-5",
      "name": "Claude Sonnet 5.5(TokenMilo)",
      "vendor": "TokenMilo",
      "url": "https://api.tokenmilo.com/v1/chat/completions",
      "apiKey": "sk-你的TokenMilo密钥",
      "supportsToolCall": true,
      "supportsImages": false
    }
  ]
}

改完重启 WorkBuddy。

四、选哪个模型?

  • 日常办公、写文档、做表格:claude-sonnet-5-5,速度和效果均衡。
  • 复杂任务、长文分析:claude-opus-5-5。
  • 想用 GPT:gpt-6.1-sol。

全部模型和价格见模型列表,每次用量可以在控制台「使用日志」查看。

常见问题

WorkBuddy 自定义模型要付费吗?

用自己的 API Key 时按 TokenMilo 的用量计费,不消耗 WorkBuddy 的积分。

接口地址填哪个?

默认情况下填 https://api.tokenmilo.com/v1 即可,WorkBuddy 会自己补 /chat/completions。如果打开了「自定义协议」开关或手动写配置文件,要填完整地址 https://api.tokenmilo.com/v1/chat/completions,末尾不要加斜杠。

能用 Claude 吗?WorkBuddy 不是只支持 OpenAI 协议吗?

WorkBuddy 的自定义 API 走 OpenAI 兼容协议,TokenMilo 会把 Claude 模型自动转换成 OpenAI 格式,所以模型名直接填 claude-sonnet-5-5 就能用。

模型是灰色的 / 报 4100?

说明接口地址或 Key 没填完整,重新编辑模型补全即可。

执行任务时什么都不做或报错?

添加模型时要勾选「工具调用」,WorkBuddy 的智能体任务依赖工具调用。

发图片或 PDF 报 400?

部分版本的自定义模型只支持文字输入,可以在模型设置里勾选「图片输入」再试;仍不行就先用文字描述。

企业版里看不到自定义模型?

企业管理员可能关闭了自定义模型,需要管理员在后台「AI 资源管理 → 模型管理」里新增(选标准 OpenAI 协议)。

相关教程

还没有 API Key?

在 TokenMilo 注册、充值,一分钟内就能在控制台创建 Key。

获取 API Key 查看全部模型