跳转到主内容
新派编程网 - 新潮编程理念,全新技术课堂!

详解 WorkBuddy 在 Windows 系统下的 API 环境变量配置

必须用系统级环境变量,因为临时命令行设置在进程退出后失效,导致技能调用时报 KeyError;Client ID 和 API Key 需从IMA控制台复制、严格配对、区分环境,并通过图形界面设为用户变量后重启客户端。 ☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜ 为什么必须用系统级 环境变量 而不是临时 set WorkBuddy 启动时只读取系统或用户级环境变量,
set CLIENT_ID=xxx
这种命令行临时设置在进程退出后就失效,技能调用时会直接报
KeyError: 'CLIENT_ID'
。Windows 上只有写入注册表的用户变量(或系统变量)才能被桌面应用稳定读取。 Client ID 和 Api Key 必须配对且大小写敏感 从
https://ima.qq.com/agent-interface
复制的值里,常见错误是: • 复制了带空格或换行的字符串(尤其 Api Key 结尾有不可见字符) • 把 Client ID 当成 Api Key,或反过来 • 混用了测试环境和正式环境的凭证(IMA 控制台右上角会显示环境标签) 验证方式:在 PowerShell 中运行
echo $env:CLIENT_ID
和
echo $env:API_KEY
,输出应为纯字符串、无引号、无前后空格。 Windows 设置环境变量的实操要点 必须用「系统属性 → 高级 → 环境变量」图形界面操作,不能只靠命令行: • 在「用户变量」区域点击「新建」,变量名严格为
CLIENT_ID
和
API_KEY
(不是
client_id
或
ima_client_id
) • 值字段粘贴时右键选择「选择性粘贴」→「无格式文本」,避免带入富文本样式 • 设置完必须重启 WorkBuddy 桌面客户端(不是仅关闭窗口,要从任务栏右键退出) • 若已配置但不生效,检查是否误设在「系统变量」而非「用户变量」——WorkBuddy 默认只读用户变量 Trae win Trae Windows 官方版本现已全面支持 Win10 和 Win11 系统(64位)。国内开发者可直接访问 Trae 中文官网(trae.cn 或 trae.com.cn),一键下载官方正版 .exe 安装包,享受国内直连的高速稳定体验。安装过程极其简便,双击即可运行,并支持一键无缝导入 VS Code 或 Cursor 的原有主题、快捷键及插件配置。登录支持手机号、微信或稀土掘金账号。内置免费的豆包与 DeepSeek 等顶级大模型,让你开箱即用,轻松开启高效的 AI 智能编程之旅。 下载 Claw Token 和 IMA 凭证不能混用同一组变量名 Claw 服务用的是
CLAW_TOKEN
,IMA 连接用的是
CLIENT_ID
+
API_KEY
,两者用途和来源完全不同: •
CLAW_TOKEN
来自 WorkBuddy 的 Claw Settings 页面,只用于本地 API 认证 •
CLIENT_ID
和
API_KEY
来自 IMA 控制台,专用于调用 IMA 的后端接口 若把 IMA 的 Api Key 错误赋给
CLAW_TOKEN
,会导致
401 Unauthorized
错误,且 WorkBuddy 日志里不会明确提示错配,只会卡在“连接中” 最易被忽略的是:环境变量设完后不重启 WorkBuddy,或复制凭证时带入了不可见 Unicode 字符。建议用记事本先粘贴一次,确认无异常符号再填入环境变量对话框。

相关文章