1设置新 Key
打开 PowerShell,执行(把 新key 换成你的实际密钥,用英文单引号包住):
bookworm config set model.api_key '新key'
单引号可防止密钥中的特殊字符(如 $)被命令行误解析。
2验证是否生效
bookworm config show
查看「模型」一栏的 api_key 是否已变成新密钥,然后启动 bookworm 发一句话测试即可。
3其它方式(可选)
- 图形编辑:
bookworm config edit打开配置文件,修改model:块下的api_key:一行后保存。 - 重跑向导:
bookworm setup,按提示重新输入密钥。
⚠️ 遇到 400 报错?多半是这个原因
如果换 key 后请求报 400 Bad Request(看起来像服务器故障,其实是密钥被污染)——最常见的原因是:在远程桌面(ToDesk / 向日葵 / RDP)里没开剪贴板同步就按 Ctrl+V 粘贴密钥。
此时粘贴并没有生效,反而把 Ctrl+V 这个按键本身(一个不可见的控制字符)塞进了密钥字段,导致请求格式非法。
正确做法(远程操作时):
- 先在远程工具里开启剪贴板同步(复制
test123到远程能粘出来,才算通),再粘贴密钥; - 或直接手动键入密钥;
- 或用文件传输把密钥文本传到远程,再从文件读入。
本机(非远程)操作正常粘贴不受影响。
提示:两种「Key」别混淆
- API Key(本页所说):你自己的 AI 服务商密钥(BYOK),用
bookworm config set model.api_key设置。 - License Key:解密技能所需的授权密钥,通过环境变量
BOOKWORMPRO_LICENSE_KEY配置,请联系销售获取。