OpenClaw四个主流平台接入教程：飞书、钉钉、企业微信和QQ，总有一个适合你

想象一下这个场景：

你在出差路上，手机突然弹出一条消息——是团队工作群里有人在问："上周的数据分析报告做好了吗？"

平时你可能要赶紧找台电脑、连网线、登录系统、查数据、做报表……但现在，你只需要在群里回一句：

"@AI 助手，帮我分析上周销售数据，生成一份带图表的报告。"

几分钟后，一份完整的报告就自动发到了群里，图文并茂，格式规范。

这不再是科幻电影里的情节——有了 OpenClaw，它就是你的现实。

OpenClaw（俗称"龙虾"）支持接入主流通讯平台，把 AI 助手集成到你日常使用的飞书、钉钉、企业微信、QQ中。

接入之后有什么好处？

• 随时随地指挥：不在电脑前，也能用手机发消息让 AI 干活

• 团队共享：把机器人拉进群聊，团队成员都能用，不用重复配置

• 消息推送：任务完成后，结果会自动推送到群里，不用一直盯着电脑

• 多任务并行：多个群里可以同时发指令，AI 会排队处理

• 降低门槛：不用懂命令行，直接在聊天框说话就行

下面整理了四个平台的完整接入步骤，基于 OpenClaw 原版，按顺序操作即可。

前置准备

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

1. 安装了 OpenClaw

npm install -g openclaw@latest --registry=https://registry.npmmirror.com 

或使用 pnpm：

pnpm add -g openclaw@latest 

2. 验证安装

openclaw doctor 

3. 启动 Gateway 服务

openclaw gateway 

或指定端口：

openclaw gateway --port 18789 

一、QQ 接入

QQ 有两种接入方式：官方 QQBot（推荐企业使用）和 NapCat 个人号插件（适合个人用户）。

方式一：QQBot 官方接入（推荐企业）

QQBot 是腾讯官方提供的机器人平台，稳定可靠，适合企业正式环境。

步骤 1：注册 QQ 开放平台

1. 访问 QQ 开放平台，使用 QQ 账号登录

2. 完成开发者身份认证（通常需要人脸识别）

3. 点击"机器人"标签，创建机器人

4. 填写机器人的名称、头像和描述

步骤 2：获取凭证

在"开发管理"页面记录以下信息：

• AppID：机器人唯一标识

• AppSecret：机器人密钥

步骤 3：配置 IP 白名单

在"开发管理"页面的"IP白名单"设置中，添加部署 OpenClaw 服务器的公网 IP 地址。

步骤 4：沙箱配置（测试环境）

1. 进入"沙箱配置"，配置 QQ 群、消息列表

2. 通过"添加成员"功能，邀请测试用户

步骤 5：在 OpenClaw 中配置 QQBot

1. 打开 OpenClaw 管理页面：http://127.0.0.1:18789

2. 左侧菜单 → Channels

3. 找到 QQBot 选项，点击进行配置

4. 填入 AppID 和 AppSecret

5. 点击 Save 保存配置

步骤 6：测试

在 QQ 中找到创建的机器人，发送消息测试。测试通过后，提交审核上线到正式环境。

方式二：NapCat 个人号插件（适合个人用户）

NapCat 是一个基于 OneBot v11 标准的 QQ 协议框架，可以让个人 QQ 号变身机器人。

步骤 1：安装 NapCat

1. 访问 NapCat GitHub，按官方文档安装

2. 登录你的 QQ 账号

3. 配置 OneBot v11 正向 WebSocket，记录以下信息：

• WebSocket 地址（如 ws://127.0.0.1:3001）

• access_token（如果设置了）

步骤 2：安装 OpenClaw QQ 插件

openclaw plugins install @creatoraris/openclaw-qq 

注意：安装时可能出现安全警告 Plugin contains dangerous code patterns: Environment variable access combined with network send，这是插件需要读取配置并连接网络导致的，可以安全忽略。

