收到“离线”提示说明微信指令未触达本地客户端，核心原因是远程控制通道未建立有效通信链路：一、确认workbuddy客户端在电脑后台真实运行且图标在线；二、检查微信clawbot绑定状态是否有效并重新扫码；三、验证claw服务心跳是否存活，通过/status指令检测；四、排查系统权限与openclaw沙箱通信阻断；五、校验微信版本≥8.0.45并重装更新。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在微信中向WorkBuddy发送指令后收到“离线”提示，说明手机端消息未能成功触达本地客户端，核心原因在于远程控制通道未建立有效通信链路。以下是多种可能成因及对应排查与修复操作：
一、验证本地WorkBuddy客户端是否真实运行
WorkBuddy必须在电脑后台持续运行并保持活跃状态，进程终止、被系统清理或启动失败均会导致微信端显示“离线”。需确认其实际运行状态与系统托盘/菜单栏可见性。
1、Windows用户按Ctrl+Shift+Esc打开任务管理器，在“进程”页签中搜索“workbuddy.exe”，确认存在且CPU/内存占用非零。
2、macOS用户打开“活动监视器”，在搜索栏输入“WorkBuddy”，检查进程状态是否为“正在运行”而非“已挂起”或“无响应”。
3、观察Windows系统右下角通知区域或macOS菜单栏右侧，是否存在WorkBuddy图标；若图标缺失或呈灰色，表明客户端未正常加载GUI服务。
4、右键该图标选择“显示主界面”，确认窗口中登录状态为已登录且在线标识为绿色，而非红色感叹号或“未连接”字样。
二、检查微信ClawBot绑定状态是否有效
微信与WorkBuddy之间依赖ClawBot插件建立长连接通道，绑定失效、二维码过期或未完成扫码确认将导致通道断开，表现为单向“离线”反馈。
1、打开WorkBuddy主界面，点击右上角个人中心 → Claw设置 → 查找「微信 ClawBot 集成」卡片。
2、若卡片显示“未绑定”或“绑定中”，说明绑定流程未完成；若显示“已绑定”但状态异常，点击右侧「解绑」后重新进入配置。
3、点击「配置」按钮，等待二维码生成（若长时间停留“绑定中”，请关闭窗口后重试或重启WorkBuddy）。
4、使用手机微信扫描弹出的二维码，须确保微信账号与电脑端登录账号一致，且网络通畅；扫码后卡片应立即变为“已绑定”并伴有震动提示。
三、确认Claw服务通道心跳是否存活
即使绑定完成，Claw通道仍需维持周期性心跳以维持连接，防火墙拦截、代理干扰或后台休眠策略可能导致心跳中断，触发自动降级为“离线”状态。
1、在WorkBuddy主界面左下角状态栏，查看Claw图标旁是否显示绿色“在线”标识；若为灰色或带斜杠，表示通道未激活。
2、Windows用户检查系统防火墙是否阻止了WorkBuddy的出站连接：进入“控制面板 → Windows Defender 防火墙 → 允许应用通过防火墙”，确认“WorkBuddy”在“专用”和“公用”网络中均勾选。
3、macOS用户前往“系统设置 → 网络 → 防火墙 → 防火墙选项”，查找WorkBuddy条目并确保其处于允许状态；若启用第三方安全软件，需临时禁用以排除干扰。
4、发送纯文本指令“/status”至微信中WorkBuddy对话窗口，等待5–8秒，观察是否返回含“Claw在线”字样的绿色状态反馈；若无响应或返回“Claw通道断连”，需执行通道重建。
四、排查系统级权限与沙箱通信阻断
Claw底层依赖OpenClaw沙箱机制实现跨平台指令转发，若系统拒绝WorkBuddy访问网络、辅助功能或完全磁盘访问权限，沙箱初始化失败将直接导致通道不可用。
1、Windows用户进入“设置 → 蓝牙和其他设备 → 更多蓝牙选项”，确认“允许蓝牙设备查找此电脑”已开启；同时检查“设置 → 隐私和安全性 → 后台应用”，确保WorkBuddy后台运行权限为开启。
2、macOS用户进入“系统设置 → 隐私与安全性 → 完全磁盘访问”，点击左下锁图标解锁，将WorkBuddy.app拖入列表并勾选；再进入“辅助功能”，同样添加并启用。
3、在终端（macOS）或PowerShell（Windows）中执行命令：openclawdoctor --ping，验证沙箱服务是否响应；若返回超时或错误，需运行openclawdoctor --fix进行自动修复。
4、重启WorkBuddy客户端，观察Claw图标是否恢复绿色在线状态，并再次发送“/status”确认通道重建完成。
五、校验微信客户端版本与ClawBot兼容性
旧版微信可能不支持ClawBot协议升级后的加密握手机制，导致扫码成功但后续通信握手失败，表面绑定成功实则通道静默断连。
1、在手机微信中点击“我 → 设置 → 关于微信”，确认版本号≥8.0.45；若低于此版本，请前往App Store或安卓应用市场更新。
2、卸载当前微信并清除全部缓存数据，重新安装最新正式版，避免测试版或灰度版本引入协议兼容问题。
3、更新完成后，重新执行ClawBot绑定流程：WorkBuddy端点击「配置」生成新二维码，微信扫码绑定，绑定过程中不得切换微信账号或退出登录。
4、绑定成功后，在微信中发送任意指令（如“你好”），观察WorkBuddy主界面是否自动切换至Claw标签页并弹出响应气泡；若无反应，重复步骤3并检查网络DNS是否污染。
