必须用系统级环境变量，因为临时命令行设置在进程退出后失效，导致技能调用时报 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 字符。建议用记事本先粘贴一次，确认无异常符号再填入环境变量对话框。