步骤 3：配置插件

编辑 OpenClaw 配置文件 ~/.openclaw/openclaw.json，在 plugins.entries 部分添加：

{   "plugins": {      "entries": {         "openclaw-qq": {            "config": {               "allowedGroups": [],               "allowedUsers": [],               "botQQ": "123456789",               "napcatToken": "your_napcat_token",               "napcatWs": "ws://127.0.0.1:3001"            },            "enabled": true         }      }   }}

重要：必须配置 napcatWs 参数，否则插件不会启用。

配置参数说明：

步骤 4：重启服务

systemctl --user restart openclaw-gateway 

或使用命令：

openclaw gateway restart 

步骤 5：测试

在 QQ 上给机器人发送私聊消息，检查是否能正常收到 AI 的回复。

使用命令

• /reset 或 /重置：重置当前对话的上下文，开始新话题

故障排查

• 查看日志：journalctl --user -u openclaw-gateway -f

• 插件未启用：检查 napcatWs 配置是否正确

• 连接失败：确认 NapCat 服务正在运行，地址和 token 无误

• 群聊无回复：检查群号是否在 allowedGroups 白名单内，以及是否 @ 了机器人

• 私聊无回复：检查用户 QQ 号是否在 allowedUsers 白名单内（或白名单为空允许所有人）

三、飞书接入

飞书使用 WebSocket 长连接模式，无需公网 IP，配置相对简单。

步骤 1：启用飞书插件

启用内置飞书插件：

openclaw plugins enable feishu

验证插件状态：

openclaw plugins list 

状态应为 loaded（已启用）。

步骤 2：在飞书开放平台创建应用

1. 访问 飞书开放平台，点击 "创建企业自建应用"

2. 填写应用信息：

• 名称：如「我的 OpenClaw AI」

• 描述和图标：按需填写

3. 记录 App ID 和 App Secret

步骤 3：配置飞书频道

openclaw channels add 

按提示操作：

• 选择 Feishu/Lark (飞书)

• 输入 App Secret 和 App ID

• 连接模式选择 国内域名

• 群聊策略建议选 Open（响应所有群聊）

• 完成后选择 Finished

步骤 4：启用机器人能力

在飞书应用管理界面：

1. 添加应用能力 → 机器人，点击"添加"

2. 配置权限：

• 进入 权限管理 → 批量导入/导出权限

• 粘贴以下权限配置：

[   "im:message",   "im:message:send_as_bot",   "im:chat",   "im:chat:access_as_bot",   "im:resource"]

3. 保存权限设置

步骤 5：配置事件订阅

1. 进入 事件与回调 → 事件配置

2. 订阅方式选择 长连接（WebSocket）

3. 添加以下事件：

• im.message.receive_v1（接收消息）

• im.message.message_read_v1（消息已读回执）

• im.chat.member.bot.added_v1（机器人进群）

• im.chat.member.bot.deleted_v1（机器人被移出群）

步骤 6：发布应用

1. 进入 版本管理与发布 → 创建版本 → 提交审核 → 发布

步骤 7：测试

在飞书中创建测试群，添加机器人，在群内 @ 机器人并发送消息测试。

四、钉钉接入

钉钉使用 Stream 模式（WebSocket 长连接），同样无需公网 IP。

步骤 1：安装 DingTalk 频道插件

openclaw plugins install @soimy/dingtalk 

步骤 2：配置插件信任白名单

编辑 OpenClaw 配置文件 ~/.openclaw/openclaw.json：

{   "plugins": {      "allow": [         "dingtalk"      ],      "enabled": true   }}

保存后重启 Gateway：

openclaw gateway restart 

步骤 3：钉钉开发者平台配置

1. 创建应用

• 访问 钉钉开发者后台

• 创建 企业内部应用，添加 "机器人" 能力

• 消息接收模式配置为 Stream 模式

• 发布应用

