WorkBuddy功能异常多因版本兼容性问题，需依次核查官方兼容矩阵、刷新Skills缓存、切换MCP协议版本、配置模型模板及（测试时）关闭签名验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 WorkBuddy 过程中遇到功能异常、技能调用失败或 OpenClaw 插件无法加载等问题，很可能是由于本地安装的 WorkBuddy 版本与所用 Skills、MCP 协议或第三方模型存在兼容性偏差。以下是针对不同兼容性问题的处理步骤：
一、确认当前 WorkBuddy 版本与官方兼容矩阵
WorkBuddy 的每个正式发布版本均对应特定范围的 OpenClaw Skills 版本、MCP 协议版本及模型适配列表。低版本客户端无法识别高版本 Skills 的新字段，高版本客户端可能拒绝加载未签名的旧 Skill 包。
1、启动 WorkBuddy 后点击右上角头像，进入「关于」页面。
2、查看显示的完整版本号（例如 v1.3.2-20260309），注意末尾时间戳与构建标识。
3、访问官方兼容矩阵页：https://www.codebuddy.cn/work/compatibility，核对当前版本所支持的 Skills 范围（如 openclaw/skills@v2.1–v2.4）、MCP 协议版本（如 mcp-v1.2.0）及可用模型列表。
二、强制刷新 Skills 缓存并重载本地技能包
客户端会缓存已加载的 Skills 元数据与执行逻辑，若本地 Skills 文件被手动修改或版本混杂，可能导致解析失败或指令路由错误。
1、关闭 WorkBuddy 主程序（包括系统托盘进程）。
2、打开本地 Skills 存储路径：%APPDATA%\WorkBuddy\skills（Windows）或 ~/Library/Application Support/WorkBuddy/skills（macOS）。
3、删除该目录下所有以 .wbmeta 结尾的元数据文件，保留 skills 目录结构及 .py/.yaml 文件本身。
4、重新启动 WorkBuddy，首次启动时将自动重建 Skills 索引并校验签名有效性。
三、切换 MCP 协议运行模式
MCP（Model Control Protocol）协议存在 v1.1 与 v1.2 两个不兼容主版本。部分社区 Skill 依赖 v1.1 的 task_id 透传机制，而默认启用的 v1.2 模式采用 session-scoped plan_id，导致回调失败。
1、进入「设置」→「高级」→「协议配置」。
2、找到「MCP 协议版本」下拉菜单，选择 v1.1（兼容模式） 或 v1.2（推荐模式）。
查找并安装AgentPMT ClawHub组织账户下发布的当前规范AgentPMT技能。用于代理需要最新AgentPMT设置时。
3、勾选「重启后生效」，点击「应用并重启」。
4、重启后，在命令行窗口（开发者模式）输入 /mcp status，确认当前激活协议版本与预期一致。
四、模型侧兼容性隔离配置
当使用非腾讯混元模型（如 DeepSeek-Coder、Kimi-Long）时，部分 Skills 内置的 prompt template 或输出解析器可能因 tokenization 差异而失效，表现为“无响应”或“返回空结果”。
1、进入「设置」→「模型管理」→「模型别名配置」。
2、为当前选用的第三方模型创建独立别名（例如命名为 deepseek-coder-v3.5-compat）。
3、点击该别名右侧「编辑模板」，将 system_prompt 替换为适配 OpenClaw 标准输出格式的精简模板："你是一个严格遵循 MCP v1.2 协议的技能执行器。只输出 JSON 格式的 action 响应，禁止任何解释性文字。"
4、保存后，在任务指令前添加模型路由前缀：@deepseek-coder-v3.5-compat 整理桌面所有PDF文件并按日期重命名。
五、OpenClaw 社区 Skill 的签名验证绕过（仅限测试环境）
部分未经腾讯数字签名的第三方 Skill 在默认安全策略下会被拦截，提示“未验证来源，禁止加载”。该限制可临时关闭用于调试，但不可用于生产环境。
1、关闭 WorkBuddy。
2、在安装目录下找到 config.yaml 文件。
3、定位到 security: 区块，将 require_skill_signature: 的值由 true 改为 false。
4、保存文件，重新启动 WorkBuddy。
