LobsterAI 机器人配置指南

📖 本指南将手把手教你如何在钉钉和飞书中配置 LobsterAI 的 IM 机器人(双向对话)和 Webhook 机器人(单向推送),小白也能轻松上手!

支持的平台:

  • ✅ 微信（WeChat）
  • ✅ 钉钉 (DingTalk)
  • ✅ 飞书 (Feishu/Lark)
  • ✅ 企业微信（WeCom）
  • ✅ QQ（QQ-BOT）

配置类型:

  • 🤖 IM 机器人(Stream 模式): 双向对话,可以问答交互
  • 📢 Webhook 机器人: 单向推送通知,适合定时推送、报警等场景

IM 机器人 vs Webhook 机器人

核心区别

特性 IM 机器人 (Stream 模式) Webhook 机器人
通信方向 双向对话(你 ↔ LobsterAI) 单向推送(LobsterAI → 群聊)
能否对话 ✅ 可以问答、多轮对话 ❌ 不能对话,只能推送通知
会话记录 ✅ 有完整会话记录 ❌ 无会话历史
配置难度 ⚠️ 较复杂,需要企业认证和权限申请 ✅ 超简单,1-2分钟搞定
适用场景 个人助手、问答交互 定时通知、报警推送、报表分发
多群使用 一个机器人可加多个群 每个群独立配置

简单记忆:

  • IM 机器人 = 你的私人助手(你问我答)
  • Webhook 机器人 = 你的广播电台(只播不收)

微信 IM 机器人配置

准备工作

在开始之前，请确保你已经:

  1. 把有道龙虾升级到 2026.3.22 版本及以上
  2. 微信的版本升级到 8.0.70（iOS 端）或 8.0.69（Android端）及以上

配置步骤

步骤 1: 打开有道龙虾的微信的 IM 配置界面

打开有道龙虾，导航至：设置 -> IM 配置 -> 微信

微信配置界面

步骤 2: 打开微信连接二维码

在微信配置界面，点击“扫码连接微信”，即可弹出一个二维码

扫码连接微信

步骤3：使用微信进行扫码

使用微信扫描上述二维码，在弹出的页面中点击“连接”，之后等待龙虾段的页面刷新

微信扫码后页面

步骤4：等待龙虾端页面刷新，并保存

龙虾端页面刷新

步骤5：开始在微信指挥你的龙虾帮你干活

微信指挥龙虾干活

钉钉 IM 机器人配置

准备工作

在开始之前,请确保你已经:

  • ✅ 已注册钉钉账号
  • ✅ 已加入或创建企业组织(如无法创建企业组织,可创建家庭组织)
  • ✅ 具备企业管理员或开发者权限

配置步骤

步骤 1: 进入钉钉开放平台

访问钉钉开放平台: https://open.dingtalk.com

钉钉开放平台首页

登录后进入开发者后台:

开发者后台首页

注意: 必须加入组织才能进入开发者后台,如果没有组织可以先创建一个。

步骤 2: 创建企业内部应用

导航至: 应用开发 → 企业内部应用 → 钉钉应用

应用列表页面

点击 创建应用 按钮,填写应用信息:

创建应用表单

  • 应用名称: LobsterAI
  • 应用描述: AI Agent,可自主规划并执行复杂任务
  • 应用图标: 上传龙虾 logo

创建成功后会看到:

应用创建成功

步骤 3: 添加机器人能力

在应用详情页,点击 添加应用能力:

添加应用能力入口

选择 机器人 能力:

选择机器人能力

填写机器人配置信息:

机器人配置表单

  • 机器人名称: LobsterAI
  • 机器人描述: AI Agent,可自主规划并执行复杂任务
  • ⚠️ 重要: 消息接收模式选择 Stream 模式

配置完成后即可看到机器人能力已添加:

机器人能力添加成功

步骤 4: 配置权限管理

进入 权限管理 页面:

权限管理入口

搜索并勾选以下 3 个权限:

权限搜索和勾选

  • ✅ Card.Streaming.Write - 支持流式卡片消息推送
  • ✅ Card.Instance.Write - 创建和更新交互式卡片
  • ✅ qyapi_robot_sendmsg - 发送机器人消息到群聊和单聊

提交权限申请:

权限申请提交

提示: 权限申请提交后需要等待审核通过。

步骤 5: 发布应用版本

进入 企业版本管理与发布 页面:

版本管理入口

创建新版本并发布应用:

创建并发布版本

发布成功后,你的机器人就可以在钉钉中搜索到了!

步骤 6: 获取凭证信息

在应用管理页面,找到 凭证与基础信息 部分:

