QClaw首次启动时Windows防火墙需勾选专用和公用网络并点“允许访问”，否则远程通道失效；若误点“取消”须手动在防火墙设置中启用对应条目；Mac系统无默认拦截，但第三方安全软件需手动放行openclawgateway。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
QClaw安装后首次启动时，Windows系统防火墙会弹出“是否允许应用通过Windows防火墙”的拦截窗口，若未及时勾选并点击“允许访问”，会导致远程通道无法建立、微信指令无响应、浏览器控制服务离线等连锁故障。
Windows系统中放行QClaw网络权限
第一步：在防火墙弹窗出现时，立即勾选【专用网络】和【公用网络】两个复选框；只勾选其一将导致局域网内微信远程失效或外网访问中断。
第二步：点击“允许访问”按钮。该操作不可逆——一旦点“取消”，弹窗不会再次自动触发，必须手动配置防火墙规则。
第三步：若已误点“取消”，打开“控制面板→系统和安全→Windows Defender 防火墙→允许应用或功能通过Windows Defender防火墙”，点击“更改设置”，在列表中找到QClaw（可能显示为openclawgateway或QClaw Agent），勾选对应条目中的“专用”和“公用”列，点击“确定”。
Mac系统中解除QClaw网络拦截
Mac系统不会弹出传统防火墙窗口，但部分第三方安全软件（如CleanMyMac、Intego、VirusBarrier）会在QClaw首次联网时静默拦截，表现为微信绑定卡在二维码扫描后无响应、控制台提示“disconnected (1008)”。
方法一：打开对应杀毒软件的“防火墙”或“网络防护”模块，查找进程名含openclawgateway或QClaw的条目，将其设为“允许全部网络连接”。
方法二：若不确定是哪款软件拦截，可临时退出所有第三方安全工具，再重启QClaw观察是否恢复；确认后重新启用，并单独为QClaw添加例外。
【注意】 macOS自带防火墙默认不拦截QClaw，无需额外配置；仅当安装了非Apple官方签名的安全软件时才需手动放行。
企业微信通道配置前的防火墙预检
使用企业微信作为远控通道时，QClaw需主动连接企业微信服务器（域名：qyapi.weixin.qq.com），若防火墙策略禁止出站HTTPS请求，将导致机器人状态始终显示“离线”。
① 打开QClaw设置→远控通道→企业微信→配置，确认bot_id与secret填写无误；
② 在防火墙高级设置中，新建出站规则：协议选TCP，目标端口填443，目标IP地址范围留空（或填119.29.29.29/32等腾讯云常用出口IP），操作设为“允许”；
③ 规则名称建议填“QClaw-WeCom-Outbound”，便于后续追踪；
④ 保存后重启QClaw，观察左下角状态栏是否出现“Enterprise WeChat: Online”。
