workbuddy需v2.3.0+版本并启用claw运行时，通过技能市场安装openclaw社区技能，验证非空壳后可用自然语言调用，失败时依次排查api密钥、powershell json传递及utf-8编码。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已安装WorkBuddy客户端，但尚未启用OpenClaw社区技能或无法调用其功能，则可能是由于技能未正确安装、依赖缺失或环境配置未就绪。以下是具体操作路径：
一、确认WorkBuddy与OpenClaw生态兼容性
WorkBuddy作为腾讯云官方适配版，原生支持OpenClaw技能生态，无需额外桥接。所有SkillHub或ClawHub上标有“OpenClaw兼容”标签的技能均可直接安装使用，但前提是客户端版本不低于v2.3.0（2026年3月起默认内置Claw运行时）。
1、打开WorkBuddy客户端，点击左下角头像进入「系统设置」。
2、选择「Claw 设置」→「运行时版本」，核对显示版本号是否为v2.3.0 或更高。
3、若版本过低，点击「检查更新」并完成升级；若无更新选项，需重新下载最新安装包（官网唯一地址：https://www.codebuddy.cn/work/）。
二、从SkillHub安装OpenClaw社区技能
社区技能由第三方开发者发布，经ClawHub审核后上架，安装即生效，不需手动编译或配置路径。
1、在WorkBuddy主界面点击左侧导航栏「技能市场」。
2、顶部搜索框输入关键词如baidu-search或wechat-notify，筛选「OpenClaw社区」分类。
3、点击目标技能卡片，查看「依赖项」列表——若显示“未满足”，需先安装对应底层工具（如browser-automation依赖Playwright）。
4、点击「安装」按钮，等待状态变为「已启用」；此时该技能即可在对话中被自然语言触发。
三、验证技能是否为空壳
空壳技能仅有元数据声明而无实际执行能力，常见于依赖未就绪或权限受限场景。必须通过实测判定，不可仅凭图标或描述判断。
1、在聊天窗口输入该技能典型指令，例如对browser-automation说：“打开知乎首页”。
2、观察响应：若返回“已启动浏览器”或页面自动弹出，则非空壳；若提示“命令未找到”“依赖缺失”或长时间无响应，则为功能空壳。
3、针对空壳情况，返回「Claw 设置」→「依赖管理」，勾选缺失项（如Node.js、Playwright、curl等），点击「一键安装依赖」。
四、使用自然语言调用OpenClaw技能
WorkBuddy将自然语言指令实时解析为OpenClaw可执行动作，无需记忆CLI命令，但需符合语义结构规范。
1、在主对话框中清晰表达意图，例如：“用百度搜索‘龙虾WorkBuddy部署教程’”。
2、AI自动识别调用baidu-search技能，并将结果以结构化摘要呈现，同时附带原始链接。
3、若指令模糊（如仅说“查一下百度”），系统会追问关键参数；此时补充“搜索词是……”即可继续执行。
五、排查技能调用失败的三个高频点
当技能显示已安装但仍无响应时，需按顺序排查以下独立故障面，每一项均可能单独导致中断。
1、检查API Key环境变量：打开「系统设置」→「Claw 设置」→「密钥管理」，确认千帆Key格式为fk-xxxxxxxxxxxxxxxxxxxxxxxx且来源为codebuddy.cn控制台。
2、验证PowerShell JSON传递：Windows用户若在技能执行中报错“无法解析参数”，需进入「Claw 设置」→「高级选项」，启用JSON转义兼容模式。
3、修正中文乱码输出：若技能返回结果含“”符号，进入「系统设置」→「区域与语言」，将终端编码强制设为UTF-8并重启WorkBuddy。
