🎯 智赢GEO - 龙虾版部署指南

Q: 为什么 Agent 在后台没有显示？

请检查 openclaw.json 中 workspace 路径是否指向了正确的 workspace 子目录。

Q: 飞书机器人回复很慢或不回复？

确认 connectionMode 为 websocket 且应用已发布，同时检查 OpenClaw 的运行日志。

本指南将手把手教你如何在 OpenClaw 环境中部署并通过 飞书机器人 运行 GEO 优化大师。

📖 环境准备

在开始之前，请确保你已经安装并正常运行了 OpenClaw。

🚀 部署步骤

第一步：安置项目目录

GEO Master 的代码文件夹（geo-master）可以放置在您电脑上的 任意位置。

例子：假设您将文件夹放在了：/Users/您的用户名/Documents/openclaw-geo-master

IMPORTANT

请记住这个 绝对路径，接下来的配置步骤中需要用到它。

第二步：注册并验证 Agent

在配置通信通道之前，我们先让 OpenClaw 系统识别并加载 GEO Master。

1. 修改 `openclaw.json`

打开 ~/.openclaw/openclaw.json，在 "agents" -> "list" 数组中添加 GEO Master 的定义：

{
  "id": "agent-geo-master",
  "name": "GEO优化大师",
  "workspace": "这里填入你第一步中的项目绝对路径/workspace",
  "identity": {
    "name": "GEO优化大师",
    "emoji": "🎯"
  }
}

2. 后台验证状态

保存文件并重启 OpenClaw。随后进入 OpenClaw 的控制台/后台界面，检查 Agent 列表：

确认是否出现了名为 「GEO优化大师」 的 Agent。

CAUTION

必须先确保 Agent 在后台成功加载，再进行后续的飞书配置！

第三步：配置飞书通信通道

确保 Agent 正常工作后，我们来配置飞书机器人。

1. 创建主账号飞书机器人应用

在飞书开放平台点击「创建自建应用」创建应用。
登录飞书开放平台，在「凭证与基础信息」中获取 App ID 和 App Secret。
在「添加应用能力」中开启 机器人 能力。

配置权限：在应用后台的「权限管理」->「批量导入/导出权限」，复制以下内容。

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:read",
      "cardkit:card:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "event:ip_list",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
  }
}

在「版本管理与发布」中发布一个新版本。
配置事件订阅：在飞书开放平台进入「事件与回调」→ 选择「使用长连接接收事件」（WebSocket）→ 添加事件 im.message.receive_v1。配置前请确保已执行过 openclaw channels add 且网关已运行（openclaw gateway status）。详见 OpenClaw 文档：配置事件订阅。

更多详情：关于事件订阅等完整步骤，请参考 OpenClaw 官方文档：飞书配置。

2. 配置主账号飞书

若已完成 OpenClaw 安装，可通过 CLI 添加飞书通道：在终端执行下方命令，选择 Feishu，按提示输入刚才在开放平台获取的 App ID 和 App Secret。

openclaw channels add

配置完成后可运行下方命令重启网关：

openclaw gateway restart

更多说明见 OpenClaw 飞书配置 - CLI 方式。

3. 配置多账号(GEO飞书账号)

继续修改 ~/.openclaw/openclaw.json：

重要说明

请先按上文 「1. 创建主账号飞书机器人应用」 的步骤，在飞书开放平台再创建一个新的飞书应用（作为 GEO 专用机器人），获取其 App ID 与 App Secret，以便后续在 openclaw.json 中配置多账号。

A. 添加 Feishu 账号（在 channels 下）：

这里我们采用「多账号」模式。注意，某些全局配置项（如 connectionMode）应放在通道根部，而账号特有信息则放在 accounts 下。

"feishu": {
  "enabled": true,
  "connectionMode": "websocket",
  "domain": "feishu",
  "dmPolicy": "pairing",
  "accounts": {
    "feishu_default": {
      "appId": "主账号_App_ID",
      "appSecret": "主账号_App_Secret",
      "groupPolicy": "allowlist",
      "streaming": "partial"
    },
    "feishu_geo": {
      "appId": "GEO大师_App_ID",
      "appSecret": "GEO大师_App_Secret",
      "groupPolicy": "allowlist",
      "streaming": "partial"
    }
  }
}

