必须用系统级环境变量,因为临时命令行设置在进程退出后失效,导致技能调用时报 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 默认只读用户变量
使用 draw.io(.drawio 格式)和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发: - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
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 字符。建议用记事本先粘贴一次,确认无异常符号再填入环境变量对话框。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










