必须用系统级环境变量,因为临时命令行设置在进程退出后失效,导致技能调用时报 KeyError;Client ID 和 API Key 需从IMA控制台复制、严格配对、区分环境,并通过图形界面设为用户变量后重启客户端。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
为什么必须用系统级
环境变量
而不是临时 set
WorkBuddy 启动时只读取系统或用户级环境变量,
这种命令行临时设置在进程退出后就失效,技能调用时会直接报
。Windows 上只有写入注册表的用户变量(或系统变量)才能被桌面应用稳定读取。
Client ID 和 Api Key 必须配对且大小写敏感
从
复制的值里,常见错误是:
• 复制了带空格或换行的字符串(尤其 Api Key 结尾有不可见字符)
• 把 Client ID 当成 Api Key,或反过来
• 混用了测试环境和正式环境的凭证(IMA 控制台右上角会显示环境标签)
验证方式:在 PowerShell 中运行
和
,输出应为纯字符串、无引号、无前后空格。
Windows 设置环境变量的实操要点
必须用「系统属性 → 高级 → 环境变量」图形界面操作,不能只靠命令行:
• 在「用户变量」区域点击「新建」,变量名严格为
和
(不是
或
)
• 值字段粘贴时右键选择「选择性粘贴」→「无格式文本」,避免带入富文本样式
• 设置完必须重启 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 服务用的是
,IMA 连接用的是
+
,两者用途和来源完全不同:
•
来自 WorkBuddy 的 Claw Settings 页面,只用于本地 API 认证
•
和
来自 IMA 控制台,专用于调用 IMA 的后端接口
若把 IMA 的 Api Key 错误赋给
,会导致
错误,且 WorkBuddy 日志里不会明确提示错配,只会卡在“连接中”
最易被忽略的是:环境变量设完后不重启 WorkBuddy,或复制凭证时带入了不可见 Unicode 字符。建议用记事本先粘贴一次,确认无异常符号再填入环境变量对话框。
set CLIENT_ID=xxxKeyError: 'CLIENT_ID'https://ima.qq.com/agent-interfaceecho $env:CLIENT_IDecho $env:API_KEYCLIENT_IDAPI_KEYclient_idima_client_idCLAW_TOKENCLIENT_IDAPI_KEYCLAW_TOKENCLIENT_IDAPI_KEYCLAW_TOKEN401 Unauthorized