WorkBuddy 服务端实为本地运行的 Claw 代理，需通过客户端启用或手动配置为系统服务，依赖腾讯云协调，不提供独立服务器安装包。
如果您希望在本地或私有环境中部署 workbuddy 服务端组件（如 claw 后端服务或自托管代理节点），而非仅使用客户端应用，则需注意：workbuddy 官方当前未提供独立可下载、开箱即用的“服务器安装包”。其核心服务依赖腾讯云基础设施，claw 功能以轻量级本地代理+云端协调模式运行。以下是实现 workbuddy 服务端能力落地的可行路径：
一、确认部署形态与适用场景
WorkBuddy 并非传统意义上的 B/S 架构服务器软件，其“服务器端”逻辑实际由腾讯云后台统一承载，用户本地运行的是 Claw 代理进程。该进程负责接收企微/飞书等平台的指令、调用本地 WorkBuddy 客户端能力、执行文件操作并回传结果。因此，所谓“服务器安装”，实为在目标机器上部署并配置 Claw 代理服务。
1、确保目标机器满足系统要求：Windows 10 或 macOS 10.14 及以上版本。
2、确认该机器处于长期开机、联网稳定状态，且具备管理员权限。
3、明确该机器将作为远程控制的目标终端（例如：办公室台式机），而非对外提供公网 API 的独立服务器。
二、通过 WorkBuddy 客户端启用内置 Claw 服务
WorkBuddy 桌面应用已集成 Claw 代理模块，无需单独下载服务端程序。启用过程即完成服务端能力部署。
1、完成 WorkBuddy 客户端安装并首次启动，使用腾讯云账号或微信扫码登录。
2、登录后进入主界面，点击右上角个人头像，选择“Claw 设置”。
3、在 Claw 设置页面中，选择要接入的通讯工具（如企业微信、飞书、钉钉），点击对应“配置”按钮。
4、按页面提示完成授权流程：扫描二维码、确认权限、获取 Webhook 地址等。此时 WorkBuddy 自动在本地启动 Claw 代理进程，并监听指定端口（默认为 3001）。
5、验证服务状态：打开任务管理器（Windows）或活动监视器（macOS），查找名为 claw-proxy 或 WorkBuddyClaw 的进程，确认其正在运行。
三、手动配置系统级 Claw 服务（高级用户）
若需将 Claw 代理设为开机自启、脱离图形界面运行，或部署于无桌面环境的 Windows Server/macOS Server，可采用手动服务化方式。
1、访问 WorkBuddy 安装目录：Windows 默认为 C:\Program Files\WorkBuddy\resources\app\claw\，macOS 默认为 /Applications/WorkBuddy.app/Contents/Resources/app/claw/。
2、定位到 claw-proxy 可执行文件（Windows 为 claw-proxy.exe，macOS 为 claw-proxy）。
3、Windows 用户：使用 PowerShell 以管理员身份运行以下命令注册为 Windows 服务：
sc create WorkBuddyClaw binPath= "绝对路径\claw-proxy.exe --service" start= auto
4、macOS 用户：创建 plist 文件置于 ~/Library/LaunchAgents/ 目录，内容包含 ProgramArguments 指向 claw-proxy 路径，并设置 RunAtLoad 为 true。
5、启动服务：Windows 执行 sc start WorkBuddyClaw；macOS 执行 launchctl load ~/Library/LaunchAgents/com.codebuddy.claw.plist。
四、验证远程指令可达性
Claw 代理成功运行后，需验证其能否响应外部平台指令并触发本地动作，这是服务端功能生效的关键标志。
1、在已绑定的企业微信/飞书工作群中，向机器人发送指令，例如：“打开我的桌面” 或 “生成一份周报草稿”。
2、观察目标机器上的 WorkBuddy 客户端是否自动弹出响应窗口，或是否在结果面板中生成对应产物。
3、若指令无响应，检查目标机器防火墙是否放行 TCP 端口 3001，并确认 Claw 设置中显示“已连接”状态图标为绿色。