2. 配置权限

• 进入 权限管理

• 搜索并开通以下权限（否则无法使用 AI 卡片功能）：

• Card.Instance.Write（创建和投放卡片实例）

• Card.Streaming.Write（流式更新卡片）

3. 获取关键凭证

从应用信息中记录以下参数：

• Client ID（即 AppKey）

• Client Secret（即 AppSecret）

• Robot Code（通常与 AppKey 相同）

• Corp ID（企业ID）

• Agent ID（应用ID）

步骤 4：OpenClaw 通道配置

使用命令行交互式配置：

openclaw configure --section channels 

按向导操作：

• 选择 dingtalk 或 DingTalk (钉钉)

• 填写凭证：Client ID、Client Secret、Robot Code、Corp ID、Agent ID

• 消息类型：

配置向导会自动保存配置并重启 Gateway 服务。

步骤 5：测试

• 私聊测试：在钉钉中找到该机器人，发送消息

• 群聊测试：将机器人拉入群聊，在群里 @机器人名称 并发送消息

五、企业微信接入

企业微信使用 回调模式，需要公网 IP 或已备案域名，配置相对复杂。

步骤 1：准备工作

• 已完成 OpenClaw 服务部署

• 拥有管理员权限的企业微信企业账号

• 服务器有公网 IP 或已备案域名

重要提示：

• 如果企业已认证，回调 URL 必须配置已备案且与企业主体一致的域名

• 如果企业未认证，可暂时使用服务器的公网 IP 进行测试

步骤 2：在企业微信后台创建机器人

1. 登录 企业微信管理后台

2. 左侧导航 → 安全与管理 → 管理工具 → 创建机器人

3. 滑动到页面底部，点击 "API模式创建" 按钮

4. 填写信息：

• 名称/简介：如「OpenClaw 助手」

• 可见范围：选择可使用该机器人的部门或成员

• URL：填写回调地址，格式为 http://你的服务器公网IP:18789/wecom（例如：http://12.12.12.12:18789/wecom）

• 密钥：点击"随机获取"按钮，生成 Token 和 EncodingAESKey，并妥善记录

5. 暂时不要点击"创建"按钮

步骤 3：在 OpenClaw 中配置企业微信通道

有两种配置方式，任选其一：

方式一：管理页面（推荐）

1. 打开 OpenClaw 管理页面：http://127.0.0.1:18789

2. 左侧菜单 → Channels

3. 找到 WeCom 选项，点击进行配置

4. 填入之前记录的 Token 和 EncodingAESKey

5. 点击 Save 保存配置

方式二：命令行向导

openclaw onboard 

• 通道选择 WeCom (plugin)

• 依次输入之前记录的 Token 和 EncodingAESKey

• Webhook 路径保持默认 /wecom

• 后续配置选择暂不配置技能（No），并启用会话记忆（session-memory）

步骤 4：启动 Gateway 服务并完成配置

1. 启动 Gateway：

openclaw gateway --port 18789 --verbose 

看到成功启动的提示信息。

1. 回到企业微信后台暂停的创建页面，点击 "创建" 按钮

2. 扫描页面提供的二维码，将机器人添加到企业微信

3. 添加成功后，即可在企业微信中与 OpenClaw 助手对话

步骤 5（可选）：设置后台运行

为确保关闭终端后服务仍正常运行，建议设置为后台服务：

# 按 Ctrl+C 终止当前运行的 Gateway 进程  # 安装后台服务 loginctl enable-linger $(whoami) && export XDG_RUNTIME_DIR=/run/user/$(id -u) && openclaw daemon install# 启动服务 openclaw daemon start# 检查状态 openclaw daemon status 

实际使用场景举例

接入之后，你可以把机器人拉进群聊，团队成员都能用，或者直接私聊机器人发指令。以下是一些常见场景：

场景一：自动化办公

在群里直接发消息：

"帮我把群里的会议记录整理成一份周报。"

