AionClaw浏览器助手连接成功需同时满足中继服务运行与扩展通信正常:执行openclaw gateway status确认browser.running为true,扩展面板显示ON且能执行screenshot或list-tabs命令返回有效结果。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要确认AionClaw的浏览器助手是否已连接成功,不能只看图标亮起或插件已安装,必须验证OpenClaw服务端与Chrome扩展之间的真实通信链路是否打通——因为插件处于“ON”状态但中继服务未运行,是新手最常卡住的环节。
检查浏览器中继服务运行状态
打开终端(Mac/Linux)或命令提示符(Windows),执行以下命令:
openclaw gateway status
观察输出中 browser.running 字段是否为 true。若显示 false 或 missing,说明中继服务未启动,后续所有网页控制都将失败。
如果未运行,先确保 OpenClaw 主程序正在后台运行(可通过菜单栏图标或任务管理器确认),再执行 openclaw gateway restart 强制重启网关。这一步必须完成,【否则扩展面板始终显示“中继不可达”】。
验证扩展面板中的连接状态
在 Chrome 浏览器右上角找到 AionClaw 扩展图标,点击→选择「管理扩展」→在扩展列表中找到 AionClaw 插件,点击右侧「详情」→下滑至「允许访问本地文件」和「在隐身模式下启用」两项必须开启。
返回浏览器任意标签页,再次点击扩展图标,弹出面板后观察当前标签页状态标识:
- ON:表示该标签页已被附加,AionClaw 可实时操控输入、点击、截图等
- …:表示正在尝试连接本地中继,等待 3~5 秒后仍未变 ON,大概率是网关未运行或端口被占用
- ! 中继不可达:最常见于 openclaw gateway 未启动,或配置中 browser.executablePath 路径错误
用命令行发起一次真实操作测试
方法一:直接触发页面快照
在终端执行:openclaw browser screenshot --tab-url "https://example.com"
若返回类似 {"success":true,"path":"/Users/xxx/.openclaw/screenshots/xxx.png"} 的 JSON 响应,并且对应路径下确实生成了 PNG 文件,即证明浏览器通道完全就绪。
方法二:查询当前打开的标签页
执行:openclaw browser list-tabs
正常应输出一个包含 url、title、id 的 JSON 数组。如果报错 connection refused 或 timeout,说明中继服务虽在运行但 CDP 协议握手失败,需检查 openclaw.json 中 browser.port 是否被其他进程占用(默认 9222)。











