在macOS上安装OpenClaw并实现Chrome网站自动化测试
最近在折腾个人AI助手,发现了一个叫OpenClaw(原名Clawdbot)的神器。它不仅是个AI助手,还能控制浏览器做自动化测试!折腾了一下午终于跑通了,记录下完整过程。
一、OpenClaw是什么?
OpenClaw 是一个开源的、可深度定制的个人AI助手框架。和普通聊天AI不同,它最大的特点是能直接操作你的电脑 ------访问本地文件、控制应用程序,特别是能通过浏览器扩展控制Chrome进行自动化操作。
想象一下:你可以让AI助手自动测试你的网站功能、抓取数据、填写表单,甚至执行复杂的多步骤操作。下面就是我的实战记录。
二、环境准备与安装
2.1 系统要求
- 操作系统:macOS 11及以上(我用的macOS 11,稍微老点也能跑)
- Node.js :必须 ≥ v22.0.0(这是最容易踩的坑!)
- 内存:4GB以上(浏览器自动化比较吃内存)
- 网络:能稳定访问外部AI API(需要用到Claude、GPT等大模型)
2.2 安装Node.js 22+
如果你的Node版本太低,OpenClaw会直接拒绝运行。用nvm管理Node版本最方便:
bash
# 安装nvm(如果还没安装)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 安装Node.js 22
nvm install 22
nvm use 22
# 验证版本
node -v # 应该显示 v22.x.x
避坑提示 :我之前用Node 21.7.3,安装时一堆警告,最后
openclaw命令直接报错退出。务必先确认版本!
2.3 一键安装OpenClaw
官方提供了一键安装脚本:
bash
curl -fsSL https://openclaw.bot/install.sh | bash
安装过程会有几个关键步骤,我建议这样选择:
- AI模型配置:选你有的API(Claude、GPT、GLM等都可以)
- 通信渠道 :初次使用选 "Skip for now",用终端TUI体验
- 技能安装 :也选 "Skip for now",后续按需安装
- Hooks功能:继续跳过,保持简单
安装完可能会遇到openclaw: command not found错误,这是因为路径没配好。简单解决:
bash
# 临时添加路径(当前终端有效)
export PATH="$HOME/.openclaw/bin:$PATH"
# 永久添加(推荐)
echo 'export PATH="$HOME/.openclaw/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
三、基础配置与启动
3.1 首次启动与身份设置
bash
# 启动终端用户界面
openclaw tui
启动后,AI会问你几个问题:
- 为AI起名:我起了"Claw"
- 你的名字:输入你的称呼
- AI角色:我选了"高效可靠的数字助手"
- 操作边界 :重要! 设置哪些操作需要确认(如发邮件、改文件等)

