需完成服务器级部署配置以支持远程调用：一、本地应用模式启用Claw后台服务；二、Docker容器化部署；三、二进制直装+systemd托管；四、Nginx反向代理与HTTPS接入；五、企业微信Webhook注册及签名验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已下载腾讯版WorkBuddy客户端，但需将其作为后端服务长期运行并支持远程调用（如企业微信、飞书等平台触发任务），则需完成服务器级部署配置。以下是实现该目标的多种可行方法：
一、本地应用模式启用后台服务
此方法不依赖独立服务器，而是将已安装的WorkBuddy桌面客户端配置为常驻服务，通过Claw协议对外提供API能力，适用于Mac或Windows开发机作为轻量服务节点。
1、启动WorkBuddy桌面应用，完成首次登录与权限授权（文件访问、辅助功能、全盘控制等）。
2、点击右上角用户头像，进入Claw Settings菜单。
3、在Claw Settings中选择Enable Background Service开关并开启。
4、记录页面显示的Local API Endpoint（通常为http://127.0.0.1:8080/claw）及生成的Claw Token。
5、确保系统防火墙放行对应端口，并设置开机自启（Mac可通过Login Items添加，Windows可通过任务计划程序配置）。
二、Docker容器化部署（Linux服务器）
此方法将WorkBuddy核心服务封装为Docker容器，在CentOS/Ubuntu等Linux服务器上运行，隔离环境、便于管理，适合生产环境复用。
1、在目标服务器上安装Docker与docker-compose（要求Docker版本≥24.0）。
2、创建项目目录并新建docker-compose.yml文件，内容包含workbuddy-service服务定义，镜像来源为腾讯云官方提供的arm64/amd64多架构镜像（如ccr.ccs.tencentyun.com/workbuddy/server:latest）。
3、挂载必要卷：将/app/config映射至宿主机配置目录，用于持久化Claw Token、机器人凭证及技能插件。
4、配置环境变量：CLAW_TOKEN、WEWORK_WEBHOOK_URL（如已预配）、LOG_LEVEL=info。
5、执行docker-compose up -d启动服务，使用curl http://localhost:8080/health验证服务响应状态。
三、二进制直装部署（无容器Linux服务器）
此方法跳过容器层，直接运行WorkBuddy服务二进制文件，资源占用更低，适用于内存受限或需深度系统集成的场景。
1、从腾讯云WorkBuddy发布页下载对应架构的workbuddy-server-linux-amd64.tar.gz或workbuddy-server-linux-arm64.tar.gz包。
2、解压至/opt/workbuddy目录，赋予workbuddy-server可执行权限。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
3、复制示例配置文件config.example.yaml为config.yaml，填写claw.token、integrations.wework.webhook_url等字段。
4、创建systemd服务单元文件/etc/systemd/system/workbuddy.service，指定WorkingDirectory、ExecStart及Restart策略。
5、执行systemctl daemon-reload && systemctl enable --now workbuddy，检查日志：journalctl -u workbuddy -f。
四、反向代理与HTTPS接入（Nginx配置）
当WorkBuddy服务部署在内网或需对外暴露安全接口时，必须通过Nginx反向代理统一处理TLS终止、路径路由与访问控制。
1、申请并部署SSL证书至Nginx服务器，确保域名（如workbuddy.yourdomain.com）已解析到该服务器IP。
2、在Nginx配置中新增server块，监听443端口，设置proxy_pass http://127.0.0.1:8080指向本地WorkBuddy服务。
3、添加关键代理头：proxy_set_header X-Forwarded-For $remote_addr、proxy_set_header X-Claw-Token $http_x_claw_token（用于透传认证令牌）。
4、配置location /claw/ 路由，启用proxy_buffering off以支持长连接流式响应。
5、重载Nginx配置：nginx -t && systemctl reload nginx。
五、企业微信Webhook注册与回调验证
WorkBuddy服务启动后，必须完成企业微信侧的Webhook地址注册与签名验证，否则消息无法送达服务端。
1、登录企业微信管理后台，进入「安全与管理 → 管理工具 → 智能机器人」，点击「API模式创建」。
2、选择URL回调模式，点击「随机获取」生成Token与EncodingAESKey。
3、在WorkBuddy的Claw Settings中填写上述Token与AESKey，点击Register Webhook，复制生成的完整Webhook URL。
4、返回企业微信机器人配置页，在「回调URL」栏粘贴该URL，勾选「启用回调」并保存。
5、企业微信将立即发起GET请求校验签名，WorkBuddy服务自动响应，状态变为「已验证」。
