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

最近在折腾个人AI助手，发现了一个叫OpenClaw（原名Clawdbot）的神器。它不仅是个AI助手，还能控制浏览器做自动化测试！折腾了一下午终于跑通了，记录下完整过程。

首屏导读 · 本教程配套付费专栏： 大模型工程师修炼手记19.9 元（AI 编程 / Agent 实战 ｜ 本文同主题系统课程）· AI时代程序员的自我提升49.9 元（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版本最方便：

# 安装nvm（如果还没安装）curl-o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh|bash# 安装Node.js 22nvminstall22nvm use22# 验证版本node-v# 应该显示 v22.x.x

避坑提示：我之前用Node 21.7.3，安装时一堆警告，最后openclaw命令直接报错退出。务必先确认版本！

2.3 一键安装OpenClaw

官方提供了一键安装脚本：

curl-fsSLhttps://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错误，这是因为路径没配好。简单解决：

# 临时添加路径（当前终端有效）exportPATH="$HOME/.openclaw/bin:$PATH"# 永久添加（推荐）echo'export PATH="$HOME/.openclaw/bin:$PATH"'>>~/.zshrcsource~/.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"$(npmprefix-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命令进行更精准的控制：

# 检查浏览器状态openclaw browser status# 打开测试网站openclaw browseropenhttps://example.com# 截图保存（非常实用！）openclaw browser screenshot --full-page# 获取页面快照（分析DOM结构）openclaw browser snapshot# 点击特定元素（通过ref引用）openclaw browser click12# 填写表单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

原因：网关服务未启动或扩展未连接
解决：

# 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"'>>~/.zshrcsource~/.zshrc

问题4：Node.js版本错误

现象：openclaw requires Node >=22.0.0
解决：使用nvm切换到22+版本

nvminstall22nvm use22

七、高级技巧与建议

7.1 技能按需安装

OpenClaw采用模块化设计，不需要的技能不用装。等需要时再安装：

# 安装PDF处理技能openclaw skillinstallnano-pdf# 安装GitHub操作技能openclaw skillinstallgithub

7.2 结合CI/CD

你可以将OpenClaw浏览器自动化集成到CI流程中：

#!/bin/bash# 自动化测试脚本示例openclaw browseropen$TEST_URLopenclaw 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中搜索，大概率有人遇到过了。

href="https://csdnimg.cn/release/blogv2/dist/mdeditor/css/editerView/markdown_views-e1cc28b339.css" rel="stylesheet"> href="https://csdnimg.cn/release/blogv2/dist/mdeditor/css/style-d1e89cace4.css" rel="stylesheet">

---

延伸阅读 · 我的付费专栏

觉得这篇文章对你有帮助？我把同类主题的系统化内容沉淀成了付费专栏，欢迎订阅支持持续输出：

专栏	定价	内容
大模型工程师修炼手记	19.9 元	AI 编程 / Agent 深度实战
AI时代程序员的自我提升	49.9 元	AI 时代成长方法论

本文配套代码 / 资料包：欢迎在评论区留言「求代码」，我会私信发送完整资源！