workbuddy稳定运行的关键在于avx2指令集支持、windows 10 2004+系统版本、8gb以上内存、ntfs文件系统、无中文/特殊字符的安装路径、完整系统权限授予及57891/3001端口可用性。

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

WorkBuddy 能否在你的电脑上稳定运行，关键不在于“能不能装上”，而在于“多任务执行时会不会卡死、AI指令是否响应、Claw远程控制是否掉线”。官方标称的“最低配置”仅能支撑单次轻量操作（比如重命名3个文件），真实使用中很容易触发 OOM 或模型加载失败。

Windows 用户必须确认的两个硬性门槛

很多闪退、白屏、启动后无响应的问题，根源就在这两点没过：

• 系统版本必须是 Windows 10 2004（内部版本号 19041）或更高——winver 命令可查；Windows 10 1903 及更早版本会校验失败，安装包直接拒绝运行
• CPU 必须支持 AVX2 指令集：Intel 第 4 代 Core（Haswell）起，AMD Ryzen 1000 系列起；老款 i5-3210M、奔腾 G 系列、赛扬 N 系列等均不支持，会导致 Failed to load model: avx2 not supported 错误，本地混元 Lite 引擎完全不可用，只能走纯 API 模式（依赖网络+云端响应）

内存不是“够用就行”，而是“够稳才敢用”

官方写“最低 4GB”，但实际场景下这个值毫无意义：

workbuddy-pet

WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo

下载

• 4GB RAM 下连续执行两个以上 Agent 协同任务（例如“整理桌面截图→生成会议纪要→发到企业微信”），大概率触发 Windows 内存回收机制，Claw 进程被强制终止，企业微信指令丢包
• 8GB RAM 是真实可用的起点：其中约 2GB 被 Claw 子系统独占用于保活和指令缓冲，剩余部分才供 UI 和模型推理调度
• 若常开浏览器+Office+WorkBuddy 三件套，建议直接上 16GB；32GB 对中小企业本地部署非必需，但可避免知识索引重建时的磁盘 I/O 阻塞

磁盘与路径限制比你想的更严格

不是“有空间就能装”，而是“路径对了才能跑起来”：

• 安装路径绝对不能含中文、空格、&、#、% 等字符；常见坑：装在 C:\Program Files\WorkBuddy（空格导致技能市场返回 403）、D:\我的软件\workbuddy（中文触发沙箱初始化失败）
• 必须使用 NTFS（Windows）、APFS（macOS）、ext4（Linux）文件系统；FAT32 或 exFAT 移动硬盘作为安装盘，首次运行即卡在解压阶段
• 虽安装包仅 150–180MB，但完整部署后工作目录（如 C:\Users\[用户名]\WorkBuddy\Claw）需稳定占用 ≥2GB，且该目录不可手动迁移或符号链接替代

最容易被忽略的“隐形配置”：权限链与端口

装完打不开、能打开但指令不执行，八成出在这里：

• Windows 首次启动必须点允许“控制你的设备”，否则 Claw 的辅助功能模块静默禁用——这不是弹窗提醒一次就完的事，跳过即永久失效，需卸载重装或进主界面点击头像 → 「系统权限修复」
• macOS 必须一次性授予三项权限：辅助功能、完全磁盘访问、屏幕录制；缺任意一项，PPT 自动生成、截图分析、文件拖拽操作全部失效
• 57891 端口需对外放行（用于本地服务通信），3001 端口需空闲（Claw 默认监听）；若本机已运行 Node.js 开发服务或 Docker 容器，极易冲突导致启动后 UI 空白

真正决定 WorkBuddy 是否“好用”的，从来不是 CPU 型号或硬盘大小，而是 AVX2 支持状态、权限是否一次授全、路径是否干净、端口是否干净——这些细节一旦漏掉，后续所有调试都在原地打转。