3.2 启动网关服务
浏览器控制需要网关服务,新开一个终端运行:
bash
openclaw gateway
保持这个终端运行,不要关闭。
四、配置浏览器自动化功能
4.1 安装Chrome扩展
这是最关键但也最容易出问题的一步。OpenClaw需要一个专门的浏览器扩展来连接AI和Chrome。
查找扩展文件:
bash
# 在OpenClaw目录中搜索扩展
find ~/.openclaw -name "*.crx" -o -name "manifest.json" 2>/dev/null
# 如果在全局node_modules中
find "$(npm prefix -g)/lib/node_modules/openclaw" -name "manifest.json" -path "*/extension/*" 2>/dev/null
安装扩展:
- 打开Chrome,进入
chrome://extensions/ - 开启右上角 "开发者模式"
- 点击 "加载已解压的扩展程序"
- 选择找到的包含
manifest.json的文件夹
4.2 连接扩展与标签页
重要步骤:每次自动化测试前都需要:
- 打开Chrome,访问你要测试的网站(如
https://your-test-site.com) - 点击浏览器工具栏中的 OpenClaw扩展图标
- 图标从灰色变为彩色,表示连接成功
五、实战:网站自动化测试
5.1 基本浏览器控制
在OpenClaw TUI中,可以直接让AI操作浏览器:
你:打开百度首页
Claw:正在打开 https://www.baidu.com
你:在搜索框输入"OpenClaw自动化测试"
Claw:已定位搜索框并输入文本
你:点击"百度一下"
Claw:已点击搜索按钮


5.2 使用专用浏览器命令
除了通过AI对话,还可以直接用CLI命令进行更精准的控制:
bash
# 检查浏览器状态
openclaw browser status
# 打开测试网站
openclaw browser open https://example.com
# 截图保存(非常实用!)
openclaw browser screenshot --full-page
# 获取页面快照(分析DOM结构)
openclaw browser snapshot
# 点击特定元素(通过ref引用)
openclaw browser click 12
# 填写表单
openclaw browser fill --fields '[{"ref":"username", "value":"testuser"}, {"ref":"password", "value":"test123"}]'
5.3 自动化测试脚本思路
你可以让AI执行完整的测试流程:
1. 导航到登录页面
2. 输入用户名和密码
3. 点击登录按钮
4. 验证跳转后的页面标题
5. 检查登录成功提示是否存在
6. 执行注销操作
7. 验证返回登录页面
六、常见问题与解决方案
问题1:Can't reach the openclaw browser control service
原因 :网关服务未启动或扩展未连接
解决:
bash
# 1. 确保网关运行
openclaw gateway status
# 2. 重新启动网关
openclaw gateway stop
openclaw gateway
# 3. 在Chrome中确认扩展已连接
问题2:Chrome extension relay is running, but no tab is connected
原因 :扩展已安装,但未连接到当前标签页
解决 :在你要控制的网页上点击一次扩展图标,使其变为彩色。
问题3:openclaw: command not found
原因 :安装路径未加入系统PATH
解决:
bash
# 永久修复
echo 'export PATH="$HOME/.openclaw/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
问题4:Node.js版本错误
现象 :openclaw requires Node >=22.0.0
解决:使用nvm切换到22+版本
bash
nvm install 22
nvm use 22
七、高级技巧与建议
7.1 技能按需安装
OpenClaw采用模块化设计,不需要的技能不用装。等需要时再安装:
bash
# 安装PDF处理技能
openclaw skill install nano-pdf
# 安装GitHub操作技能
openclaw skill install github
7.2 结合CI/CD
你可以将OpenClaw浏览器自动化集成到CI流程中:
bash
#!/bin/bash
# 自动化测试脚本示例
openclaw browser open $TEST_URL
openclaw browser screenshot --full-page --output ./test-result.png
openclaw browser evaluate --fn "() => document.title" --expect "首页"
7.3 安全注意事项
- 权限控制:在AI设置中明确禁止敏感操作(支付、删文件等)
- API密钥管理:不要将AI API密钥提交到Git仓库
- 测试隔离:在测试环境中进行自动化,避免影响生产数据
八、总结
经过一番折腾,我终于在macOS上成功搭建了基于OpenClaw的Chrome自动化测试环境。虽然中间遇到了Node版本、路径配置、扩展安装等问题,但一步步排查后都解决了。
OpenClaw的优势:
- AI驱动:自然语言指令,不用写复杂脚本
- 深度集成:能操作浏览器、本地文件、应用程序
- 可扩展:技能系统可以不断添加新功能
- 本地优先:数据和控制都在本地,隐私性好
适用场景:
- 网站回归测试
- 数据抓取与监控
- 表单自动化填写
- 跨平台工作流自动化
如果你也想尝试AI驱动的浏览器自动化,OpenClaw是个值得折腾的工具。虽然初期配置有点复杂,但一旦跑通,效率提升是非常明显的。
最后提醒:技术发展很快,安装时一定要查看OpenClaw官方最新文档,版本更新可能导致某些步骤变化。遇到问题可以在GitHub Issues中搜索,大概率有人遇到过了。