workbuddy是开箱即用的桌面客户端，安装需完成三步：安装程序、授权系统权限、绑定远程通道；windows需绕过smartscreen，macos需在隐私设置中手动允许，且安装路径须预留足够空间。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy 不需要“部署”，它是个开箱即用的桌面客户端，所谓“部署指南”本质是安装 + 权限授权 + 远程通道绑定三步操作，跳过任意一环都会导致功能残缺。
Windows/macOS 安装后打不开或闪退
这基本不是程序 bug，而是系统拦截或权限缺失。Windows 用户遇到 SmartScreen 弹窗，必须点“更多信息”再选“仍要运行”；macOS 用户首次启动被拦，不能直接关掉，得进【系统设置 → 隐私与安全性】找到 WorkBuddy 点【允许】，否则后续所有文件操作（读取文档、写入桌面）都会静默失败。
安装路径也容易踩坑：Windows 默认装 C 盘，但若 C 盘剩余空间
Claw 远程控制配置失败的常见原因
Claw 不是插件，是 WorkBuddy 启动后自动加载的通信中间件，但必须完成一次有效绑定才能激活。最常出问题的是 Token 和 EncodingAESKey 填反了——企业微信生成的两个密钥字段名和 WorkBuddy 设置页的输入框标签不一致，Token 要填进 “机器人 Token” 栏，EncodingAESKey 才填进 “消息加解密密钥” 栏，填错一个就收不到指令。
另一个隐形坑是 WebhookURL 复制不完整：企业微信保存机器人时，要求填的 URL 必须以 https:// 开头、包含完整路径（如 https://claw.codebuddy.cn/v1/callback?token=xxx），少一个字符或漏掉参数都会返回 404。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
文件类任务执行失败但无报错提示
WorkBuddy 在本地沙箱中运行任务，但它不会主动告诉你“没权限”。比如你让 AI “把周报发到桌面”，结果桌面空空如也，大概率是首次启动时没点【好】授权访问桌面文件夹——这个弹窗只出现一次，错过就只能手动补：Windows 在设置 → 隐私 → 文件系统里打开 WorkBuddy 权限；macOS 则需重新进【系统设置 → 隐私与安全性 → 文件和文件夹】，勾选对应目录。
另外，新建任务 模式默认工作目录是系统盘下的临时文件夹，如果上传了 Excel 并让 AI 修改它，但没在任务设置里指定非系统盘路径，大模型可能因磁盘空间不足直接跳过写入步骤，表面看就是“没反应”。
真正卡住人的从来不是技术复杂度，而是权限弹窗只出现一次、密钥字段名不匹配、路径没手动指定这三处细节。它们不出现在任何报错里，却能让整个流程停在“看似正常”的假象中。