凭证与基础信息

复制以下信息:

  • Client ID(应用的 AppKey)
  • Client Secret(应用的 AppSecret)

⚠️ 注意: Client Secret 只显示一次,请妥善保管!

步骤 7: 在 LobsterAI 中配置

打开 LobsterAI 客户端的 IM 配置界面:

LobsterAI 配置界面

在钉钉配置区域填入:

  • Client ID: 刚才复制的 AppKey
  • Client Secret: 刚才复制的 AppSecret

输入 Client ID 和 Client Secret 后,打开开关,确认显示"已连接"状态。

步骤 8: 测试机器人

桌面端测试:

在钉钉桌面客户端搜索框中搜索"LobsterAI":

钉钉搜索机器人

找到机器人后,发送消息测试:

钉钉对话测试

移动端测试:

  • 打开钉钉手机 APP
  • 在消息界面搜索机器人
  • 进入对话并发送消息测试

钉钉 IM 配置要点

✅ 必须选择 Stream 模式

  • Stream 模式下机器人可以实时接收消息,无需配置回调地址

✅ 确保应用已发布

  • 应用版本必须发布后才能在钉钉中使用

✅ 权限必须开通

  • 3 个必需权限缺一不可,等待审核通过后再测试

飞书 IM 机器人配置

准备工作

在开始之前,请确保你已经:

  • ✅ 已注册飞书账号
  • ✅ 已登录飞书开放平台

配置步骤

步骤 1: 进入飞书开放平台

访问飞书开放平台: https://open.feishu.cn

飞书开放平台首页

登录后进入开发者后台:

开发者后台

步骤 2: 创建企业自建应用

点击 创建企业自建应用 按钮:

创建应用入口

填写应用基本信息:

填写应用基本信息

  • 应用名称: LobsterAI
  • 应用描述: AI Agent,可自主规划并执行复杂任务
  • 应用图标: 上传龙虾 logo(推荐尺寸: 240×240px,支持 PNG、JPG 格式)

创建成功后:

应用创建成功

步骤 3: 添加机器人能力

在应用详情页,点击 添加应用能力:

添加应用能力

选择 机器人 能力:

选择机器人能力

添加机器人能力后,填写机器人的展示信息(这是用户在飞书中看到的机器人形象):

配置机器人信息

  • 机器人名称: LobsterAI
  • 机器人头像: 龙虾 logo
  • 机器人描述: AI Agent,可自主规划并执行复杂任务

步骤 4: 配置权限管理

进入 权限管理 页面:

权限管理入口

使用权限搜索功能:

搜索权限

勾选以下 3 个必需权限:

勾选必需权限

  • ✅ im:message - 获取与发送单聊、群聊消息
  • ✅ im:resource - 获取与上传图片、文件资源
  • ✅ contact:user.base:readonly - 获取用户基本信息

点击 批量开通 按钮,确认权限已开通:

权限开通确认

步骤 5: 获取凭证信息

在应用管理页面,找到 凭证与基础信息 部分:

凭证与基础信息

复制以下信息:

  • App ID
  • App Secret

步骤 6: 在 LobsterAI 中配置

打开 LobsterAI 客户端的 IM 配置界面:

LobsterAI 配置界面

在飞书配置区域填入:

  • App ID: 刚才复制的 App ID
  • App Secret: 刚才复制的 App Secret

输入 App ID 和 App Secret 后,打开开关,确认显示"已连接"状态。

步骤 7: 配置事件与回调

进入 事件与回调 页面,配置消息订阅:

  1. 订阅方式 使用 长连接

  2. 添加 im.message.receive_v1 接收消息事件

事件与回调配置

步骤 8: 发布应用版本

进入 版本管理与发布 页面:

创建应用版本并发布:

创建并发布版本

  • 填写版本说明
  • 提交审核并发布

发布成功后,你的机器人就可以在飞书中搜索到了!

步骤 9: 测试机器人

桌面端测试:

在飞书桌面客户端搜索框中搜索"LobsterAI":

飞书搜索机器人

在搜索结果中选择 应用 标签,找到机器人并发送消息测试:

飞书对话测试

移动端测试:

  • 打开飞书手机 APP
  • 点击顶部搜索框
  • 搜索机器人名称
  • 在 应用 分类中找到机器人
  • 点击进入并发送消息测试

钉钉 Webhook 机器人配置

准备工作

在开始之前,请确保你已经:

  • ✅ 已注册钉钉账号
  • ✅ 已创建或加入一个群聊(可以是企业群或普通群)
  • ⚠️ 必须使用电脑端或网页版进行配置 - 手机端无法创建自定义 Webhook 机器人

