手机端无法连接WorkBuddy是因Claw服务未正确暴露：需将监听地址改为0.0.0.0或局域网IP，放行18789端口，关闭AP隔离，并启用http_enabled、禁用proxy_forwarding。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已完成WorkBuddy桌面端安装并登录，但手机端（微信/企业微信/QQ等）始终无法建立连接，则问题极可能源于移动端接口未正确暴露或本地服务未对外可访问。以下是针对性排查与配置步骤：
一、确认Claw服务已启用且监听地址可被识别
Claw是WorkBuddy的远程通信协议模块，其HTTP/WebSocket服务必须处于运行状态，并绑定到允许局域网设备访问的网络接口，而非仅限localhost。若服务仅监听127.0.0.1，则手机端无法通过Wi-Fi直连。
1、打开WorkBuddy客户端，点击右上角个人头像，进入“个人中心”。
2、选择“Claw设置”，查看“服务状态”栏是否显示“已启动”及“监听地址”字段。
3、若监听地址为127.0.0.1:18789，则需手动修改为0.0.0.0:18789或本机局域网IP（如192.168.1.105:18789）。
4、在设置界面中找到“自定义监听地址”输入框，填入修改后的地址，点击“保存并重启服务”。
5、重启后再次检查状态栏，确认监听地址已更新且无红色错误提示。
二、关闭系统防火墙或放行Claw端口
Windows Defender防火墙或macOS“防火墙”默认拦截非签名应用的入站连接，Claw服务端口（默认18789）若未被显式允许，手机端发起的连接请求将被静默丢弃。
1、Windows用户：打开“控制面板”→“系统和安全”→“Windows Defender 防火墙”→“高级设置”，左侧选“入站规则”，右侧点“新建规则”。
2、选择“端口”，下一步后输入TCP 18789，再下一步选“允许连接”，最后命名为“WorkBuddy Claw”并启用。
3、macOS用户：前往“系统设置”→“隐私与安全性”→“防火墙”→“防火墙选项”，点击“+”号，定位到WorkBuddy.app，勾选“允许传入连接”。
4、重启WorkBuddy服务，确保新规则生效。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
三、验证本地网络直连能力（无中继模式）
该方法绕过所有IM平台中继，直接测试手机与电脑在局域网内的原始通信通路，用于快速定位是协议层问题还是网络层阻断。
1、在电脑端打开命令提示符（Windows）或终端（macOS），执行ipconfig（Windows）或ifconfig | grep "inet "（macOS），记录IPv4地址（如192.168.1.105）。
2、确保手机与电脑连接同一Wi-Fi，手机浏览器访问http://192.168.1.105:18789/ping（替换为实际IP）。
3、若页面返回{"status":"ok","claw":"active"}，说明接口已成功暴露；若显示“无法连接”或超时，则证明防火墙、监听地址或路由器AP隔离仍存在阻断。
4、若路由器开启AP隔离功能，需在路由器管理页中关闭该选项，否则同一Wi-Fi下设备间无法互相访问。
四、强制启用Claw HTTP服务并禁用代理转发
部分企业网络或安全软件会注入透明代理，导致Claw的Webhook回调地址被重写或劫持，使手机端指令无法抵达本地服务进程。
1、在WorkBuddy安装目录下找到config.yaml文件（Windows路径通常为C:\Program Files\WorkBuddy\config.yaml）。
2、用记事本或VS Code打开，查找claw:段落，确认包含以下两行且值为true：
3、http_enabled: true
4、disable_proxy_forwarding: true
5、保存文件后，**必须完全退出WorkBuddy进程**（右键托盘图标→“退出”），再重新启动。
