配置AionClaw浏览器自动化时,Managed Browser模式无需安装扩展,Extension Relay模式必须手动安装Chrome扩展;前者安全隔离、推荐默认使用,后者仅用于复用已登录会话但存在隐私与兼容性风险。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

配置 AionClaw 浏览器自动化时,是否需要安装浏览器扩展,取决于你选择的浏览器控制模式:Managed Browser(托管浏览器)完全不需要扩展,Extension Relay(扩展中继)则必须手动安装并启用特定 Chrome 扩展。两种路径在安全性、登录状态复用、部署复杂度上存在根本差异,选错会导致任务无法访问已登录网页或触发权限拒绝错误。
使用 Managed Browser 模式(推荐默认方案)
该模式启动一个独立隔离的 Chromium 实例,专供 AionClaw Agent 使用,与你的个人浏览器完全无关。
第一步:打开 AionClaw 客户端 → 点击左下角「设置」→ 进入「浏览器自动化」选项卡。
第二步:在「浏览器控制方式」下拉菜单中,确认已选择 【Managed Browser】(非 Extension Relay)。
第三步:点击「测试连接」按钮。若显示绿色“连接成功”,说明托管浏览器已就绪;此时无需安装任何扩展,也不需要打开 Chrome 或 Edge。
这一步操作起来很简单,直接点击就能验证。如果你之前手动装过 OpenClaw 的 relay 扩展,现在可以彻底卸载——它和 Managed Browser 冲突,装了反而导致 Gateway 启动失败。
使用 Extension Relay 模式(仅限复用现有登录态)
当你必须操作已经登录微信、飞书、银行后台等强会话依赖网站,且不愿重复扫码/输密时,才考虑此模式。它通过 Chrome 扩展桥接你的当前标签页,但会带来隐私风险和 macOS 兼容性问题。
方法一:自动安装(Windows 仅支持)
在「浏览器控制方式」中选择 Extension Relay → 点击「一键安装扩展」→ 等待提示「扩展已注入 Chrome」→ 重启 Chrome。
方法二:手动安装(全平台适用)
前往 AionClaw 安装目录下的 resources/extensions/relay 文件夹 → 找到 manifest.json 同级的 extension.crx 文件 → 打开 Chrome → 地址栏输入 chrome://extensions → 开启右上角「开发者模式」→ 将 extension.crx 拖入页面释放。
【必须关闭 Chrome 的“阻止来源不明的扩展”策略】,否则拖入后立即报错“此扩展程序未列在 Chrome 网上应用店中”。Windows 组策略或 macOS 终端命令需提前禁用该限制,否则安装必然失败。
方法三:从源码构建(高级用户)
克隆官方 relay 扩展仓库 → 运行 yarn build → 得到 unpacked 扩展文件夹 → 在 chrome://extensions 中点击「加载已解压的扩展程序」→ 选择该文件夹。


















