workbuddy 安装启动需满足四方面前提：一、windows 10 2004（19041）或更高版本的64位x64系统，禁用精简版；二、至少4gb内存（推荐8gb）、2gb以上ntfs磁盘空间；三、直连公网并放行codebuddy.cn域名，启用uac且使用官网安装包；四、授权辅助功能与文件系统访问权限。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您准备在 Windows 10 或 Windows 11 系统上安装 WorkBuddy，但安装失败或启动异常，则可能是由于系统版本、硬件架构或基础运行条件不满足官方最低要求。以下是符合官方验证标准的安装前提说明：
一、操作系统与架构兼容性要求
WorkBuddy 仅支持特定 Windows 版本及底层架构，非兼容系统将无法启动主进程或触发白屏、闪退等不可恢复错误。
1、必须运行 Windows 10 版本 2004（内部版本号 19041）或更高版本，包括所有 Windows 11 全系列正式版；Windows 7、8、8.1 及任何 32 位 Windows 系统均被明确排除，安装程序将直接拒绝运行。
2、系统必须为 64 位（x64）架构，可在【设置 → 系统 → 关于】中查看“系统类型”确认；ARM64 版 Windows（如 Surface Pro X 默认系统）暂未通过官方兼容性测试，不建议尝试。
3、无需启用 WSL、Hyper-V、.NET Framework 高级组件或 Visual C++ 运行库——安装包已内置全部依赖，但需确保系统未被深度精简（如某些 Ghost 精简版可能移除关键 API）。
二、硬件与存储空间限制
WorkBuddy 启动后需加载本地多 Agent 协同引擎与沙箱运行时，对内存与磁盘具有刚性占用需求，低于阈值将导致初始化中断或 UI 响应停滞。
1、最低内存要求为 4GB RAM，但仅适用于单次轻量指令（如“重命名三个文件”），连续执行多步骤任务时易触发系统级内存回收机制并强制终止进程。
2、推荐配置为 8GB RAM 及以上，其中预留至少 2GB 供 Claw 远程控制子系统独占，保障企业微信指令接收零丢包。
3、安装包本体体积为 150–180MB，但首次运行时自动解压核心运行时、生成知识索引与缓存技能包，完整部署后实际占用空间不低于 2GB，且必须位于 NTFS 格式分区；FAT32 或 exFAT 移动硬盘不可作为安装路径。
腾讯云代码助手CodeBuddy旗下WorkBuddy 4.24.8版本正式发布。本版本重点修复了上下文压缩异常、冷加载时偶现历史消息丢失、任务停止卡死等问题，并深度优化了Windows沙箱(lightSandbox)的日志写入与误弹窗逻辑，提供更安全稳定的AI协作体验。
三、网络与安全环境准备
首次安装与启动阶段需完成许可证校验、模型路由同步及 Claw 插件注册，断网或安全策略拦截将卡在“正在加载技能市场”界面，无法进入主工作台。
1、设备需能直连公网，可正常访问 https://www.codebuddy.cn/work/ 及认证端点 auth.codebuddy.cn（TCP 443 端口）；企业防火墙或代理须放行该域名。
2、安装过程需通过 Windows 用户账户控制（UAC）弹窗授权，若已禁用 UAC 或杀毒软件拦截安装行为，将导致辅助功能模块与文件系统访问权限无法写入注册表。
3、必须使用官方唯一下载地址获取安装包；第三方渠道（含网盘链接、论坛附件、非 codebuddy.cn 域名跳转页）提供的 WorkBuddySetup.exe 存在被篡改或捆绑恶意代码的高风险。
四、系统级权限与文件访问配置
WorkBuddy 依赖操作系统层级的辅助功能与文件系统访问能力，才能执行自然语言驱动的本地操作（如拖拽文件、启动 Excel、生成 PPT），缺失任一权限将导致 AI 指令解析成功但执行失败。
1、首次启动时，系统将弹出“是否允许此应用控制你的设备”提示，必须点击【是】，否则 Claw 远程控制与自动化任务引擎将被永久禁用。
2、安装向导中需手动开启“文件和文件夹访问权限”，重点勾选 桌面、文档、下载、图片、视频、音乐及自定义工作目录；未勾选路径内的文件无法被 AI 识别或操作。
3、若跳过初始权限申请，可在主界面点击右上角头像 → 「系统权限修复」，触发 Windows 设置 → 隐私 → 文件系统权限的重新引导流程。
