必须放行8081端口并添加WorkBuddyAgent.exe程序规则，同时启用ICMPv4回显，否则Claw通道无法建立、远程控制功能全部失效。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

WorkBuddy Agent 的 8081 端口必须放行

WorkBuddy Local Agent 默认监听 8081 端口，用于接收远程调度指令（比如企业微信发来的任务、浏览器自动化触发等）。如果 Windows 防火墙没放行这个端口，Agent 会显示“连接断开”，Claw 通道无法建立，所有远程控制功能全部失效。

这不是可选步骤，是硬性前提。常见错误现象包括：Claw 连接状态为断开、Webhook URL 测试无响应、手机发指令后桌面端完全没反应。

• 打开 Windows 高级安全防火墙：wf.msc
• 右侧点击「新建规则」→ 选择「端口」→ 下一步
• 协议选 TCP，本地端口填 8081（不能写成 8081-8081 或其他范围）
• 操作选「允许连接」
• 网络类型至少勾选「专用」；若在公司内网或可信局域网，也可加选「域」；「公用」不建议开启
• 规则名称建议填 WorkBuddy-Agent-8081-TCP-专用，便于后续识别和管理

只开 8081 不够：还要确认 Agent 进程本身被允许通信

仅开放端口还不够。Windows 防火墙的「程序规则」优先级高于「端口规则」，如果 Agent 的可执行文件（如 WorkBuddyAgent.exe）被明确阻止，端口放行也会被覆盖。

务必检查是否已添加对应程序的入站规则，否则即使 netstat -ano | findstr :8081 显示监听中，外部仍无法连入。

• 在「入站规则」列表中搜索 WorkBuddy 或 Agent，看是否有已启用的规则
• 如果没有，新建规则 → 类型选「程序」→ 浏览定位到 WorkBuddyAgent.exe 的实际安装路径（如 C:\Program Files\WorkBuddy\Agent\WorkBuddyAgent.exe）
• 操作选「允许连接」，网络类型同上，只勾选「专用」
• 名称建议为 WorkBuddyAgent-Program-允许-专用

别漏掉 ICMP 回显：排查时最常卡在这一步

很多用户测试时用手机 ping 电脑 IP 发现不通，误以为是端口问题，其实只是防火墙默认禁用了 ICMP 回显请求。这不影响 WorkBuddy 功能，但会让基础连通性验证失败，干扰判断。

Workbuddy Add Memory

为WorkBuddy添加更智能的记忆管理功能：自动知识蒸馏→智能检索→工作前回忆

下载

尤其当你在异地组网或调试 Clow Webhook 可达性时，ping 不通容易误判为网络隔离。

• 以管理员身份运行 PowerShell 或 CMD
• 执行：netsh advfirewall firewall add rule name="允许ICMPv4回显" dir=in action=allow protocol=icmpv4:8,any enable=yes profile=private
• 验证是否生效：ping -n 1 本机IP 应返回正常响应

规则冲突和顺序问题真实存在

Windows 防火墙按从上到下顺序匹配规则，一旦某条「阻止」规则命中，后面所有「允许」规则都无效。如果你之前手动加过泛化规则（比如「阻止所有 TCP 入站」），或者第三方软件（如 360、腾讯电脑管家）注入了拦截策略，WorkBuddy 就会静默失败。

最稳妥的做法是：先禁用所有非必要第三方安全软件，再在 wf.msc 中临时禁用几条可疑的高优先级阻止规则，逐个测试。

• 在「入站规则」列表顶部，右键任意规则 → 「属性」→ 查看「常规」页中的「规则顺序」数值（越小越靠前）
• 重点关注规则名含 Block、Deny、Prevent 的项
• 临时禁用后测试 Claw 连接状态 是否恢复，再针对性调整或删除

WorkBuddy 的防火墙配置不是一次性动作，而是和 Agent 运行权限、IM 集成状态、网络环境强耦合的组合判断。最容易被忽略的是「程序规则」和「ICMP 回显」这两层——它们不出错时一切正常，一出错就找不到原因。