QClaw在Mac上功能异常大概率是系统权限未正确授予；需确保“辅助功能”“完全磁盘访问”“输入监控”三项权限均手动添加并勾选，每次修改后必须重启QClaw，同时检查Rosetta设置、清除quarantine属性、重置TCC授权，并将OpenClaw网关权限设为full。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
QClaw在Mac上启动后功能异常、技能无响应或操作卡在“正在执行”，大概率是系统权限未正确授予，而非程序本身故障；macOS对辅助功能、完全磁盘访问和输入监控三项权限的校验极为严格，任一缺失都会导致核心能力失效。
确认三项关键权限是否已启用
QClaw必须同时获得“辅助功能”“完全磁盘访问”“输入监控”三项权限才能执行文件读写、窗口控制与键盘模拟等操作。仅勾选其中一项或部分勾选，会导致功能残缺。
前往「系统设置 → 隐私与安全性」，依次展开对应菜单：
① 点击「辅助功能」→ 右侧列表中查找 QClaw.app → 若未出现，点击左下角「+」号 → 在访达中定位到「应用程序」文件夹 → 选中 QClaw.app → 点击「添加」→ 确保其左侧复选框已被勾选。
② 点击「完全磁盘访问」→ 同样检查 QClaw 是否在列表中且已勾选；若缺失，同样通过「+」号手动添加。
③ 点击「输入监控」→ 执行相同添加与勾选流程。
【注意：每次添加后必须关闭并重新打开QClaw，否则新权限不会生效】
验证M芯片Rosetta兼容性设置
Apple Silicon设备若强制运行于Rosetta 2环境，可能使QClaw底层模块（如TTS引擎或Ollama桥接器）崩溃，表现为权限已开但技能始终返回空响应。
右键「应用程序」中的 QClaw.app → 「显示简介」→ 查看「使用 Rosetta 打开」选项：
若该选项被勾选，取消勾选并关闭窗口；若未勾选但功能异常，反向勾选并重启应用。
终端执行 arch 命令，输出必须为 arm64；若为 i386，说明系统仍在降级运行，需彻底清除Rosetta残留配置。
重置权限并强制刷新授权状态
macOS有时会缓存旧权限状态，即使界面显示已开启，实际调用仍被拒绝。此时需手动清除授权记录并触发系统重新校验。
方法一：终端重置命令
打开终端，执行：sudo tccutil reset All com.tencent.qclaw，输入管理员密码后回车。
方法二：手动清理授权数据库
执行：sudo rm -rf ~/Library/Application\ Support/com.apple.TCC/TCC.db，然后重启电脑——此操作将清空所有应用的隐私授权记录，重启后系统会重新提示QClaw申请权限。
【执行任一方法后，必须再次手动进入系统设置完成三项权限勾选，不可跳过】
检查Gatekeeper隔离属性是否残留
从官网下载的.dmg安装包会被自动打上 com.apple.quarantine 属性，即使已拖入“应用程序”文件夹，该属性仍可能干扰权限初始化流程，导致授权弹窗不出现或点击“允许”后无反应。
在终端中执行：sudo xattr -rd com.apple.quarantine /Applications/QClaw.app，输入密码确认。
执行完毕后，右键QClaw.app → 「打开」→ 在弹出的安全提示中点击「仍要打开」→ 此时系统将重新触发完整的权限申请流程。
验证OpenClaw网关工具权限级别
QClaw依赖OpenClaw网关调度技能，而网关默认限制工具执行权限。即使系统级权限全开，若网关未设为full profile，仍会报“我没有权限执行此操作”。
确保QClaw客户端正在运行，打开终端执行：openclaw config set tools.profile full。
执行成功后，点击QClaw界面右上角齿轮图标 → 「重启网关」→ 等待状态栏显示“网关已就绪”。
