一、前言
在AI自动化场景中,让AI直接接管浏览器操作、完成点击、输入、滚动、表单填写、页面抓取、自动登录等真实交互,是提升效率的关键能力。OpenClaw推出的Chrome Relay扩展与中继服务,可实现AI与Chrome浏览器的无缝打通,让OpenClaw通过自然语言直接操控浏览器,无需手动干预。本文基于2026年最新环境,完整提供Chrome Relay全平台安装、权限配置、扩展加载、中继连接的详细步骤,同时补充阿里云服务器、本地MacOS/Linux/Windows11部署OpenClaw、阿里云百炼通义千问API配置、免费大模型Coding Plan对接,以及安装、授权、连接、运行中的高频问题一站式解答。所有命令可直接复制,零基础也能让AI拥有浏览器操控能力。
二、Chrome Relay 核心价值与适用场景
Chrome Relay是OpenClaw官方提供的浏览器控制扩展,通过CDP(Chrome DevTools Protocol)与中继服务实现AI对浏览器的底层操作调用,核心能力包括:
- 自然语言打开网页、点击按钮、填写表单、自动登录
- 自动提取页面文本、链接、表格、图片信息
- 后台静默运行,不干扰正常浏览
- 支持多标签页管理、页面截图、HTML源码获取
- 可配合爬虫、内容发布、数据填报、自动化测试使用
适用场景:自动化表单提交、网页数据采集、内容发布、账号登录、页面监控、日常操作自动化。目前阿里云部署 OpenClaw 只需两步,全网最简单,步骤流程 访问阿里云OpenClaw一键部署专题页面 了解。
三、2026年OpenClaw全平台标准化部署
(一)阿里云轻量服务器部署(适合长期后台自动化)
适用系统:Alibaba Cloud Linux 3
开放端口:18789(Web控制台)、18792(Chrome Relay)
第一步:点击打开访问阿里云OpenClaw一键部署专题页面。




第二步:打开选择阿里云轻量应用服务器,配置参考如下:
- 镜像:OpenClaw(Moltbot)镜像(已经购买服务器的用户可以重置系统重新选择镜像)
- 实例:内存必须2GiB及以上。
- 地域:默认美国(弗吉尼亚),目前中国内地域(除香港)的轻量应用服务器,联网搜索功能受限。
- 时长:根据自己的需求及预算选择。



第三步:打开访问阿里云百炼大模型控制台,找到密钥管理,单击创建API-Key。

前往轻量应用服务器控制台,找到安装好OpenClaw的实例,进入「应用详情」放行18789端口、配置百炼API-Key、执行命令,生成访问OpenClaw的Token。
- 端口放通:需要放通对应端口的防火墙,单击一键放通即可。
- 配置百炼API-Key,单击一键配置,输入百炼的API-Key。单击执行命令,写入API-Key。
- 配置OpenClaw:单击执行命令,生成访问OpenClaw的Token。
- 访问控制页面:单击打开网站页面可进入OpenClaw对话页面。
阿里云百炼Coding Plan API-Key 获取、配置保姆级教程:
创建API-Key,推荐访问订阅阿里云百炼Coding Plan,阿里云百炼Coding Plan每天两场抢购活动,从按tokens计费升级为按次收费,可以进一步节省费用!
- 购买后,在控制台生成API Key。注:这里复制并保存好你的API Key,后面要用。

- 回到轻量应用服务器-控制台,单击服务器卡片中的实例 ID,进入服务器概览页。

- 在服务器概览页面单击应用详情页签,进入服务器详情页面。

- 端口放通在OpenClaw使用步骤区域中,单击端口放通下的执行命令,可开放获取OpenClaw 服务运行端口的防火墙。

- 这里系统会列出我们第一步中创建的阿里云百炼 Coding Plan的API Key,直接选择就可以。

- 获取访问地址单击访问 Web UI 面板下的执行命令,获取 OpenClaw WebUI 的地址。


