🎯 OpenClaw 智赢 GEO 部署指南

本指南将手把手教你如何在 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 列表：

CAUTION

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

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

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

1. 创建飞书机器人应用

  1. 登录 飞书开放平台，点击「创建自建应用」。
  2. 在「凭证与基础信息」中获取 App ID 和 App Secret。
  3. 在「添加应用能力」中开启 机器人 能力。
  4. 在「版本管理与发布」中发布一个新版本（开启 WebSocket 模式）。
  5. 更多详情：关于权限设置、事件订阅等完整步骤，请参考 OpenClaw 官方文档：飞书配置。

2. 配置 openclaw.json 通道与路由

继续修改 ~/.openclaw/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"
    }
  }
}

📖 字段含义详解

字段名 含义 说明
enabled 是否启用 设置为 true 开启飞书通道。
connectionMode 连接模式 推荐 websocket（长连接），无需公网回调地址即可接收消息。
domain 区域域名 国内版飞书填 feishu，海外版 Lark 填 lark。
dmPolicy 私聊策略 pairing 表示新用户需手动进行「配对」验证后才能对话。
accounts 账号列表 核心配置项，用于支持挂载多个不同的飞书机器人应用。
appId 应用 ID 在飞书开放平台「凭证与基础信息」中获取。
appSecret 应用秘钥 在飞书开放平台「凭证与基础信息」中获取，请妥善保管。
groupPolicy 群聊策略 allowlist 表示只响应允许列表中的群组；disabled 则禁用群聊。
streaming 流式输出 partial 表示部分流式（常见推荐值），full 表示全程流式。

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

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

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

🧪 功能验证

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

  1. 在飞书中搜索并勾搭你刚才创建的机器人。
  2. 发送指令进行测试：
    「帮我分析一下：如何通过 GEO 优化提升网站流量？」
  3. 预期效果：GEO 大师会立即响应，输出关键词并撰写优化文章。

❓ 常见问题

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

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

NOTE

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