在 macOS 上安装 OpenClaw 并实现 Chrome 网站自动化测试
OpenClaw 是一个开源的、可深度定制的个人 AI 助手框架，支持通过浏览器扩展控制 Chrome 进行自动化操作。本文记录在 macOS 环境下安装 OpenClaw 及配置 Chrome 自动化测试的完整流程。
一、OpenClaw 是什么？
OpenClaw 是一个开源的、可深度定制的个人 AI 助手框架。与普通聊天 AI 不同，它最大的特点是能直接操作你的电脑——访问本地文件、控制应用程序，特别是能通过浏览器扩展控制 Chrome 进行自动化操作。
你可以让 AI 助手自动测试网站功能、抓取数据、填写表单，甚至执行复杂的多步骤操作。
二、环境准备与安装
2.1 系统要求
- 操作系统：macOS 11 及以上
- Node.js：必须 ≥ v22.0.0
- 内存：4GB 以上
- 网络：需稳定访问外部 AI API
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
注意：务必先确认版本，旧版本可能导致命令报错退出。
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 中搜索，大概率有人遇到过了。
