WorkBuddy安装或启动失败可按系统类型分步解决：macOS需解除开发者限制并清除隔离属性；Windows需补全VC++与.NET组件、关闭杀软；临时可用Web版；macOS开发者需清理Homebrew残留；所有平台均需将WorkBuddy加入安全软件白名单。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您下载并尝试安装WorkBuddy，但安装过程失败或启动后立即报错，则可能是由于系统权限限制、安全策略拦截或运行环境缺失所致。以下是解决此问题的步骤：
一、解除macOS“无法验证开发者”限制
macOS默认阻止未签名或非App Store来源的应用运行，WorkBuddy首次启动时可能被系统拦截，需手动授权放行。
1、双击WorkBuddy.app后若弹出“已损坏，无法打开”提示，先不要关闭窗口。
2、前往“访达” → 右键点击WorkBuddy.app → 选择“显示简介”。
3、在简介窗口底部勾选“锁定”旁的“忽略此警告”选项（如不可用，请先点击左下角锁图标输入密码解锁）。
4、关闭简介窗口，再次右键WorkBuddy.app → 选择“打开” → 点击弹窗中的“打开”按钮。
5、若仍失败，执行终端命令强制移除隔离属性：sudo xattr -rd com.apple.quarantine /Applications/WorkBuddy.app。
二、修复Windows用户“安装程序已停止工作”错误
部分Windows 10/11系统因缺少VC++运行库或.NET Framework组件，会导致WorkBuddySetup.exe安装中断或闪退。
1、访问微软官方下载中心，安装最新版Visual C++ 2015–2022 运行库（x64）。
2、以管理员身份运行PowerShell，执行：Get-WindowsCapability -Online | Where-Object Name -like 'NetFx*' | Add-WindowsCapability -Online，确保.NET Framework 3.5及4.8启用。
3、关闭所有杀毒软件与Windows Defender实时保护，再重新运行WorkBuddySetup.exe。
4、安装时务必勾选“为所有用户安装”和“添加到PATH”，避免权限路径异常。
三、跳过本地安装：使用免部署Web版临时替代
当本地安装持续失败且急需使用时，可绕过客户端，直接通过腾讯云提供的兼容Web界面调用WorkBuddy核心能力，无需任何安装步骤。
1、打开浏览器，访问：https://workbuddy.codebuddy.cn/web。
将 iPhone 的 Apple Health 数据同步到 OpenClaw。只需扫描一次二维码，无需手动配置。支持 Mac、Linux 和 VPS。
2、使用微信扫码登录（支持个人微信、企业微信、QQ账号）。
3、登录后自动进入Claw交互界面，可发送自然语言指令，如“整理桌面PDF文件并按日期重命名”。
4、Web版默认调用MiniMax或Kimi模型，支持文件上传、多轮对话与基础任务执行，功能覆盖率达本地版85%以上。
四、验证并重装Homebrew依赖（仅macOS开发者用户）
若曾通过Homebrew安装过旧版WorkBuddy或OpenClaw生态工具，残留配置可能引发冲突，需彻底清理后重装。
1、卸载现有版本：brew uninstall --cask workbuddy openclaw。
2、清除缓存与日志：brew cleanup && rm -rf ~/Library/Caches/homebrew && rm -rf ~/Library/Logs/WorkBuddy。
3、更新Homebrew源并重装：brew update && brew install --cask workbuddy。
4、安装完成后，检查应用签名状态：codesign -dv /Applications/WorkBuddy.app，确认输出含“Tencent Cloud”标识。
五、禁用第三方安全软件干扰
某些国产安全软件（如360、腾讯电脑管家、火绒）会将WorkBuddy的沙箱进程或辅助功能调用误判为风险行为，主动终止其运行。
1、打开对应安全软件主界面，进入“信任区”或“白名单管理”。
2、添加以下路径至信任列表：/Applications/WorkBuddy.app（macOS）或 C:\Program Files\WorkBuddy\（Windows）。
3、在“防护设置”中临时关闭“勒索病毒防护”与“行为拦截”模块。
4、重启WorkBuddy，观察是否仍报错；若恢复正常，可在安全软件中单独为WorkBuddy开启“低风险进程放行”策略。
