QClaw在Windows与macOS上功能差异源于权限模型、微信通信链路、文件系统、代理继承及插件加载机制不同：macOS依赖Info.plist声明与原生API，Windows受UAC、隐私设置、NTFS权限及系统代理影响。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在Windows或macOS上安装QClaw，发现某些功能响应异常或界面行为不一致，则可能是由于系统底层权限模型、硬件访问机制及安全策略差异所致。以下是针对不同操作系统的功能表现说明：
一、硬件权限调用能力差异
QClaw在macOS与Windows上申请的硬件权限范围不同，直接影响麦克风、摄像头、屏幕录制等敏感功能的实际可用性。macOS通过Info.plist声明权限并在首次调用时弹出系统级授权对话框；Windows则依赖应用安装时的UAC提示及后台服务注册状态。
1、在macOS上，QClaw明确声明了麦克风、摄像头和屏幕录制三项权限，用户未点击“允许”前，对应功能完全不可用。
2、在Windows上，QClaw安装过程会请求“始终允许后台运行”及“访问设备硬件”权限，但部分功能（如屏幕录制）需额外启用Windows设置中的“屏幕捕获权限”开关。
3、若某项功能在macOS上可正常调用，但在Windows上无响应，应检查Windows隐私设置中“相机”“麦克风”“后台应用权限”是否对QClaw开放。
二、微信关联流程表现差异
微信扫码绑定环节在两套系统中均生成相同二维码，但后续通信链路建立方式存在底层适配区别：macOS使用原生WebSocket连接微信客户端进程，Windows则通过兼容层注入微信桌面版IPC通道。
1、在macOS上，微信扫描后立即显示“已连接”，QClaw左侧栏同步出现微信会话入口，延迟通常低于800毫秒。
2、在Windows上，扫码后需等待微信桌面版完成一次完整心跳检测（约2–4秒），期间界面可能短暂显示“正在连接中”提示。
3、若Windows端出现“扫码成功但无法发送指令”现象，需确认微信桌面版版本不低于v3.9.10.27，且未开启“仅限Wi-Fi传输文件”限制。
三、本地文件系统交互差异
QClaw执行文件读写、路径解析、编码识别等操作时，依赖宿主系统提供的文件API。macOS使用统一的POSIX路径语义与APFS元数据接口，Windows则需处理NTFS权限继承、长路径支持开关及驱动器盘符映射问题。
1、在macOS上，QClaw可直接访问~/Desktop、~/Documents等符号链接目录，无需额外配置。
2、在Windows上，若用户启用了“Windows沙盒”或“受控文件夹访问”，QClaw进程必须被手动添加至“允许的应用列表”中，否则所有文件写入操作将被拦截并静默失败。
3、当指令中包含中文路径（如“打开D:\工作\报表.xlsx”），Windows版QClaw需确保系统区域设置中“Beta版：使用Unicode UTF-8提供全球语言支持”处于关闭状态，否则可能触发乱码或路径解析错误。
四、模型路由与网络代理行为差异
QClaw默认将所有AI请求经由腾讯代理层（https://mmgrcalltoken.3g.qq.com/aizone/v1）转发，但macOS与Windows对系统级代理配置的继承逻辑不同，影响实际请求出口。
1、macOS版QClaw默认忽略系统网络设置中的HTTP/HTTPS代理，仅遵循自身配置页中填写的代理地址。
2、Windows版QClaw会自动读取Internet选项中的LAN设置，若企业环境启用了PAC脚本或强制代理，可能导致请求被重定向至非腾讯节点，触发403拒绝访问错误。
3、在Windows上排查模型调用失败时，应优先在QClaw设置页中显式填写“不使用系统代理”，再测试直连效果。
五、插件加载与执行环境差异
QClaw内置的content-security插件与wechat-access插件在两平台上的加载时机与上下文隔离程度不同。macOS采用App Sandbox外的独立进程模型加载插件，Windows则复用主进程内存空间。
1、在macOS上，wechat-access插件启动后会创建专属WebSocket监听端口（默认52001），该端口不受系统防火墙默认规则影响。
2、在Windows上，同一插件需向系统注册为“网络服务”，若用户启用了第三方防火墙（如火绒、360），必须手动放行QClaw.exe对TCP 52001端口的出站连接。
3、content-security插件在macOS上可完整捕获全部HTTP请求头字段，而在Windows上因IE内核兼容层限制，部分自定义Header可能被自动剥离。
