WorkBuddy本地部署需满足五大条件：一、操作系统（Win10+/macOS12+）与硬件兼容；二、授予辅助功能及磁盘访问等系统权限；三、首次联网激活（访问auth.codebuddy.cn）；四、预装VC++运行库（Win）或python3（macOS）；五、Claw服务需本地端口3001空闲且手机电脑同网。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试在本地运行WorkBuddy，但安装失败或功能异常，则可能是由于系统环境不满足最低运行要求。以下是完成WorkBuddy本地部署所需的全部条件与操作说明：
一、操作系统与硬件兼容性要求
WorkBuddy为桌面原生应用，所有功能均在本地执行，不依赖远程服务器或Docker容器。其运行基础是操作系统内核与图形子系统支持，必须严格匹配官方验证版本。
1、Windows用户需使用Windows 10或更高版本（仅支持64位架构），不兼容Windows 7/8/32位系统。
2、macOS用户需运行macOS 12（Monterey）及以上版本，Intel芯片与Apple Silicon（M1/M2/M3）均通过测试，但macOS 11及更早版本无法启动主进程。
3、硬盘需预留≥200MB可用空间，其中安装包本体为150–180MB；首次运行时自动创建c:/Users/[用户名]/WorkBuddy/Claw（Windows）或~/Library/Application Support/WorkBuddy/Claw（macOS）工作目录，该路径不可手动修改或重定向。
二、权限与系统级访问配置
WorkBuddy需获得操作系统层级的辅助功能与文件系统访问权限，才能执行自然语言驱动的本地操作（如文件整理、软件启停、PPT生成等）。缺失任一权限将导致AI指令无法落地执行。
1、Windows用户安装后首次启动时，系统弹窗提示“是否允许此应用控制你的设备”，必须点击允许，否则Claw远程控制模块与自动化任务引擎将被禁用。
2、macOS用户首次打开时，系统会要求授予“辅助功能”“完全磁盘访问”“屏幕录制”三项权限，需前往系统设置 → 隐私与安全性 → 相应权限列表中勾选WorkBuddy，缺一不可。
3、若已跳过初始权限申请，可在WorkBuddy主界面点击右上角头像 → 「系统权限修复」，触发重新引导流程。
三、网络与登录激活条件
WorkBuddy采用轻量级在线激活机制，非持续联网依赖型产品。首次启动必须联网完成身份校验与许可证绑定，后续所有AI推理、文件处理、插件执行均在离线状态下完成。
1、启动时需访问腾讯云认证服务端点，域名auth.codebuddy.cn必须可解析且TCP 443端口畅通，防火墙或企业代理需放行该地址。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
2、支持微信扫码登录、手机号短信登录两种方式，不支持邮箱或第三方OAuth账号；登录成功后生成本地加密凭证并持久化存储，断网后仍可正常加载主界面与已安装插件。
3、若首次激活失败，错误码ERR_AUTH_TIMEOUT表示DNS解析超时，ERR_CERT_INVALID表示系统时间偏差超过5分钟，需校准本地时钟后重试。
四、插件与技能运行前置依赖
WorkBuddy虽免Python/Node.js环境部署，但部分高级插件（如Excel公式解析、PDF批量水印、视频转GIF）需调用系统预装二进制工具。这些依赖不随主程序安装，需用户自行确认存在状态。
1、Windows平台必须预装Microsoft Visual C++ 2015–2022 运行库（x64版本），缺失时插件安装界面显示“模块初始化失败”，可在微软官网下载vcredist_x64.exe一键修复。
2、macOS平台需确保系统自带python3命令可用（macOS 12.3+已默认内置），若手动卸载过系统Python，需通过Homebrew执行brew install python@3.11并软链接至/usr/local/bin/python3。
3、所有插件均以沙箱模式运行，禁止读写/tmp以外的临时路径；若自定义脚本需访问特定目录，须在插件配置页手动添加可信路径白名单。
五、多端协同的本地绑定机制
WorkBuddy的手机远程控制能力（Claw）本质是本地服务监听+IM平台Webhook反向代理，所有指令解析与任务执行均发生在用户本机，不经过任何中继服务器。因此绑定过程实质是建立IM平台到本地HTTP服务的直连通道。
1、启用Claw前，WorkBuddy自动在本地启动HTTP服务，默认监听http://127.0.0.1:3001，端口不可更改；若该端口被占用，启动日志将报错ERR_PORT_BUSY，需终止冲突进程。
2、微信/飞书/钉钉等平台配置Webhook时，回调地址必须填写本机局域网IP（如http://192.168.1.100:3001）而非localhost，且手机与电脑必须处于同一Wi-Fi网络下。
3、企业微信机器人配置中，“消息接收URL”字段需粘贴WorkBuddy生成的完整地址，其中含一次性签名参数，该参数10分钟内有效且仅可使用一次，超时需刷新页面重新获取。
