屏幕控件识别失败主因是辅助功能权限未完整授予：windows需开启“允许应用控制你的设备”并单独授权openclaw进程；macos须完成全盘访问、辅助功能、自动化三项授权，且账户需具管理员权限并重启终端生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
确认系统辅助权限是否完整授予
屏幕控件识别失败，90%以上情况是系统未开放辅助功能权限，导致AionClaw无法获取UI元素树结构。Windows和macOS的授权逻辑完全不同，必须按对应系统逐项落实。
Windows用户请打开「设置 → 隐私和安全性 → 辅助功能」，将【允许应用控制你的设备】开关设为开，并确保下方「键盘」「鼠标」子项也处于启用状态；接着点击【管理应用权限】→ 在列表中找到OpenClaw（显示名可能是Openclaw Windows一键启动或gateway.exe）→ 若未出现，点右上角【+添加应用】→ 选择openclaw.exe所在路径手动添加。【仅开启全局权限无效，必须单独勾选AionClaw进程】
macOS用户需完成三项授权：先在「系统设置 → 用户与群组」中确认当前账户已勾选【允许用户管理这台电脑】；再依次进入「隐私与安全性」→「全盘访问」「辅助功能」「自动化」，全部点击「+」添加/Applications/OpenClaw.app；每次添加后必须关闭系统设置窗口并重启终端，否则权限不生效。
强制刷新UI缓存与重校准控件树
第一步：彻底退出AionClaw所有进程。打开任务管理器（Windows）或活动监视器（macOS），结束名称含openclaw、gateway、exec、clawagent的所有进程。
第二步：删除UI缓存文件。Windows用户前往安装目录下的openclaw\agents\main\sessions\sessions.json，直接删除该文件；macOS用户在终端执行rm ~/.openclaw/agents/main/sessions/sessions.json。这一步会清空历史会话快照，但不会影响模型配置、API密钥或已安装技能。
第三步：重启客户端后立即触发重校准。在主界面左侧导航栏点击「自动化（RPA）」→ 新建一个空白流程 → 拖入「等待页面加载」动作 → 紧接着添加「捕获屏幕控件」动作 → 点击「开始捕获」按钮，在目标窗口上悬停1秒后点击任意可操作区域。此时AionClaw会重建本地UI元素索引，耗时约3～8秒。
检查DPI缩放与多显示器适配冲突
方法一：临时关闭系统DPI缩放。Windows右键桌面 → 显示设置 → 缩放与布局 → 将「缩放」改为100% → 注销并重新登录。AionClaw默认按物理像素坐标定位，高DPI下坐标映射会偏移，导致“明明看到按钮却点不到”。
方法二：禁用多显示器扩展模式。若使用双屏或投屏，将副屏设置为“仅在1号显示器显示”，或断开副屏连接后测试。AionClaw当前版本对跨屏UI树合并支持不稳定，扩展模式下部分窗口控件可能无法被统一索引。
方法三：手动指定主显示器坐标系。在「工具管理 → 高级设置」中找到「RPA屏幕坐标基准」选项，从下拉菜单中选择你日常操作所在的显示器编号（如Display 1），保存后重启客户端。这能绕过自动识别错误，强制锁定坐标原点。
验证浏览器控件识别是否受渲染模式影响
如果你正在尝试识别Chrome/Firefox/Edge等浏览器内的按钮或输入框，请先关闭浏览器硬件加速：打开浏览器设置 → 系统 → 关闭【使用硬件加速模式（如果可用）】→ 重启浏览器。AionClaw依赖操作系统提供的UI Automation API读取网页控件，而硬件加速会将DOM渲染交由GPU直出，导致UI树不可见。
对于Electron类应用（如钉钉、飞书桌面版），需额外确认其窗口是否启用“无边框”或“透明背景”。这类设置会使窗口失去标准UI句柄，AionClaw无法挂载事件监听器。临时解决方案：在对应软件设置中关闭「无边框模式」或「深色透明效果」，再重试捕获。
若仍失败，可在「自动化（RPA）」流程中改用图像识别替代控件识别：添加「图像识别」动作 → 截取目标按钮区域作为模板图 → 设置相似度阈值为0.85以上 → 启用「点击中心点」选项。这种方式不依赖UI树，适合顽固性控件失联场景。