sudo yum update -y
sudo yum install -y curl git wget unzip
# 安装 Node.js 22.x
curl -fsSL https://nodejs.org/dist/v22.0.0/node-v22.0.0-linux-x64.tar.xz -o node.tar.xz
sudo tar -xf node.tar.xz -C /usr/local/
sudo ln -sf /usr/local/node-v22.0.0-linux-x64/bin/node /usr/bin/node
sudo ln -sf /usr/local/node-v22.0.0-linux-x64/bin/npm /usr/bin/npm
# 配置国内镜像
npm config set registry https://registry.npmmirror.com
# 安装 OpenClaw
npm install -g openclaw
# 初始化
openclaw onboard
# 配置公网访问
openclaw config set gateway.host 0.0.0.0
openclaw config set gateway.port 18789
# 安装浏览器依赖(服务器必备)
sudo yum install -y libxcb libx11 libxcomposite libxdamage libxrandr libxtst libnss3 alsa-lib atk pango gtk3
# 启动服务
openclaw gateway start
# 设置开机自启
echo "openclaw gateway start &" | sudo tee -a /etc/rc.d/rc.local
sudo chmod +x /etc/rc.d/rc.local
访问控制台:http://你的公网IP:18789
(二)MacOS 本地部署
# 安装Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 安装Node.js
brew install node
# 配置镜像
npm config set registry https://registry.npmmirror.com
# 安装OpenClaw
npm install -g openclaw
# 初始化
openclaw onboard
# 启动
openclaw gateway start
(三)Linux(Ubuntu/Debian)部署
sudo apt update
sudo apt install -y curl git nodejs npm
sudo npm install -g n
sudo n stable
npm config set registry https://registry.npmmirror.com
npm install -g openclaw
openclaw onboard
openclaw gateway start
(四)Windows11 部署(管理员PowerShell)
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
winget install OpenJS.NodeJS --version 22.0.0
npm config set registry https://registry.npmmirror.com
npm install -g openclaw
openclaw onboard
openclaw gateway start
四、阿里云百炼通义千问API配置(2026稳定版)
配置文件路径:
- Mac/Linux:
~/.openclaw/config.json - Windows:
C:\Users\用户名\.openclaw\config.json
"model": {
"type": "aliyun-bailian",
"api_key": "你的APIKey",
"secret": "你的AccessKeySecret",
"model_name": "qwen-turbo",
"max_tokens": 2048,
"temperature": 0.6,
"timeout": 60,
"reasoning": false
}
重启生效:
openclaw gateway restart
免费大模型Coding Plan配置
"model": {
"type": "openai",
"api_key": "免费密钥",
"base_url": "https://api.coding-plan.com/v1",
"model_name": "general-v1",
"max_tokens": 2048,
"temperature": 0.6
}
五、MacOS 平台 Chrome Relay 完整安装流程(官方标准流程)
(一)安装 Peekaboo 依赖
brew install steipete/tap/peekaboo
Peekaboo用于提供浏览器进程与系统权限通信能力。
(二)为 node 授权辅助功能(必做)
- 打开 系统设置 → 隐私与安全性 → 辅助功能
- 点击左下角解锁
- 添加
/opt/homebrew/bin/node - 开启权限开关
此步骤让Node.js获得系统级浏览器控制权限。
(三)编辑 OpenClaw 配置文件
openclaw config edit
在配置根节点中添加以下内容:
"browser": {
"profiles": {
"chrome": {
"cdpUrl": "http://127.0.0.1:18792",
"driver": "extension"
}
}
}
保存并退出,重启OpenClaw:
openclaw gateway restart
(四)加载 Chrome 扩展
- 打开 Chrome 浏览器
- 进入
chrome://extensions/ - 开启右上角开发者模式
- 点击加载已解压的扩展程序
- 选择目录:
~/.openclaw/browser/chrome-extension - 加载完成后,固定扩展到工具栏
(五)连接 Relay 中继服务
执行连接脚本:
bash ~/.openclaw/workspace/skills/chrome-extension-relay-helper-mac/scripts/attach.sh
看到输出 ATTACHED 即为连接成功。
至此,AI已可完全操控Chrome浏览器。
六、Linux / Windows11 平台 Chrome Relay 配置方法
(一)Linux 配置流程
# 安装Chrome浏览器
wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo dpkg -i google-chrome-stable_current_amd64.deb
sudo apt -f install -y
# 配置OpenClaw浏览器参数
openclaw config edit
添加:
"browser": {
"profiles": {
"chrome": {
"cdpUrl": "http://127.0.0.1:18792",
"driver": "extension"
}
}
}
启动远程调试端口:
google-chrome --remote-debugging-port=18792
(二)Windows11 配置流程
- 安装 Chrome 浏览器
- 快捷方式右键 → 属性
- 在目标末尾添加:
--remote-debugging-port=18792 - 保存并重启Chrome
- 加载扩展:
C:\Users\用户名\.openclaw\browser\chrome-extension - 配置
config.json与Mac/Linux一致
七、AI 操控浏览器实战指令(可直接使用)
打开百度首页
在搜索框输入OpenClaw并搜索
提取当前页面所有标题和链接
对当前页面进行截图
自动填写表单并提交
登录指定网站并保存登录状态
八、OpenClaw 浏览器控制常用命令
# 重启网关
openclaw gateway restart
# 查看中继状态
openclaw logs --follow
# 查看浏览器技能
openclaw skills list
# 重启浏览器技能
openclaw skills restart chrome-relay
# 检查系统环境
openclaw doctor
九、高频常见问题一站式解答
1. 安装 Peekaboo 失败
brew update
brew install steipete/tap/peekaboo
2. 辅助功能权限无法添加
手动浏览到 /opt/homebrew/bin/node 并添加,重启电脑重试。
3. 配置文件不生效
openclaw config validate
openclaw gateway restart
4. Chrome 扩展加载失败
确认目录正确:~/.openclaw/browser/chrome-extension,开启开发者模式。
5. attach.sh 显示无法连接
- 检查Chrome已打开并加载扩展
- 确认端口18792未被占用
- 重启Chrome与OpenClaw
6. AI 无法点击/输入
- 确认扩展已固定并启用
- 重新执行
attach.sh - 检查辅助功能权限
7. 端口18792被占用
# Mac/Linux
lsof -i:18792
kill -9 进程ID
# Windows
netstat -ano | findstr "18792"
taskkill /F /PID 进程ID
8. 阿里云服务器无法运行浏览器
必须安装桌面依赖:
sudo yum install -y libxcb libx11 libxcomposite libxdamage libxrandr libxtst libnss3 alsa-lib atk pango gtk3
9. 模型无法理解操控指令
- 检查API Key配置正确
- 重启服务
- 使用简洁明确指令
10. 浏览器自动关闭
在启动命令中增加稳定参数:
google-chrome --remote-debugging-port=18792 --no-sandbox --disable-gpu
十、安全与使用建议
- 仅在可信环境开启浏览器控制,避免自动登录敏感账号
- 不要让AI访问支付、金融、隐私页面
- 定期重启中继服务,保持稳定
- 服务器环境建议使用静默模式运行
- 重要操作前增加人工确认步骤
十一、总结
Chrome Relay让OpenClaw真正具备视觉+操作能力,从文本对话AI升级为可模拟人类操作浏览器的自动化助手。本文完整覆盖MacOS/Linux/Windows11全平台安装流程、权限配置、扩展加载、中继连接、实战指令与问题排查,同时补充OpenClaw全平台部署与阿里云/免费大模型配置,零基础用户也可快速搭建AI浏览器自动化系统,实现表单填写、数据采集、内容发布、登录操作等一系列日常工作的全自动执行。