workbuddy启动卡在“正在加载技能”是因本地运行环境未就绪，需确保node.js（lts版且add to path）、git（路径无中文/空格）、windows用户还需.net desktop runtime三者均安装并可通过命令行验证版本号。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

WorkBuddy 不是聊天框升级版，它是本地操作系统层的执行代理——能读你桌面的 Excel、改你文档里的标题、自动把 200 个截图转成带编号的 Word 报告，全程不上传任何文件。

为什么 WorkBuddy 启动后总卡在“正在加载技能”？

这不是网络慢，而是本地运行环境没就绪。它依赖三个底层组件协同工作，缺一不可：

• Node.js（必须 LTS 版，且安装时勾选“Add to PATH”，否则 workbuddy-cli 命令找不到运行时）
• Git（用于拉取 OpenClaw 技能包，路径不能含中文或空格，否则 skill install 会静默失败）
• Windows 用户额外需要 .NET Desktop Runtime（尤其是精简版 Win10/11，缺失会导致文件操作类技能（如 batch-rename、excel-clean）直接报 System.IO.FileNotFoundException）

验证方式：重启电脑后，在终端分别运行 node -v、git --version、dotnet --list-runtimes，三者都返回版本号才算真正就绪。

workbuddy-cli skill install 失败的常见原因

插件装不上，90% 情况下不是插件源问题，而是权限或路径冲突：

• Windows 下未以管理员身份运行终端，导致写入 %LOCALAPPDATA%\WorkBuddy\skills 失败，错误信息常为 EACCES: permission denied
• macOS 上首次安装技能时，系统会弹出“是否允许辅助功能”，必须手动勾选 WorkBuddy，否则所有涉及鼠标/键盘模拟的技能（如 auto-fill-form）永远无响应
• 技能名拼错或大小写不敏感但实际区分（例如 pdf-merge ≠ PDFMerge），建议用 workbuddy-cli skill list --available 精确查证

远程控制（Claw）连不上企业微信？检查这三点

Claw 功能不是“绑定即通”，它依赖长连接通道维持实时指令下发：

Pkuhb Openclaw Skill

提供OpenClaw平台入门指南，含产品定位、技术架构、部署配置、Skills开发与安全实践。

下载

• 企业微信后台需开启“接收消息”权限，并确认已配置 WebSocket 回调地址（非 Webhook），地址格式为 wss://claw.codebuddy.cn/v1/ws?token=xxx
• 本地 WorkBuddy 设置中，“远程控制”开关必须打开，且状态显示为 Connected（灰色 = 断连，黄色 = 正在重连）
• 若使用公司内网，防火墙可能拦截 wss 协议，可临时切换至手机热点测试；部分企业微信管理后台会禁用第三方 WebSocket 接入，需联系 IT 启用白名单

模型切换后任务结果变差？别急着换回混元

不同模型对指令解析逻辑差异极大，同一句话在 DeepSeek 和 Kimi 下可能触发完全不同的技能链：

• 混元 对短指令（如“整理桌面图片”）响应快，但多步骤推理弱，容易漏掉子任务
• DeepSeek 需要更明确的约束，比如加上“按日期倒序+重命名格式为 IMG_YYYYMMDD_XXX.jpg”，否则可能自由发挥
• Kimi 在文案生成类任务中表现突出，但对文件路径等结构化输入敏感，路径里有中文空格易导致 File not found

真正关键的是：先用默认模型跑通流程，再针对性切模型优化某一步，而不是全局替换。

最常被忽略的一点：所有本地文件操作类任务，WorkBuddy 默认只访问你主动授权的文件夹（桌面、文档、下载）。它不会自动扫描全盘，也不会记住上次选过的路径——每次新任务，都得重新确认权限范围，否则看似执行了，其实什么都没动。