WorkBuddy智能体打不开怎么办？-人工智能-PHP中文网

workbuddy打不开需五步排查：一查系统版本（win10 22h2+/macos12.6+）与硬件（≥2核4gb）；二授管理员或全盘访问权限；三清%appdata%\codebuddy\workbuddy或~/library/application support/codebuddy/workbuddy缓存；四用--no-claw参数禁用claw验证；五调vmoptions中jvm内存至-xms4g -xmx12g。

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

workbuddy智能体打不开怎么办？

WorkBuddy智能体打不开，表现为双击图标无响应、启动后立即消失、任务栏闪现即退或弹出“权限不足”“初始化失败”等提示——这不是偶然故障，而是本地运行环境未通过基础校验所致；当前（2026年7月29日）服务端健康状态持续正常，官方状态页 https://workbuddy.qq.com/status 仍为绿色，问题100%锁定在本地。

第一步：确认系统版本与硬件是否达标

Windows 用户必须使用 Windows 10 22H2 或更高版本，macOS 用户需 macOS 12.6 及以上；低于此版本将直接拒绝加载主进程，不报错、不弹窗、仅静默退出。

按 Win+R 输入 winver 查看系统版本号，若显示为 21H2 或更早，必须升级系统后再尝试启动 WorkBuddy。

右键“此电脑”→“属性”，核对内存是否 ≥4GB、CPU 是否 ≥2核；macOS 用户点击苹果图标→“关于本机”，确认芯片架构为 Intel 或 Apple Silicon——M1/M2/M3/M4 全部支持，但 PowerPC 或旧款 Core 2 Duo 已被正式弃用。

第二步：以管理员/全盘访问权限重启动

首次启动或升级后，WorkBuddy 必须获得系统级文件访问权，否则无法读取配置、写入缓存、调用辅助功能。

Windows 用户右键桌面 WorkBuddy 图标 → “以管理员身份运行”；若仍失败，进入安装目录（默认 C:\Program Files\WorkBuddy），右键 WorkBuddy.exe → “属性” → “兼容性” → 勾选“以管理员身份运行此程序”。

macOS 用户前往“系统设置” → “隐私与安全性” → “完全磁盘访问”，点击右下角锁形图标解锁后，将 WorkBuddy 应用拖入列表并启用开关。【未启用该权限时，WorkBuddy 无法读取桌面、文档等任何用户目录，启动必失败】

第三步：清除用户配置与缓存数据

损坏的 config.json 或 claw-state.db 文件会导致初始化流程卡死在第3步，表现为启动后黑屏或直接退出。

1、彻底关闭 WorkBuddy：打开任务管理器（Win）或活动监视器（macOS），确认无 workbuddy.exe、WorkBuddy 或 ClawEngine 进程残留。

WorkBuddy(Mac4.24.8)

腾讯云代码助手CodeBuddy旗下WorkBuddy 4.24.8版本正式发布。本版本重点修复了上下文压缩异常、冷加载时偶现历史消息丢失、任务停止卡死等问题，并深度优化了Windows沙箱(lightSandbox)的日志写入与误弹窗逻辑，提供更安全稳定的AI协作体验。

下载

2、Windows 用户在文件资源管理器地址栏粘贴：%APPDATA%\CodeBuddy\WorkBuddy → 回车 → 删除整个文件夹。

3、macOS 用户打开访达 → 按 Cmd+Shift+G → 输入 ~/Library/Application Support/CodeBuddy/WorkBuddy → 删除该目录。

4、重新启动 WorkBuddy，等待首次初始化完成（约 10–20 秒），界面出现登录框即表示恢复成功。

第四步：禁用 Claw 远程控制模块验证冲突

部分企业环境或安全软件会拦截 Claw 的本地通信通道，导致启动流程在验证阶段中断，错误日志中常含 “Claw handshake timeout” 或 “MCP endpoint unreachable”。

方法一：命令行启动绕过验证
Windows：打开 CMD，cd 到 WorkBuddy 安装目录 → 执行 WorkBuddy.exe --no-claw
macOS：打开终端，cd /Applications/WorkBuddy.app/Contents/MacOS → 执行 ./WorkBuddy --no-claw

方法二：修改启动参数文件
定位 workbuddy64.vmoptions（Windows 在 C:\Program Files\WorkBuddy\bin\，macOS 在 /Applications/WorkBuddy.app/Contents/bin/）→ 用记事本或 VS Code 打开 → 在末尾新增一行：--no-claw → 保存后重启应用。