微信发送文件下载指令无响应时，需依次排查：一、验证claw通道心跳连通性；二、检查本地磁盘/目录访问权限；三、清理claw临时缓存并重置会话；四、切换为url回调模式绕过websocket阻断；五、确认本地8080端口可用并启用调试日志定位拦截点。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您通过微信向 WorkBuddy 发送文件下载指令（如“下载网盘链接中的PDF”或“保存聊天中发送的Excel”），但电脑端无响应、任务卡在“准备下载”或提示“文件获取失败”，则可能是远程通道中断、本地权限缺失或临时缓存异常所致。以下是解决此问题的步骤：
一、验证企业微信/微信客服号绑定状态与心跳连通性
WorkBuddy 依赖 Claw 协议维持与微信侧的长连接，若绑定 Token 失效、机器人被禁用或网络阻断 WebSocket，将导致指令无法抵达本地客户端，所有远程文件操作均会静默失败。
1、打开 WorkBuddy 主界面，点击右上角个人中心 → Claw 设置。
2、在“通讯工具”列表中定位已启用的微信类通道（如“企业微信-生产环境”或“微信客服号”），观察其状态标识：绿色对勾表示心跳正常，灰色感叹号表示已断连。
3、对显示断连的通道，点击“重新绑定”，按提示在手机端扫码并完成授权；若扫码后无响应，检查企业微信管理后台中该机器人是否处于“启用”状态且未达调用配额上限。
4、绑定成功后，在手机微信中向机器人发送测试二字，确认电脑端弹出响应提示框；若未弹出，说明底层连接仍未建立，需进入下一步排查。
二、检查本地文件系统访问权限是否完整授予
即使远程指令成功送达，WorkBuddy 在执行下载动作时仍需写入目标路径（如“下载”文件夹或用户指定目录），若操作系统未授权对应磁盘或子目录访问权限，任务将在准备阶段终止，日志中常出现“Access denied”或“Permission denied”错误。
1、Windows 用户：进入“设置 → 隐私和安全性 → 文件系统”，查找 WorkBuddy 条目，确保“下载”、“文档”、“桌面”及实际保存路径所在磁盘（如 D 盘）的开关均为开启状态。
2、macOS 用户：进入“系统设置 → 隐私与安全性 → 完全磁盘访问”，点击左下锁图标解锁，将 WorkBuddy.app 拖入列表并勾选；若此前已添加但失效，需先删除再重新拖入。
3、重启 WorkBuddy 客户端，使新权限立即生效；重启后再次尝试微信发送下载 test.txt等简易指令验证基础写入能力。
三、清理 Claw 临时下载缓存与重置通道会话
Claw 协议在传输大文件或中断重试过程中，可能在本地 C:/Users/[用户名]/WorkBuddy/Claw/tmp（Windows）或 ~/Library/Application Support/WorkBuddy/Claw/tmp（macOS）目录遗留损坏的临时块文件，导致后续下载请求被错误复用旧缓存而失败。
1、关闭 WorkBuddy 客户端，包括系统托盘/菜单栏中的进程。
2、打开文件管理器，导航至上述 tmp 目录路径，**全选并永久删除该目录下所有内容**（不删除 tmp 文件夹本身）。
3、重新启动 WorkBuddy，等待右下角/菜单栏图标稳定显示在线状态后，再次通过微信发送下载指令。
4、若仍失败，在微信中向机器人发送restore_bind指令，强制重建绑定关系并刷新会话密钥。
四、切换至 URL 回调模式绕过长连接限制
部分企业网络防火墙或代理策略会主动阻断 WebSocket 长连接（Claw 默认使用 443 端口上的 wss:// 协议），导致心跳包持续超时；此时可改用企业微信提供的 URL 回调模式，该模式基于标准 HTTPS POST 请求，兼容性更强，无需维持常驻连接。
1、登录企业微信管理后台，进入对应机器人配置页，点击“编辑”→ 切换接入方式为“URL 回调”。
2、复制页面生成的 Token 和 Encoding-AESKey 值。
3、在 WorkBuddy 的 Claw 设置中，对该通道点击“配置”，选择“URL 回调模式”，粘贴上述两项密钥，并保存。
4、系统将自动生成 Webhook URL，将其完整复制并回填至企业微信机器人配置页的“回调URL”字段，点击“保存并启用”。
5、在微信中发送ping指令，确认通道切换成功后，再执行文件下载操作。
五、手动触发文件下载并校验本地服务端口可用性
Claw 协议依赖本地 HTTP 服务（默认端口 8080）接收微信转发的文件元数据，若该端口被其他程序占用、被 Windows Defender 阻断或被公司安全软件拦截，将导致元数据无法解析，表现为“收到指令但无下载动作”。
1、按下 Win+R 输入 cmd，执行命令：netstat -ano | findstr :8080（Windows）或 lsof -i :8080（macOS），确认端口是否被占用。
2、若存在 PID 占用，记录该 PID，在任务管理器中结束对应进程；若无占用但仍失败，临时关闭 Windows Defender 实时防护或 macOS 防火墙。
3、在微信中发送指令：download debug_mode on，开启调试日志。
4、立即查看 WorkBuddy 安装目录下的 logs/claw_debug.log 文件，搜索关键词 file_url 或 http 403，定位具体拦截环节。
