workbuddy不支持saas或容器化云部署，仅限本地终端运行；适配云环境需采用云桌面方案（在windows/linux云主机安装gui客户端并配置claw反向连接）或混合架构方案（云服务调度指令经企微中转至本地客户端执行）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您计划在华为云或阿里云等公有云环境中部署WorkBuddy，需特别注意其原生定位为桌面端智能体操作系统，**不提供标准云服务形态的SaaS部署包或容器化镜像**。其官方支持路径仅限于本地终端（Windows/macOS）运行，远程控制能力依赖Claw模块通过企业微信等IM通道反向接入。以下是适配云环境的可行部署路径与关键约束说明：
一、云桌面方案：在云主机中运行完整WorkBuddy客户端
该方式将云服务器视作远程桌面终端，在其上安装并运行WorkBuddy桌面客户端，适用于需集中管理、统一策略的企业场景。核心前提是云主机已配置图形界面及用户会话环境。
1、选择预装Windows Server 2019/2022或Ubuntu Desktop 22.04 LTS的云主机实例，确保分配≥4GB内存与2核vCPU。
2、Windows云主机：下载官方安装包（仅限 https://www.codebuddy.cn/work/ 获取），以普通用户身份登录远程桌面后执行WorkBuddySetup.exe；禁用系统默认的“仅后台服务”模式，确保GUI进程可被激活。
3、Ubuntu云主机：需手动启用X11转发或安装轻量级桌面（如XFCE），再通过sudo apt install libasound2 libgbm1 libxss1补全多媒体与渲染依赖，最后运行AppImage格式客户端（若提供）或等待官方Linux版发布。
4、配置Claw反向连接：在云主机内启动WorkBuddy后，使用企业微信扫码完成绑定，并在「Claw设置」中启用「允许远程指令触发本地文件操作」——此操作将使云主机具备响应外部消息并执行本地任务的能力。
二、混合架构方案：云后端+本地执行器分离部署
该方式规避了在云服务器上直接运行GUI应用的限制，利用WorkBuddy的技能可插拔特性，将其作为本地执行终端，由云服务调度指令。适用于已有API网关或任务队列的企业IT基础设施。
1、在华为云FunctionGraph或阿里云函数计算FC中部署轻量HTTP服务，接收来自业务系统的结构化任务请求（如JSON格式的“生成周报”指令）。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
2、该云服务不执行任务本身，而是将指令封装为Claw兼容的Webhook消息，通过企业微信机器人通道发送至已绑定WorkBuddy的企微账号。
3、本地已运行的WorkBuddy客户端监听该企微账号消息流，识别指令后调用对应技能（如Excel分析、PDF生成），结果回传至云服务指定回调地址。
4、关键约束：云服务无法直连WorkBuddy本地进程，必须经由Claw认证的IM通道中转；所有文件读写仍发生于本地设备，云侧仅承担指令路由与结果聚合职责。
三、跨云安装注意事项
当WorkBuddy客户端部署于不同云厂商提供的云桌面环境时，系统级兼容性与权限策略存在显著差异，须逐项核查。
1、华为云Workspace：需在工作空间策略中显式开启「剪贴板重定向」与「USB设备重定向」，否则Claw无法同步复制内容或访问U盘中的源文件。
2、阿里云无影云电脑：默认禁用第三方应用安装权限，须进入「控制台 → 工作区管理 → 策略设置」，将WorkBuddySetup.exe的SHA256哈希值加入白名单，并授予「修改注册表」与「创建计划任务」权限。
3、网络出口一致性：若WorkBuddy需访问本地局域网NAS或数据库，云桌面实例必须与目标资源处于同一VPC内，且安全组放行对应端口（如SMB的445、PostgreSQL的5432）；禁止使用公网IP映射方式访问内网资源，Claw模块默认拒绝非本地环回地址的数据库连接请求。
4、首次激活联网要求：所有云桌面实例在首次启动WorkBuddy时，必须能直连https://www.codebuddy.cn完成账号绑定与许可证校验，代理或防火墙拦截将导致客户端卡在登录页且无错误提示。