配置步骤

步骤 1: 创建群聊(如果还没有)

在钉钉中创建一个新群聊,或使用现有群聊。

点击群聊右上角的设置按钮进入群设置:

群设置入口

步骤 2: 添加群机器人

在群设置中,找到 群管理 → 机器人 → 添加机器人。

选择 自定义机器人(通过 Webhook 接入自定义服务):

选择自定义机器人 添加自定义机器人

步骤 3: 配置机器人信息

填写机器人基本信息:

  • 机器人名称: LobsterAI (或任何你喜欢的名称)
  • 机器人头像: 可以上传龙虾 logo

步骤 4: 配置安全设置

重要: 钉钉要求至少启用一种安全设置,推荐选择 自定义关键词:

推荐配置:

  • ☑️ 自定义关键词: 填写 LobsterAI 或 AI
    • 这样机器人发送的消息中必须包含这个关键词

其他选项:

  • 加签 (Signature): 需要配置密钥,更安全但配置复杂
  • IP 地址: 需要固定 IP,不适合个人用户

提示: 如果选择"加签",需要记录下密钥 (Secret),后续配置需要用到。

步骤 5: 获取 Webhook URL

创建完成后,会显示 Webhook 地址:

Webhook URL 格式:

https://oapi.dingtalk.com/robot/send?access_token=xxxxxxxxxxxxxx

重要信息:

  • ✅ 复制完整的 Webhook URL
  • ✅ 如果启用了"加签",同时复制 Secret 密钥
  • ⚠️ 这些信息只显示一次,请妥善保管!

步骤 6: 保存 Webhook 信息(推荐)

💡 推荐做法: 在 LobsterAI 客户端的 设置 → 记忆 中保存 Webhook 信息,方便后续直接使用。

保存格式示例:

我的钉钉LobsterAI群 Webhook: https://oapi.dingtalk.com/robot/send?access_token=你的access_token

这样以后你直接对 LobsterAI 说 “给钉钉LobsterAI群推送消息”,它就能自动从记忆中读取 Webhook 地址并执行!

步骤 7: 测试机器人

测试方法: 直接把 Webhook 地址发给 LobsterAI,让它发一条测试消息。

测试示例:

https://oapi.dingtalk.com/robot/send?access_token=1babea08cc7d1a12a9ffb2711a2c18acdc15fb20000f9f3441dfba09426605e9

给我的钉钉机器人发个消息: Hello World

注意:

  • 如果配置了关键词验证,推送的消息中必须包含关键词
  • Webhook 机器人是单向推送,群成员无法与机器人对话

钉钉 Webhook 配置要点

✅ 选择合适的安全验证方式

  • 推荐使用"自定义关键词",配置简单
  • 加签验证更安全,但需要同时配置 access_token 和 secret

✅ Webhook URL 格式要正确

  • 必须是完整的 URL,包含 https://
  • 如果使用加签,需要单独填写 Secret 字段

✅ 注意群聊权限

  • 机器人只能在创建它的群中使用
  • 如果需要多个群使用,需要在每个群中分别创建

飞书 Webhook 机器人配置

准备工作

在开始之前,请确保你已经:

  • ✅ 已注册飞书账号
  • ✅ 已创建或加入一个群聊
  • ⚠️ 必须使用电脑端或网页版进行配置 - 手机端无法创建自定义 Webhook 机器人

配置步骤

步骤 1: 创建群聊(如果还没有)

在飞书中创建一个新群聊,或使用现有群聊。

点击群聊名称进入群设置。

步骤 2: 添加群机器人

在群设置中,找到 群机器人 → 添加机器人。

选择 自定义机器人:

选择自定义机器人

步骤 3: 配置机器人信息

填写机器人基本信息:

配置机器人信息

  • 机器人名称: LobsterAI (或任何你喜欢的名称)
  • 机器人描述: AI Agent,可自主规划并执行复杂任务
  • 机器人头像: 可以上传龙虾 logo

步骤 4: 获取 Webhook URL

创建完成后,会显示 Webhook 地址。

Webhook URL 格式:

https://open.feishu.cn/open-apis/bot/v2/hook/xxxxxxxxxxxxxx

重要信息:

  • ✅ 复制完整的 Webhook URL
  • ✅ 如果启用了签名验证,同时复制签名密钥 (Signing Secret)
  • ⚠️ 这些信息只显示一次,请妥善保管!

步骤 5: 保存 Webhook 信息(推荐)

💡 推荐做法: 在 LobsterAI 客户端的 设置 → 记忆 中保存 Webhook 信息,方便后续直接使用。

保存格式示例:

