WorkBuddy 在 macOS 安装失败主因是系统安全机制拦截：需手动挂载 .dmg、授权“无法验证开发者”、启用辅助功能权限，并确保 Node.js 与 clawhub 已正确安装配置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy 在 macOS 上安装失败，八成不是软件问题，而是系统安全机制在拦路——它默认拒绝运行未签名或非 App Store 来源的应用，WorkBuddy.dmg 就卡在这一步。
双击拖拽后没反应？先确认 WorkBuddy.dmg 是否完整挂载
macOS 不会像 Windows 那样自动解压或提示“正在加载”，它只是把镜像挂载为一个虚拟磁盘。如果双击后桌面没出现新窗口、Finder 里也没看到 WorkBuddy 图标，说明挂载失败。
- 打开 Finder → 左侧边栏「位置」里找「已挂载的磁盘映像」，看是否有
WorkBuddy条目；没有就重下一次，浏览器下载完成时留意是否显示「已完成」而非「暂停」或「失败」 - 终端执行
hdiutil verify /path/to/WorkBuddy.dmg（替换真实路径）可验证文件完整性，损坏的镜像拖拽无效 - 别用第三方解压工具强行打开
.dmg，它不是压缩包，是磁盘映像，必须用系统原生方式挂载
拖进 Applications 后打不开，弹出“无法验证开发者”怎么办
这是最常卡住的环节。系统不是阻止你，只是需要你明确授权一次——但授权入口藏得深，且只在首次启动时出现。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
- 先确保已将
WorkBuddy.app拖入/Applications目录（不是桌面或 Downloads 文件夹） - 右键 Dock 中的
WorkBuddy图标 → 「显示简介」→ 勾选底部「忽略此App的开发者ID警告」（注意：这个选项仅在首次启动被拦截后才显示） - 如果没看到该选项，说明还没触发过拦截。可在终端强制启动：
open /Applications/WorkBuddy.app，此时系统才会弹出「安全性与隐私」提示，点击「仍要打开」 - 若「仍要打开」按钮灰掉，需先去「系统设置 → 隐私与安全性 → 安全性」里确认「允许从以下位置下载的应用」是否设为「App Store 和被认可的开发者」
启动后卡在「正在配置辅助功能权限」界面
WorkBuddy 需要 macOS 的辅助功能权限才能操作其他应用（比如自动填表、截图），这步不可跳过，否则后续所有技能（如 agent-browser）都会失效。
- 弹窗出现时，必须点「打开系统偏好设置」→ 进入「辅助功能」→ 左侧列表滚动到底部，找到
WorkBuddy→ 勾选复选框 - 勾选后返回 WorkBuddy 窗口，点「确认」；如果直接关掉弹窗，下次启动还会卡住，且不会再次提醒
- 若列表里找不到
WorkBuddy，重启应用再试一次；极少数情况需手动添加：sudo sqlite3 /Library/Application\ Support/com.apple.TCC/TCC.db "INSERT OR REPLACE INTO access VALUES('kTCCServiceAccessibility','cn.codebuddy.workbuddy',0,1,1,NULL,NULL,NULL,'UNUSED',NULL,0,1638405237);"（仅限调试，不推荐新手直接执行）
安装完不能用技能？检查 Node.js 和 clawhub 是否就位
WorkBuddy 本身能跑，不代表技能能跑。小红书、浏览器自动化等技能依赖本地 Node.js 运行时和 clawhub 包管理器，缺一不可。
- 终端执行
node -v，输出应为 v18.x 或 v20.x（LTS 版本）。没装就去nodejs.org下载 LTS 安装包，安装时务必勾选「Add to PATH」 - 执行
clawhub --version，若报 command not found，说明没装clawhub。按官方指引运行：npm install -g @clawhub/cli - 首次运行技能前，建议先装
skill-vetter：clawhub install skill-vetter，它会扫描后续安装的所有技能包是否含恶意代码 - 别在 iTerm 或其他终端里用
sudo装技能，clawhub默认写入用户目录，用 root 权限会导致权限混乱，后续更新失败
真正容易被忽略的不是安装步骤，而是「辅助功能权限」那一步——它不像「无法验证开发者」有明显弹窗，而是在后台静默卡住，连日志都不输出。很多人反复重装，其实只要回到那个弹窗点一次勾选，就能继续。
