本地安装

推荐使用官方下载安装插件的方式，通过命令行下载

一、 将扩展安装到稳定的本地路径：

openclaw browser extension install

---

二、 打印已安装扩展的目录路径：

openclaw browser extension path
# mac电脑一般路径是：~/.openclaw/browser/chrome-extension

---

三、 Chrome → chrome://extensions

1. 启用”开发者模式”

2. “加载已解压的扩展程序” → 选择上面打印的目录
   

3. 如果是mac电脑，选择目录的时候可以使用快捷键 command+shift+G ，输入上面扩展的目录，注意需要用父目录，也就是 ~/.openclaw/browser/

   

---

四、 固定扩展

---

五、 配置插件

打开插件配置页面（一般情况首次安装插件会自动打开），如果没有打开，可以访问链接chrome-extension://mdjalbjoepffojegilgmpkmndpipbmoi/options.html，页面如下所示：

翻译成中文：

5.1 配置项解释：

中断连接配置项	含义
port	浏览器 Relay（中继，扩展连接用）端口号，默认18792
Gateway token	一个认证密码，用于验证 Chrome 扩展是否有权限连接到你的OpenClaw Gateway

5.2 通过命令行拿到port和Gateway token

获取浏览器relay端口号

openclaw browser status

获取Gateway token

cat ~/.openclaw/openclaw.json | grep '"token"' | grep -v "apiKey"

也通过自然语言告诉openclaw，它也可以帮你查出来token，中间有一个空格，⚠️注意复制后需要去掉空格

📋 如果想要看其他配置项，可以参考下面的命令

命令	效果
cat ~/.openclaw/openclaw.json	查看完整配置
cat ~/.openclaw/openclaw.json ｜ grep ‘“token”’	筛选所有 token 行
cat ~/.openclaw/openclaw.json ｜ grep -A5 ‘“auth”’	查看 auth 配置块
cat ~/.openclaw/openclaw.json ｜ grep ‘“port”’	查看端口配置
cat ~/.openclaw/openclaw.json ｜ grep ‘“gateway”’ -A10	查看 gateway 配置块

---

💡 小贴士

• grep -A5 表示匹配后多显示 5 行
• grep -v 表示排除匹配的行
• grep ‘“token”’ 精确匹配包含 “token” 的行

---

5.3 这里扩展说一下token，了解的小伙伴可以直接跳过

1. 身份验证

  扩展 → Gateway 连接时需要"证明身份"
  Token 就像是"钥匙"，只有知道正确 token 的扩展才能连接

2. 防止未授权访问

  如果没有 token：
    ❌ 任何恶意扩展都可以连接你的 Gateway
    ❌ 可能控制你的浏览器
    ❌ 可能访问你的数据

  有 token 保护：
    ✅ 只有知道 token 的扩展才能连接
    ✅ 本地安全隔离
    ✅ 防止其他应用冒用

3. 连接流程

---

4. 🔐 Token 从哪里来？

   Token 存储在你的 OpenClaw 配置文件中：

   位置： ~/.openclaw/openclaw.json

      {
        "gateway": {
          "auth": {
            "mode": "token",
            "token": "你的token"
          }
        }
      }
   

---

六、配置成功验证

第一步：查看浏览器配置页面展示

🎉 提示 Relay reachable and authenticated at http://127.0.0.1:18792/ 说明扩展已经成功连接到浏览器 relay服务！

第二步：连接标签页验证

操作步骤如下：

1. 打开一个新标签页，访问任意网站（如 https://www.jd.com）
2. 点击工具栏上的 OpenClaw Browser Relay 扩展图标
3. 扩展会连接到当前标签页，图标应该显示 ON 或变成绿色 ✅
   

---

总结

配置过程中主要就是关于Gateway token的配置容易出错，官方文档没有详细些这个配置

现在你的扩展已经认证成功啦！接下来连接一个标签页就可以使用openclaw对浏览器进行操作啦！

你可以在openclaw命令行说一下内容，来看一下实际效果：

 1.访问大疆创新官网
 2.搜索Pocket3
 3.进入Pocket3商品详情

openclaw会控制浏览器打开一个新的标签页进行操作，最终结果如下：

openclaw的输入结果如下：