我的飞书LobsterAI群 Webhook: https://open.feishu.cn/open-apis/bot/v2/hook/你的webhook_id

这样以后你直接对 LobsterAI 说 “给飞书LobsterAI群推送消息”,它就能自动从记忆中读取 Webhook 地址并执行!

步骤 6: 测试机器人

测试方法: 直接把 Webhook 地址发给 LobsterAI,让它发一条测试消息。

测试示例:

https://open.feishu.cn/open-apis/bot/v2/hook/你的webhook_id

给我的飞书机器人发个消息: Hello World

注意:

  • Webhook 机器人是单向推送,群成员无法与机器人对话
  • 确保机器人在群成员列表中可见

飞书 Webhook 配置要点

✅ Webhook URL 格式要正确

  • 必须是完整的 URL,包含 https://
  • 如果使用签名验证,需要单独填写 Secret 字段

✅ 注意群聊权限

  • 机器人只能在创建它的群中使用
  • 如果需要多个群使用,需要在每个群中分别创建

企业微信机器人配置

准备工作

在开始之前，请确保你已经：

  • ✅ 已注册企业微信账号
  • ✅ 已加入或创建企业组织
  • ✅ 具备企业管理员或开发者权限

配置步骤

步骤 1：进入企业微信开放平台

访问企业微信开放平台：https://work.weixin.qq.com

企业微信开放平台首页

步骤 2：创建智能机器人

导航至：安全与管理 -> 管理工具 -> 智能机器人

智能机器人

点击 创建机器人 按钮，填写机器人描述信息，比如：有道龙虾机器人 1 号。然后点击 创建 按钮：

创建

机器人描述信息

创建成功后，按下图所示的点击最下面的 API 模式创建：

api模式创建

配置可见范围，并把 Bot ID 和 Secret 保存到自己的本地文件中，最后点击保存。

保存配置

注意：

  1. 这里的 BotID 和 Secret 是企业微信机器人的凭证，需要妥善保管。
  2. 如果报错参数不合法，大概率是因为你的可见范围没有选择。
  3. 如果想要设置机器人的名称和头像，点击右上角的编辑，可以设置。

步骤 3：在 LobsterAI 中配置

打开有道龙虾应用，点击左下角的设置，点击 IM 配置，在企业微信配置区域填入：

  • Bot ID：刚才复制的 Bot ID
  • Secret：刚才复制的 Secret

点击测试连通性。

企微配置

测试机器人

在企业微信的网页版中，导航至：安全与管理 > 管理工具 > 智能机器人 > 管理。

管理

然后选中对应的机器人那行最右侧的详情按钮，进入机器人详情页。

二维码

点击右上角的三个点，并点击获取机器人二维码按钮，会生成一个二维码，用手机的企业微信 app扫描二维码即可和对应的机器人对话。

有道龙虾 IM

QQ（QQ-BOT）

准备工作

在开始之前，请确保你已经：

  • ✅ 已注册 QQ 账号

配置步骤

步骤 1：进入 QQ 开放平台

访问 QQ 开放平台：https://q.qq.com/qqbot/openclaw/login.html

QQ开放平台首页

步骤 2：创建智能机器人

智能机器人

注意：这里的 AppID 和 AppSecret 是 QQ 机器人的凭证，需要妥善保管。

步骤 3：在 LobsterAI 中配置

打开有道龙虾应用，点击左下角的设置，点击 IM 配置，在 QQ 配置区域填入：

  • AppID：复制并填写步骤2中的 AppID
  • AppSecret：复制并填写步骤2中的 AppSecret

点击测试连通性。

QQ IM 配置

测试机器人

在 QQ 中找到自己的机器人，点击对话框，即可和机器人对话。

有道龙虾 IM

常见问题与故障排查

钉钉 IM 机器人相关问题

Q: 提示"Stream 连接失败"?

A:

  • 检查网络是否能访问钉钉 API
  • 确认 Client ID 和 Client Secret 是否正确
  • 重启 LobsterAI 应用重新建立连接

Q: 机器人无法发送消息?

A:

  • 检查权限 qyapi_robot_sendmsg 是否已开通
  • 确认应用已发布且版本为最新

飞书 IM 机器人相关问题

Q: LobsterAI 客户端的"机器人"标签页是空白的,没有对话框?

A: 这是最常见的问题,通常是由于配置步骤顺序错误导致的。

解决方法:

  1. 确认配置顺序: 获取凭证 → 在 LobsterAI 中配置并建立连接 → 配置事件与回调 → 发布版本
  2. 如果顺序错了,需要重新发布一个新版本(如从 1.0.0 升级到 1.0.1)
  3. 重启 LobsterAI 客户端

