macOS 上安装 OpenClaw 并实现 Chrome 网站自动化测试
一、OpenClaw 是什么？
OpenClaw 是一个开源的、可深度定制的个人 AI 助手框架。与普通聊天 AI 不同，它最大的特点是能直接操作电脑——访问本地文件、控制应用程序，特别是能通过浏览器扩展控制 Chrome 进行自动化操作。
你可以让 AI 助手自动测试网站功能、抓取数据、填写表单，甚至执行复杂的多步骤操作。
二、环境准备与安装
2.1 系统要求
- 操作系统：macOS 11 及以上
- Node.js：必须 ≥ v22.0.0（这是最容易踩的坑）
- 内存：4GB 以上（浏览器自动化比较吃内存）
- 网络：能稳定访问外部 AI API（需要用到 Claude、GPT 等大模型）
2.2 安装 Node.js 22+
如果 Node 版本太低，OpenClaw 会直接拒绝运行。使用 nvm 管理 Node 版本最方便：
# 安装 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 22+，旧版本可能导致命令报错退出。
2.3 一键安装 OpenClaw
官方提供了一键安装脚本：
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 错误，这是因为路径没配好。简单解决：
# 临时添加路径（当前终端有效）
export PATH="$HOME/.openclaw/bin:$PATH"
# 永久添加（推荐）
echo 'export PATH="$HOME/.openclaw/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
三、基础配置与启动
3.1 首次启动与身份设置
# 启动终端用户界面
openclaw tui
启动后，AI 会问你几个问题：
- 为 AI 起名：例如 Claw
- 你的名字：输入你的称呼
- AI 角色：例如高效可靠的数字助手
操作边界：重要！ 设置哪些操作需要确认（如发邮件、改文件等）
3.2 启动网关服务
浏览器控制需要网关服务，新开一个终端运行：
openclaw gateway
保持这个终端运行，不要关闭。
四、配置浏览器自动化功能
4.1 安装 Chrome 扩展
这是最关键但也最容易出问题的一步。OpenClaw 需要一个专门的浏览器扩展来连接 AI 和 Chrome。
查找扩展文件：
# 在 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 命令进行更精准的控制：
# 检查浏览器状态
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：Can't reach the openclaw browser control service
原因：网关服务未启动或扩展未连接 解决：
# 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 解决：
# 永久修复
echo 'export PATH="$HOME/.openclaw/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
问题 4：Node.js 版本错误
现象：openclaw requires Node >=22.0.0
解决：使用 nvm 切换到 22+ 版本
nvm install 22
nvm use 22
七、高级技巧与建议
7.1 技能按需安装
OpenClaw 采用模块化设计，不需要的技能不用装。等需要时再安装：
# 安装 PDF 处理技能
openclaw skill install nano-pdf
# 安装 GitHub 操作技能
openclaw skill install github
7.2 结合 CI/CD
你可以将 OpenClaw 浏览器自动化集成到 CI 流程中：
#!/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 中搜索，大概率有人遇到过了。
