❇️ OpenWorker 接入胜算云API文档

5 分钟照抄搞定。看完前面五步就够, 后面是可跳过的错误清单和原理。

本文适用于 macOS。整个过程不需要碰 OpenWorker 的图形界面, 只需要手动写两个 JSON 文件。

第 0 步: 准备两样东西

你要的东西	长什么样	在哪找
胜算云 API Key	一串 50 字符左右的字母和数字	胜算云控制台 → API Key 管理
模型 ID	像 `deepseek/deepseek-v4-pro` 这种字符串	模型列表

先把这俩复制到一个地方备用, 后面要粘到 JSON 里。

第 1 步: 完全退出 OpenWorker

必须先退出, 否则你改完的文件会被应用启动时覆盖。

顶部菜单栏 → OpenWorker → Quit OpenWorker (或按 Command + Q)

第 2 步: 打开配置目录

配置目录在:

~/.config/coworker

打开方式: Finder → Command + Shift + G → 粘贴上面的路径 → 回车。

第 3 步: 创建 `secrets.json`

secrets.json 第一次配置时还不存在, 需要手动新建。下面两种方法选一种即可。

方法 A: 用终端 (最快)

打开"终端" (启动台里搜"终端"或"Terminal" 即可找到)

输入下面这条命令并回车, 在配置目录里创建一个空文件:

再输入一条命令, 用 TextEdit 打开它:

文件打开后, 立刻按 Command + Shift + T 切到纯文本模式 (重要! 不然保存时会变成 .rtf)

方法 B: 纯图形界面 (完全不用终端)

打开 TextEdit (启动台里搜"文本编辑")

按 Command + N 新建一个空文档

立刻按 Command + Shift + T 切到纯文本模式 (重要! 不然保存时会变成 .rtf)

暂时放着, 接下来按下面的步骤写入内容

写入内容

不管用方法 A 还是 B, 文件打开后, 把下面这段原样粘进去:

{
  "provider:openai": {
    "type": "api_key",
    "api_key": "替换成你的胜算云 API Key",
    "base_url": "https://router.shengsuanyun.com/api/v1"
  }
}

把 "替换成你的胜算云 API Key" 这一整段 (包括两侧的双引号) 替换成你第 0 步准备好的真实 Key。

保存

按 Command + S 保存:

如果 TextEdit 弹窗询问"使用 .json 扩展名吗?", 选"使用 .json"

确认文件最终保存在 ~/.config/coworker/ 目录下, 文件名是 secrets.json (没有 .txt 后缀)

三个细节不能错

api_key 只填 Key 本身, 不要加 Bearer 前缀

base_url 末尾到 /v1 就停, 不要写到 /chat/completions

顶层的键名是 provider:openai, 中间是英文冒号, 不能漏

编辑器建议

如果电脑里装了 VS Code、Sublime Text 或 TextMate, 推荐直接用, 不会遇到 TextEdit 的富文本陷阱:

VS Code: 在终端执行 code ~/.config/coworker/secrets.json

Sublime Text: 在终端执行 subl ~/.config/coworker/secrets.json

TextMate: 在终端执行 mate ~/.config/coworker/secrets.json

第 4 步: 写 `prefs.json`

在同一个目录下, 再新建一个 prefs.json, 内容如下 (默认只有一个模型):

{
  "onboarded": true,
  "models": [
    "deepseek/deepseek-v4-pro"
  ],
  "default_model": "deepseek/deepseek-v4-pro"
}

想一次配多个模型?

把更多模型 ID 加进 models 数组, 并挑一个作为 default_model 即可:

{
  "onboarded": true,
  "models": [
    "deepseek/deepseek-v4-pro",
    "moonshot/kimi-k3",
    "bigmodel/glm-5.2"
  ],
  "default_model": "deepseek/deepseek-v4-pro"
}

这个例子的效果:

模型选择器里会出现 3 个选项: deepseek/deepseek-v4-pro、moonshot/kimi-k3、bigmodel/glm-5.2

启动新会话时默认使用 deepseek/deepseek-v4-pro

想换默认模型, 把 default_model 那一行换成 models 数组里的任意一个即可

格式要点:

数组里的多个模型名用英文逗号分隔, 最后一个元素后面不加逗号

所有模型名必须以胜算云控制台实际显示的为准 (大小写、斜杠、连字符都不能差)

第 5 步: 重启 OpenWorker 并测试

重新打开 OpenWorker

在模型选择器里看到 deepseek/deepseek-v4-pro 就对了

发送一条消息:

请回复: ok

收到回复 = 配置成功

常见错误 (按出现频率排序)

1. 改了没生效 / 提示模型列表为空

按顺序检查:

OpenWorker 是否真的退出了 (看 Dock 上的应用图标是否还有小圆点)

文件扩展名是不是真的叫 .json (如果用了"文本编辑", 可能被保存成了 .rtf)

JSON 内容是否合法 (双引号、没有中文逗号、末尾没多余逗号), 不确定就把内容粘到 https://json.cn 验一下

prefs.json 里 models 数组和 default_model 字段都填了

2. 提示 401 / Unauthorized / API Key 无效

Key 是不是复制完整了, 前后没有空格或换行

用的是不是胜算云的 Key, 而不是 OpenAI 或 OpenRouter 的 Key

api_key 字段里有没有误加了 Bearer 前缀 (不需要, OpenWorker 会自动加)

3. 提示模型不存在

prefs.json 里的模型名拼错了。胜算云控制台里怎么显示的就怎么写, 一个字符都不能差。

4. 提示 404 / 请求地址错误

base_url 写错了。正确值是:

https://router.shengsuanyun.com/api/v1

常见的错误写法: 多写了 /chat/completions 后缀, 或者把 OpenRouter 的地址写到这里。

进阶 (可跳过)

OpenWorker 内部用 OpenAI 官方的 SDK 调用大模型, SDK 接收一个 base_url 后会自动在末尾拼 /chat/completions。胜算云官方提供的 OpenAI 兼容聊天接口是:

POST https://router.shengsuanyun.com/api/v1/chat/completions

所以 base_url 填到 /v1 就刚好, SDK 会替我们拼好后缀。

❇️ OpenWorker 接入胜算云API文档

第 0 步: 准备两样东西#

第 1 步: 完全退出 OpenWorker#

第 2 步: 打开配置目录#

第 3 步: 创建 secrets.json#

方法 A: 用终端 (最快)#

方法 B: 纯图形界面 (完全不用终端)#

写入内容#

保存#

三个细节不能错#

编辑器建议#

第 4 步: 写 prefs.json#

想一次配多个模型?#

第 5 步: 重启 OpenWorker 并测试#

常见错误 (按出现频率排序)#

1. 改了没生效 / 提示模型列表为空#

2. 提示 401 / Unauthorized / API Key 无效#

3. 提示模型不存在#

4. 提示 404 / 请求地址错误#

进阶 (可跳过)#