机器人会自动识别群里的聊天记录，提取关键信息，生成一份结构化的周报文档，并直接发回群里。

场景二：批量处理文件

"把 Downloads 文件夹里的所有图片按日期分类到不同文件夹里。"

机器人会在后台执行，完成后在群里通知："已整理完成，共 256 张图片，按日期分成了 12 个文件夹。"

场景三：代码审查

开发群里：

"检查一下当前项目的代码有没有逻辑错误。"

机器人会分析项目代码，找出潜在问题，给出修复建议，直接在群里发回复。

场景四：数据分析

"分析一下 @sales.xlsx 里的数据，生成一个带图表的分析报告。"

机器人会读取 Excel 文件，生成分析报告和图表，并推送到群里。

场景五：远程协作

你在外地开会，需要查资料：

在群里发消息："帮我查一下上周的客户反馈数据，总结成要点。"

机器人会在你的电脑上执行，完成后把结果推送到群里，你不用一直守在电脑前。

团队协作模式

接入群聊后，还可以设置不同的使用策略：

小贴士

1. 给机器人设置明显的名称：比如"AI 助手"、"代码审查机器人"，方便成员识别

2. 在群里 @ 机器人：大部分平台需要 @ 机器人才能触发响应

3. 权限控制：如果担心误操作，可以设置白名单，只给特定群开通

4. 结果推送：任务完成后，机器人会主动把结果发到群里，不需要手动去查

总结对比

常见问题排查

QQ（QQBot 官方）

• 无响应：确认机器人已发布到正式环境、IP 白名单已配置

• 群消息无响应：确认机器人已入群，并且 @ 了正确的机器人名称

• 连接失败：检查 AppID 和 AppSecret 是否正确、网络连通性

QQ（NapCat 个人号）

• 插件未启用：检查 napcatWs 配置是否正确

• 连接失败：确认 NapCat 服务正在运行，地址和 token 无误

• 群聊无回复：检查群号是否在 allowedGroups 白名单内，以及是否 @ 了机器人

• 私聊无回复：检查用户 QQ 号是否在 allowedUsers 白名单内（或白名单为空允许所有人）

• 查看日志：journalctl --user -u openclaw-gateway -f

飞书

• 无响应：确认应用已发布、事件订阅为 WebSocket 模式、权限已开通

• 群消息无响应：确认机器人已入群，并且 @ 了正确的机器人名称

• 连接失败：检查 App ID 和 App Secret 是否正确、网络连通性

钉钉

• 收不到消息：确认应用已发布、消息模式为 Stream 模式，并检查 OpenClaw 日志：openclaw logs | grep dingtalk

• 群消息无响应：确认机器人已入群，并且 @ 了正确的机器人名称

• 连接失败：检查 Client ID 和 Client Secret 是否正确，以及网络连通性

企业微信

• URL 验证失败：检查 Gateway 是否启动、服务器防火墙 18789 端口是否开放、Token 和 EncodingAESKey 是否正确、URL 格式是否正确（使用 http）

• 已认证企业必须用域名：是的，必须使用已备案且与企业主体一致的域名

写在最后

AI 机器人接入办公群聊，已经从一个"黑科技"变成日常工具。想想看：

• 你每天在群里重复回答的常见问题，是不是可以让机器人来回答？

• 团队里那些繁琐的文件整理、报表生成工作，是不是可以让机器人来处理？

• 你不在电脑前的时候，是不是也希望有个助手能帮你查资料、处理紧急事项？

接入一个 AI 机器人，成本可能只需要半小时，但它能帮你节省的时间，可能是每天一小时、两小时，甚至更多。

你所在的团队，现在最需要 AI 机器人来解决的，是哪类工作？

文档参考： OpenClaw 官方文档（docs.openclaw.ai）、OpenClaw 中文站（openclawchina.com）、飞书/钉钉/企业微信开放平台文档。