在macOS上安装OpenClaw并实现Chrome网站自动化测试

在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

安装过程会有几个关键步骤,我建议这样选择:

  1. AI模型配置:选你有的API(Claude、GPT、GLM等都可以)
  2. 通信渠道 :初次使用选 "Skip for now",用终端TUI体验
  3. 技能安装 :也选 "Skip for now",后续按需安装
  4. 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

安装扩展

  1. 打开Chrome,进入 chrome://extensions/
  2. 开启右上角 "开发者模式"
  3. 点击 "加载已解压的扩展程序"
  4. 选择找到的包含manifest.json的文件夹

4.2 连接扩展与标签页

重要步骤:每次自动化测试前都需要:

  1. 打开Chrome,访问你要测试的网站(如 https://your-test-site.com
  2. 点击浏览器工具栏中的 OpenClaw扩展图标
  3. 图标从灰色变为彩色,表示连接成功

五、实战:网站自动化测试

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 安全注意事项

  1. 权限控制:在AI设置中明确禁止敏感操作(支付、删文件等)
  2. API密钥管理:不要将AI API密钥提交到Git仓库
  3. 测试隔离:在测试环境中进行自动化,避免影响生产数据

八、总结

经过一番折腾,我终于在macOS上成功搭建了基于OpenClaw的Chrome自动化测试环境。虽然中间遇到了Node版本、路径配置、扩展安装等问题,但一步步排查后都解决了。

OpenClaw的优势

  1. AI驱动:自然语言指令,不用写复杂脚本
  2. 深度集成:能操作浏览器、本地文件、应用程序
  3. 可扩展:技能系统可以不断添加新功能
  4. 本地优先:数据和控制都在本地,隐私性好

适用场景

  • 网站回归测试
  • 数据抓取与监控
  • 表单自动化填写
  • 跨平台工作流自动化

如果你也想尝试AI驱动的浏览器自动化,OpenClaw是个值得折腾的工具。虽然初期配置有点复杂,但一旦跑通,效率提升是非常明显的。

最后提醒:技术发展很快,安装时一定要查看OpenClaw官方最新文档,版本更新可能导致某些步骤变化。遇到问题可以在GitHub Issues中搜索,大概率有人遇到过了。

相关推荐
Lo-Y-eH5 小时前
Mac 安装 Ollama 部署 DeepSeek 模型
macos·ollama·deepseek·cherry studio
ziqi52220 小时前
第二十五天笔记
前端·chrome·笔记
仙剑魔尊重楼21 小时前
iMazing 3.1.3官方中文版新功能介绍
macos·objective-c·cocoa
hvang19881 天前
某花顺隐藏了重仓涨幅,通过chrome插件计算基金的重仓涨幅
前端·javascript·chrome
Genie cloud1 天前
在 Mac 上使用 Docker 安装宝塔并部署 LNMP 环境
macos·docker·容器·云计算
清蒸鳜鱼1 天前
【Mobile Agent——Droidrun】MacOS+Android配置、使用指南
android·macos·mobileagent
ID_180079054731 天前
Python调用1688商品详情API的实战示例与代码解析
开发语言·chrome·python
linweidong1 天前
屏幕尺寸的万花筒:如何在 iOS 碎片化生态中以不变应万变?
macos·ios·移动开发·objective-c·cocoa·ios面试·ios面经
学嵌入式的小杨同学1 天前
【Linux 实战】手写 ls 命令核心功能:C 语言实现文件属性与目录遍历(附完整可运行代码)
linux·运维·服务器·c语言·chrome·后端·ci/cd