Q: 机器人收不到用户消息?

A: 最常见的原因是没有订阅 im.message.receive_v1 事件。

解决方法:

  1. 进入飞书开放平台的 事件与回调 页面
  2. 在 事件配置 区域搜索 im.message.receive_v1
  3. 点击 添加事件 按钮
  4. 保存配置并重启 LobsterAI 客户端

提示: 此事件是接收用户消息的核心权限,没有它机器人将无法接收任何消息!

⚠️ 重要: 如果你是在应用已发布后才添加此事件,必须到 版本管理与发布 重新发布一个新版本(如从 1.0.0 升级到 1.0.1),配置才会生效!

Q: 保存事件配置时提示"应用未建立长连接"?

A: 说明 LobsterAI 客户端还没有启动或连接失败。

正确做法:

  1. 先在 LobsterAI 中配置 App ID 和 App Secret
  2. 重启 LobsterAI 客户端,等待连接建立
  3. 再到飞书后台保存"事件与回调"配置

飞书长连接状态

钉钉 Webhook 机器人相关问题

Q: 机器人推送失败?

A:

  1. 检查推送消息中是否包含配置的关键词
  2. 确认 Webhook URL 是否正确复制(不要有空格或换行)
  3. 检查 LobsterAI 是否在运行
  4. 查看机器人是否被群管理员禁用

Q: 提示"签名验证失败"?

A:

  • 检查 Secret 是否正确配置
  • 确认 URL 和 Secret 分别填写在对应字段
  • 注意不要把 &secret=xxx 拼接在 URL 中

Q: 机器人提示"关键词不匹配"?

A:

  • 在推送消息中添加配置的关键词,例如: “LobsterAI: Hello World”
  • 或者重新创建机器人,修改关键词设置

飞书 Webhook 机器人相关问题

Q: 机器人推送失败?

A:

  1. 检查 Webhook URL 是否正确
  2. 确认 LobsterAI 是否在运行
  3. 查看群设置中机器人是否被禁用
  4. 检查飞书是否有网络限制

Q: 提示"webhook 地址不合法"?

A:

  • 检查 URL 是否完整,必须以 https://open.feishu.cn/ 开头
  • 确认没有多余的空格或特殊字符
  • 重新复制 Webhook URL

Webhook 机器人通用问题

Q: 一个 Webhook URL 能在多个群使用吗?

A:

  • 不能。Webhook 机器人创建时就绑定了特定的群
  • 如需多群使用,需要在每个群中分别创建机器人
  • 然后在 LobsterAI 中配置多个 Webhook URL

Q: 如何在 LobsterAI 中管理多个 Webhook?

A: 推荐方法: 在 LobsterAI 的 设置 → 记忆 中保存所有 Webhook 信息。

示例格式:

技术LobsterAI群 Webhook: https://oapi.dingtalk.com/robot/send?access_token=xxx
运营LobsterAI群 Webhook: https://oapi.dingtalk.com/robot/send?access_token=yyy
产品飞书群 Webhook: https://open.feishu.cn/open-apis/bot/v2/hook/zzz

这样后续使用时,LobsterAI 能自动从记忆中读取对应群的 Webhook 地址!

Q: Webhook URL 可以分享给别人吗?

A:

  • ⚠️ 不建议分享!
  • 任何人获得 Webhook URL 都可以向群里发消息
  • 如果泄露,应立即删除机器人并重新创建

使用场景和技巧

Webhook 机器人典型使用场景

定时信息推送

你在 LobsterAI 中设置:

每天早上 8 点给钉钉LobsterAI群推送今日 AI 要闻

群聊效果:

🤖 LobsterAI 机器人
━━━━━━━━━━━━━━━
📰 今日 AI 要闻 (2026-03-07)

1. OpenAI 发布 GPT-5 预览版
2. 谷歌推出 Gemini 2.0 Ultra
3. Meta 开源最新多模态模型
...

最佳实践

  1. 为每个群设置不同的关键词

    • 技术群: AI帮手
    • 运营群: 小助理
    • 这样可以更好地管理多个机器人

  2. 合理设置推送频率

    • 避免频繁推送,可能打扰群聊
    • 建议设置定时推送而非实时推送

  3. 定期检查机器人状态

    • 查看 LobsterAI 连接状态
    • 测试机器人推送是否正常

  4. 备份 Webhook 信息

    • 将 Webhook URL 保存在安全的地方
    • 记录每个 URL 对应的群聊名称

官方文档

如需了解更多详细信息,请查看官方文档:

钉钉:

飞书: