移动端和桌面端同步需先安装正确客户端并完成配对，windows/macos必须完成完整安装流程，跳过uac提示、未勾选关键选项或路径不当均会导致同步失效；微信扫码绑定依赖桌面端已登录、claw服务运行且账号同属腾讯体系；企业微信/飞书/qq通道配置需平台侧权限真正生效；移动端app是同步必要环节，须与桌面端账号一致且开启对应系统权限。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
移动端和桌面端能同步，但必须先装对客户端、再配对通道，不能跳过安装直接扫码。
Windows/macOS 桌面端必须完成完整安装流程
桌面端不是“下载即用”，未正确安装会导致后续所有同步通道失效。常见错误是双击 WorkBuddySetup.exe 后跳过 UAC 提示、或安装时没勾选「添加到右键菜单」和「开机自启」——这两项影响文件操作权限和后台服务常驻。
- Windows 用户务必在 UAC 弹窗点「是」，否则
Claw服务无法注册为系统服务 - macOS 用户拖入「应用程序」后，必须执行终端命令：
xattr -d com.apple.quarantine /Applications/WorkBuddy.app，否则首次启动会卡在权限拒绝 - 安装路径建议避开
C:\Program Files\（尤其 Windows Defender 会误报），改用D:\WorkBuddy\类路径更稳定 - 首次启动后若没弹出「Windows 防火墙」授权框，说明安装未触发服务注册，需重装
微信直连同步最简但有硬性前提
微信扫码绑定看似一步到位，实际依赖三个隐性条件：桌面端已登录、Claw 服务运行中、手机微信账号与桌面端登录账号**同属一个腾讯体系**（即用 QQ 或企业微信账号登录的桌面端，不能用微信个人号扫码）。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
- 扫码前确认桌面端右下角托盘图标为绿色且显示「就绪」，灰色代表
Claw未启动 - 手机微信扫出的二维码有效期仅 2 分钟，超时需在桌面端点击「重新生成」
- 绑定成功后，微信聊天窗口不会自动置顶，需手动在微信中搜索「WorkBuddy」进入对话
- 指令发送后桌面端无响应？检查是否被杀毒软件拦截了
WorkBuddy.exe的网络外联（尤其是 360、火绒）
企业微信/飞书/QQ 通道配置失败的高频原因
这些通道不是填完 ID 和 Secret 就能用，关键在平台侧权限是否真正生效。例如企业微信机器人创建后，若没在「可见范围」里把管理员加进去，扫码授权会静默失败；飞书应用若没在权限管理页用 JSON 导入完整字段，消息根本收不到。
- 企业微信：Bot ID 和 Secret 必须从「API 模式」创建页获取，「网页插件模式」生成的无效
- 飞书：App ID 和 App Secret 要从「企业自建应用」控制台获取，「小程序」或「开放平台应用」类型不兼容
- QQ：AppSecret 只在创建后明文显示一次，漏复制就只能删掉重来，没有找回入口
- 所有通道配置保存后，必须重启桌面端 WorkBuddy，否则新配置不加载
Android/iOS 移动端安装不是可选项而是同步必要环节
很多人以为只要桌面端配好微信就能在手机微信里发指令，其实移动端 APP 才是真正的「同步终端」——它负责把微信/企微等 IM 的指令转发给桌面端的 Claw 服务。没装移动端，微信里发的只是普通聊天，不会触发任何任务。
- Android 用户必须开启「设备管理权限」和「无障碍服务」，否则无法监听微信输入框内容
- iOS 用户只能通过 TestFlight 安装，官网下载页的「iOS 下载」按钮实际跳转的是邀请链接，没收到邀请则无法安装
- 移动端登录必须用和桌面端**完全一致的账号**（邮箱/微信/企微），混用会导致指令路由错乱
- 安卓 APK 必须从官网下载，第三方商店版本停留在 2025 年旧版，不支持新版
Claw协议
同步链路中最容易被忽略的一环是本地服务状态——所有通道都依赖桌面端的 Claw 进程持续运行，而它不像普通软件那样关掉就停，可能后台残留僵尸进程。遇到同步突然中断，先任务管理器结束所有 WorkBuddy.exe 和 ClawService.exe 实例，再重启客户端。
