应先在windows安全中心添加workbuddy.exe放行规则并勾选“专用”和“公用”，再通过wf.msc为8080端口新建入站规则；若仍无效，需检查杀软是否拦截或macos全盘访问权限。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy 被 Windows 防火墙阻止联网怎么办
Windows 防火墙默认会拦截未明确放行的程序联网行为，WorkBuddy 启动后若无法连接 Claw 服务、QQ/企微 Bot 或 SkillHub，大概率是防火墙在出站方向（程序主动连外网）或入站方向（本地服务响应回调）上做了限制。
最直接有效的做法是手动添加放行规则，而不是关防火墙——后者会削弱系统防护，且重启后可能自动恢复拦截。
- 打开
Windows 安全中心→防火墙和网络保护→允许应用通过防火墙 - 点击
更改设置（需管理员权限），再点允许其他应用… - 浏览并选中 WorkBuddy 主程序：
C:\Program Files\WorkBuddy\WorkBuddy.exe（Windows 默认路径） - 勾选
专用和公用两项（尤其“公用”不能漏，否则企业微信/Claw 回调会失败） - 确认保存后，重启 WorkBuddy 观察 Claw 状态是否从灰色变为绿色“运行中”
Claw 服务端口被防火墙封禁怎么解
Claw 是 WorkBuddy 的本地 HTTP 服务，默认监听 127.0.0.1:8080，但 QQ/企微等平台回调时走的是公网可访问地址（如 http://your-ip:8080/webhook），此时需要入站规则而非仅放行程序本身。
只加“允许应用”不够，必须用高级防火墙单独开 8080 端口的入站通道。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
- 按
Win + R输入wf.msc打开高级安全 Windows Defender 防火墙 - 右键
入站规则→新建规则…→ 选择端口→ 下一步 - 协议选
TCP，特定本地端口填8080 - 操作选
允许连接，配置文件至少勾选专用（家用路由器环境通常属于此类型） - 规则名称建议写
Allow WorkBuddy Claw 8080，便于后续识别和管理
杀毒软件误报导致 WorkBuddy 进程被拦截
部分国产杀软（如 360、腾讯电脑管家）会把 WorkBuddy 的辅助功能注入、文件批量操作等行为判定为“高危行为”，不是防火墙问题，而是实时防护在进程级直接终止执行。
这类拦截不会弹窗提示，表现是 WorkBuddy 界面卡住、Claw 状态不更新、指令无响应，但任务管理器里 WorkBuddy.exe 进程存在却 CPU 占用为 0。
- 临时验证：右键杀软托盘图标 → 暂停实时防护（或进入设置关闭“主动防御”）→ 重启 WorkBuddy
- 长期方案：进入杀软设置 →
信任区/白名单→ 添加整个安装目录，例如C:\Program Files\WorkBuddy - 特别注意：某些杀软会劫持
hosts文件或重定向127.0.0.1，导致 Claw 本地服务无法绑定端口，此时需检查C:\Windows\System32\drivers\etc\hosts是否有异常条目
macOS 上类似问题要查什么
macOS 没有传统意义上的“防火墙拦截程序联网”提示，但系统自带的“防火墙”和“全盘访问”权限控制更严格，尤其影响 Claw 的 Webhook 响应能力。
常见现象是 QQ/企微能成功扫码绑定，但后续发消息无响应，后台日志显示 Connection refused。
- 前往
系统设置 → 隐私与安全性 → 防火墙，确认是否开启；如开启，点防火墙选项…→+ 添加→ 选中WorkBuddy.app - 更重要的是
全盘访问权限：同一页面下滑到完全磁盘访问→+→ 选中WorkBuddy.app（否则无法读取桌面/文档等路径，Claw 也无法正常启动 HTTP 服务） - 若用终端启动过 Claw，还需检查
sudo lsof -i :8080是否有其他进程占用了端口