B. 配置路由绑定（在顶层 bindings 下）：

指明当消息通过哪个飞书账号进入时，分发给哪个 Agent 处理。

"bindings": [
  {
    "agentId": "agent-geo-master",
    "match": {
      "channel": "feishu",
      "accountId": "feishu_geo"
    }
  },
  {
    "agentId": "main",
    "match": {
      "channel": "feishu",
      "accountId": "feishu_default"
    }
  }
]

第四步：配置 Chrome 爬虫

GEO 大师需要通过 Chrome 浏览器的远程调试协议来进行网络请求监听和网页数据抓取。请按以下步骤配置。

1. 安装 Chrome 浏览器

前往 Chrome 官网下载并安装最新版本的 Google Chrome 浏览器。

2. 以调试模式启动 Chrome

打开终端，执行以下命令启动带远程调试功能的 Chrome：

/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \
  --remote-debugging-port=9222 \
  --user-data-dir="你的项目绝对路径/workspace/chrome_automation"

示例（假设项目在 /Users/您的用户名/Documents/openclaw-geo-master）：

/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \
  --remote-debugging-port=9222 \
  --user-data-dir="/Users/您的用户名/Documents/openclaw-geo-master/workspace/chrome_automation"

IMPORTANT

--user-data-dir 必须指向项目内的 workspace/chrome_automation 目录。该目录已预先创建，Chrome 启动后会自动在其中生成用户数据文件。

📖 参数说明

参数	含义	说明
--remote-debugging-port	调试端口	设置为 `9222`，用于与 MCP chrome-devtools 通信。
--user-data-dir	用户数据目录	指定独立的 Chrome 用户配置目录，与日常使用的 Chrome 隔离，避免冲突。

3. 验证是否启动成功

命令执行成功后，会自动弹出一个新的 Chrome 浏览器窗口。这就是专用于调试的浏览器实例，后续 GEO 大师的网络监听和数据抓取都将通过这个窗口进行。

TIP

建议将启动命令保存为脚本或快捷方式，方便日后快速启动。

第五步：安装 Agent Browser

agent-browser 是一款面向 AI Agent 的无头浏览器自动化 CLI 工具（基于 Rust 构建，高性能），GEO 大师依赖它进行网页数据抓取。

1. 全局安装（推荐）

npm install -g agent-browser

2. 下载 Chromium 内核

agent-browser install

3. 验证安装

agent-browser --version

如果正常输出版本号，说明安装成功。

NOTE

更多详细安装信息请参考： agent-browser GitHub 仓库。

🧪 功能验证

全部配置完成后，再次 重启 OpenClaw。

在飞书中搜索并勾搭你刚才创建的机器人。
发送指令进行测试：
「帮我分析一下武汉。哪家烧饼最好吃？」
预期效果：GEO 大师会立即响应，输出关键词并撰写优化文章。

❓ 常见问题

Q: 为什么 Agent 在后台没有显示？
A: 请检查 openclaw.json 中 workspace 路径是否指向了正确的 workspace 子目录。

Q: 飞书机器人回复很慢或不回复？
A: 确认 connectionMode 为 websocket 且应用已发布，同时检查 OpenClaw 的运行日志。

NOTE

祝你在飞书上使用 GEO 优化大师体验愉快！

🎯 智赢GEO - 龙虾版 部署指南

📖 环境准备

🚀 部署步骤

第一步：安置项目目录

第二步：注册并验证 Agent

1. 修改 openclaw.json

2. 后台验证状态

第三步：配置飞书通信通道

1. 创建主账号飞书机器人应用

2. 配置主账号飞书

3. 配置多账号(GEO飞书账号)

第四步：配置 Chrome 爬虫

1. 安装 Chrome 浏览器

2. 以调试模式启动 Chrome

📖 参数说明

3. 验证是否启动成功

第五步：安装 Agent Browser

1. 全局安装（推荐）

2. 下载 Chromium 内核

3. 验证安装

🧪 功能验证

❓ 常见问题

🎯 智赢GEO - 龙虾版部署指南

1. 修改 `openclaw.json`