夜雨聆风第 9 章 多平台接入实践
💡 本章目标：掌握 OpenClaw 与飞书、QQ、企业微信、钉钉等主流即时通讯平台的对接方法，让 AI 助手能够随时随地响应你的需求。飞书因其现代化的设计和完善的开发者支持，将作为首要讲解对象。
📱 内容导航
• 9.1 飞书 Bot 集成 ▪ 9.1.11.1 与飞书的协同方式 ▪ 9.1.11.2 实战案例：构建 4 个专业助手 ▪ 9.1.11.3 配置注意事项与避坑指南 ▪ 9.1.11.4 常见问题排查 ▪ 9.1.11.5 配置方案对比分析 ▪ 9.1.11.6 使用建议与最佳实践 ▪ 9.1.11.7 本地多 Agent 独立管理（无需 IM 绑定）⭐新增 ◦ 9.1.1 飞书机器人能力概述 ◦ 9.1.2 极速启动方案 ◦ 9.1.3 在飞书开放平台创建应用 ◦ 9.1.4 配置 OpenClaw 端参数 ◦ 9.1.5 启动网关与功能验证 ◦ 9.1.6 精细化权限控制 ◦ 9.1.7 群组场景配置技巧 ◦ 9.1.8 获取群组与用户标识 ◦ 9.1.9 高级功能调优 ◦ 9.1.10 多账号并行管理 ◦ 9.1.11 多 Agent 协同架构 • 9.2 QQ Bot 配置详解 • 9.3 企业微信 Bot 接入指南 • 9.4 钉钉 Bot 部署说明
9.1 飞书 Bot 集成
💡 状态说明：该集成方案已可用于生产环境，支持私聊与群组对话，采用 WebSocket 长连接方式接收事件。
9.1.1 飞书机器人能力概述
飞书作为新一代办公协作平台，为机器人提供了强大的能力支撑：
| 现代化办公 | |
| 交互体验 | |
| 开发者生态 | |
| 成本优势 |
9.1.2 极速启动方案
添加飞书渠道有两种主流途径，可根据实际场景选择：
途径一：通过安装向导自动配置（推荐新手）
完成 OpenClaw 初始安装后，直接运行以下命令，按照提示操作即可：
openclaw setup
向导会依次引导你：
• 创建飞书应用并获取凭证 • 配置应用认证信息 • 启动网关服务
途径二：通过命令行手动添加（适合已有配置的用户）
若已完成基础安装，可使用渠道添加命令：
openclaw channels add
根据交互提示选择 Feishu，并输入 App ID 与 App Secret。
验证运行状态：
openclaw gateway status # 查看网关运行状态
openclaw logs --follow # 实时跟踪日志输出
9.1.3 在飞书开放平台创建应用
步骤 1：访问开放平台
打开 飞书开放平台，使用飞书账号登录。
💡 若使用国际版 Lark，请访问 https://open.larksuite.com/app，并在配置中设置
domain: "lark"。
步骤 2：新建企业自建应用
点击“创建企业自建应用”，填写应用名称与描述，并上传应用图标。
步骤 3：获取应用凭证
在应用详情页的“凭证与基础信息”中，复制以下两项：
• App ID（形如 cli_xxx）• App Secret
❗ 重要：App Secret 仅显示一次，请妥善保管，切勿泄露。
步骤 4：配置 API 权限
进入“权限管理”页面，点击“批量导入”，粘贴以下 JSON 配置以快速添加所需权限：
{
"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:write","contact:user.employee_id:readonly",
"corehr:file:download","docs:document.content:read",
"event:ip_list","im:chat",
"im:chat.access_event.bot_p2p_chat:read","im:chat.members:bot_access",
"im:message","im:message.group_at_msg:readonly",
"im:message.group_msg","im:message.p2p_msg:readonly",
"im:message:readonly","im:message:send_as_bot",
"im:resource","sheets:spreadsheet","wiki:wiki:readonly"
],
"user":[
"aily:file:read","aily:file:write",
"im:chat.access_event.bot_p2p_chat:read"
]
}
}
步骤 5：启用机器人能力
在“应用能力” → “机器人”页面，开启机器人功能并设置机器人名称。
步骤 6：配置事件订阅（关键步骤）
⚠️ 前置条件：确保已完成 openclaw channels add 添加渠道，且网关处于运行状态。
1. 选择“使用长连接接收事件”（即 WebSocket 模式） 2. 添加事件 im.message.receive_v1（接收消息）3. 务必添加以下三个权限，缺一不可：
im:message | |
im:message:send_as_bot | |
contact:contact.base:readonly |
💡 缺少
contact:contact.base:readonly会导致 OpenClaw 无法识别消息发送者，从而无法正常回复。
步骤 7：发布应用
进入“版本管理与发布”，创建版本并提交审核（企业自建应用通常自动通过，无需等待）。
9.1.4 配置 OpenClaw 端参数
安装飞书插件：
openclaw plugins install @openclaw/feishu
通过向导配置（推荐）：
openclaw channels add
选择 Feishu，并依次输入 App ID 和 App Secret。
通过配置文件手动配置（~/.openclaw/openclaw.json）：
{
"channels":{
"feishu":{
"enabled":true,
"dmPolicy":"pairing",
"accounts":{
"main":{
"appId":"cli_xxx",
"appSecret":"xxx",
"botName":"我的AI助手"
}
}
}
}
}
通过环境变量配置：
export FEISHU_APP_ID="cli_xxx"
export FEISHU_APP_SECRET="xxx"
国际版 Lark 域名配置：
{
"channels":{
"feishu":{
"domain":"lark",
"accounts":{ ... }
}
}
}
9.1.5 启动网关与功能验证
启动网关：
openclaw gateway install # 安装并启动网关服务
openclaw gateway status # 查看运行状态
发送测试消息：在飞书中找到你的机器人，发送一条“hi”。
日志中应出现：
HEARTBEAT_OK
hi
connected | running
agent main | session main (heartbeat) | local-antigravity/gemini-3-pro-high
配对授权（默认策略）： 若 dmPolicy 设置为 pairing（默认），机器人会返回配对码，需要管理员批准：
openclaw pairing list feishu
openclaw pairing approve feishu <配对码>
若希望开放访问，可修改配置：
{
"channels":{
"feishu":{
"dmPolicy":"open",
"allowFrom":["*"]
}
}
}
9.1.6 精细化权限控制
私聊访问策略（dmPolicy）：
pairing | |
allowlist | allowFrom 列表中的用户可对话 |
open | allowFrom: ["*"]） |
disabled |
群组访问策略（groupPolicy）：
open | |
allowlist | groupAllowFrom 中的用户可用 |
disabled |
@提及要求：可为特定群组单独配置 requireMention（默认 true，即需要 @ 机器人才响应）。
9.1.7 群组场景配置技巧
允许所有群组，需 @提及（默认）：
{
"channels":{
"feishu":{"groupPolicy":"open"}
}
}
允许所有群组，无需 @提及：
{
"channels":{
"feishu":{
"groups":{"oc_xxx":{"requireMention":false}}
}
}
}
仅允许特定用户在群组中使用：
{
"channels":{
"feishu":{
"groupPolicy":"allowlist",
"groupAllowFrom":["ou_xxx","ou_yyy"]
}
}
}
9.1.8 获取群组与用户标识
群组 ID（chat_id，格式 oc_xxx）：
• 方法一（推荐）：在群组中 @ 机器人发送任意消息，然后查看日志 openclaw logs --follow，从中提取chat_id。• 方法二：使用飞书 API 调试工具查询机器人所在群组列表。
用户 ID（open_id，格式 ou_xxx）：
• 方法一（推荐）：私聊机器人后查看日志。 • 方法二：查看配对请求列表： openclaw pairing list feishu
9.1.9 高级功能调优
自定义菜单：可在飞书应用中配置常用命令快捷入口。
流式输出：通过交互式卡片实现实时更新内容：
{
"channels":{
"feishu":{
"streaming":true,// 启用流式卡片
"blockStreaming":true// 启用块级流式
}
}
}
若需禁用（等待完整回复后一次性发送），设置 false。
消息引用：在群聊中引用原始消息，使对话更清晰：
{
"channels":{
"feishu":{
"replyToMode":"all",// off / first / all
"groups":{
"oc_xxx":{"replyToMode":"first"}
}
}
}
}
9.1.10 多账号并行管理
当需要同时管理多个飞书机器人时，可在 accounts 字段下配置多个账号。
基础配置示例（2 个机器人）：
{
"channels":{
"feishu":{
"enabled":true,
"dmPolicy":"pairing",
"accounts":{
"bot1":{
"appId":"cli_xxxxxxxxxxxxxxxx",
"appSecret":"your-app-secret-1",
"botName":"OpenClaw助手1",
"enabled":true
},
"bot2":{
"appId":"cli_yyyyyyyyyyyyyyyy",
"appSecret":"your-app-secret-2",
"botName":"OpenClaw助手2",
"enabled":true
}
},
"domain":"feishu",
"groupPolicy":"open",
"connectionMode":"websocket",
"requireMention":true,
"streaming":true,
"blockStreaming":true,
"replyToMode":"all"
}
},
"gateway":{
"port":18789,
"mode":"local",
"bind":"lan",
"auth":{
"mode":"token",
"token":"your-secure-token-here"
}
},
"agents":{
"defaults":{
"model":{"primary":"your-provider/your-model"},
"workspace":"/path/to/your/workspace",
"compaction":{"mode":"safeguard"},
"maxConcurrent":4,
"subagents":{"maxConcurrent":8}
}
}
}
多账号使用场景：
• 不同团队使用不同机器人 • 测试环境与生产环境分离 • 功能专用机器人（如代码助手、文档助手） • 主备冗余配置
管理命令：
openclaw channels list feishu # 列出所有飞书账号
openclaw channels enable feishu bot1 # 启用指定账号
openclaw channels disable feishu test# 禁用指定账号
openclaw logs --channel feishu --account main --follow # 查看指定账号日志
配置注意事项：
• 每个账号必须使用独立的飞书应用（不同的 App ID 和 Secret） • 账号标识符建议使用小写字母和连字符 • 修改配置后需重启网关： openclaw gateway restart
9.1.11 多 Agent 协同架构
9.1.11.1 与飞书的协同方式
通过 bindings 配置，可将不同飞书账号或用户路由到不同的 Agent，实现分工协作。
9.1.11.2 实战案例：构建 4 个专业助手
场景：独立开发者需要同时处理日常事务、内容创作、技术开发、资讯追踪。
配置示例：
{
"agents":{
"list":[
{"id":"main-agent","workspace":"/path/main","model":{"primary":"anthropic/claude-sonnet-4"}},
{"id":"content-agent","workspace":"/path/content","model":{"primary":"anthropic/claude-sonnet-4"}},
{"id":"tech-agent","workspace":"/path/tech","model":{"primary":"anthropic/claude-sonnet-4"}},
{"id":"news-agent","workspace":"/path/news","model":{"primary":"google/gemini-2-flash"}}
],
"defaults":{
"compaction":{"mode":"safeguard"},
"maxConcurrent":4,
"subagents":{"maxConcurrent":8}
}
},
"channels":{
"feishu":{
"accounts":{
"main-assistant":{"appId":"cli_main_xxx","appSecret":"xxx","botName":"主助理"},
"content-creator":{"appId":"cli_content_xxx","appSecret":"xxx","botName":"内容创作助手"},
"tech-dev":{"appId":"cli_tech_xxx","appSecret":"xxx","botName":"技术开发助手"},
"ai-news":{"appId":"cli_news_xxx","appSecret":"xxx","botName":"AI资讯助手"}
}
}
},
"bindings":[
{"agentId":"main-agent","match":{"channel":"feishu","peer":{"kind":"dm","id":"ou_xxx1"}}},
{"agentId":"content-agent","match":{"channel":"feishu","peer":{"kind":"dm","id":"ou_xxx2"}}},
{"agentId":"tech-agent","match":{"channel":"feishu","peer":{"kind":"dm","id":"ou_xxx3"}}},
{"agentId":"news-agent","match":{"channel":"feishu","peer":{"kind":"dm","id":"ou_xxx4"}}}
]
}
9.1.11.3 配置注意事项与避坑指南
• agents.list限制：每个 Agent 只能包含id、workspace、model字段，其他通用配置（如compaction、maxConcurrent）必须放在agents.defaults中。• Bindings 顺序：OpenClaw 按顺序匹配，将最具体的规则放在前面。 • 用户 ID 唯一性：每个飞书用户只能绑定到一个 Agent。
9.1.11.4 常见问题排查
openclaw doctor --fix 自动修复 | |
openclaw logs --follow --level debug，或查看配对请求列表 |
9.1.11.5 配置方案对比分析
9.1.11.6 使用建议与最佳实践
• 对于需要不同模型或工作空间隔离的场景，优先使用多 Agent 模式 • 若仅需简单测试，单 Agent 模式足够 • 为每个 Agent 配置独立的工作空间，避免文件混乱 • 定期备份配置文件： cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup
9.1.11.7 本地多 Agent 独立管理（无需 IM 绑定）⭐新增
OpenClaw 支持在不绑定任何 IM 平台的情况下，通过本地界面直接使用多个 Agent。
本地使用方式：
• Web UI： openclaw dashboard或访问http://127.0.0.1:18789/?token=你的token• 命令行： openclaw agent --message "hello"• TUI： openclaw tui
本地多 Agent 配置：
{
"agents":{
"list":[
{"id":"main-agent","workspace":"/Users/username/work","model":{"primary":"anthropic/claude-sonnet-4"}},
{"id":"code-agent","workspace":"/Users/username/code","model":{"primary":"deepseek/deepseek-chat"}},
{"id":"research-agent","workspace":"/Users/username/research","model":{"primary":"google/gemini-2-flash"}}
],
"defaults":{
"compaction":{"mode":"safeguard"},
"maxConcurrent":4
}
}
}
管理命令：
openclaw agents list # 列出所有 Agent
openclaw agents switch main-agent # 切换当前 Agent
openclaw agents current # 查看当前 Agent
典型工作流：
openclaw agents switch main-agent
openclaw agent --message "整理今日待办"
openclaw agents switch code-agent
openclaw agent --message "优化这段代码"
9.2 QQ Bot 配置详解
9.2.1 QQ 机器人能力概述
QQ 作为国内用户量最大的即时通讯平台，其机器人能力具有以下特点：
| 用户基础 | |
| 社交属性 | |
| 开放能力 | |
| 成本 |
9.2.2 创建 QQ 机器人
⚠️ 重要提示：QQ 开放平台需要单独注册账号，不可直接使用 QQ 登录。
步骤 1：注册开放平台账号
• 访问 https://q.qq.com/ • 点击“注册”，填写信息完成验证
步骤 2：创建机器人
• 登录后进入“机器人”管理页面 • 点击“创建机器人”，填写名称、头像、简介 • 提交后等待审核（通常几分钟）
步骤 3：获取凭证与配置
• 进入机器人详情页，记录 BotAppID 和 Bot Secret • 在“开发管理”中配置 IP 白名单（必须填写服务器公网 IP） • 在“成员管理”中添加测试用户的 QQ 号 • 使用手机 QQ 扫描机器人二维码，添加为好友
步骤 4：配置 OpenClaw 连接
腾讯云 Lighthouse 用户（推荐）：
1. 登录腾讯云控制台，进入轻量应用服务器实例 2. 点击“应用管理”，找到“QQ 机器人配置”区域 3. 填入 BotAppID 和 Bot Secret，点击“应用配置”
本地或非腾讯云用户：
# 通过配置向导
openclaw onboard
# 选择 QuickStart → 选择模型 → 选择通道 QQ → 输入 BotAppID 和 Secret
# 或手动编辑配置文件
nano ~/.openclaw/config.json
# 添加：
{
"channels": {
"qq": {
"enabled": true,
"botAppId": "你的机器人ID",
"botSecret": "你的机器人密钥"
}
}
}
启动 Gateway：
openclaw gateway --port 18789 --verbose
# 或使用 systemd
systemctl --user start openclaw-gateway.service
9.2.3 功能限制与注意事项
常见问题：
• 机器人不回复：检查 IP 白名单、BotAppID/Secret、Gateway 运行状态 • 配置后无法连接：确认已添加测试用户并添加好友，检查防火墙 • 消息延迟：检查网络与服务器负载
9.3 企业微信 Bot 接入指南
9.3.1 企业微信机器人能力
企业微信适合企业内部使用及与微信互通场景，特点如下：
| 企业办公 | |
| 客户连接 | |
| API 支持 | |
| 成本 |
9.3.2 创建与配置
步骤 1：注册企业微信
• 访问 https://work.weixin.qq.com/，注册企业
步骤 2：创建自建应用
• 登录管理后台，进入“应用管理” → “自建” • 创建应用，获取 AgentId、Secret，并记录企业 CorpId
步骤 3：配置应用权限
• 在应用详情中设置可见范围 • 开启“接收消息”并设置回调 URL（或使用 WebSocket）
步骤 4：OpenClaw 配置
{
"channels":{
"wecom":{
"enabled":true,
"corpId":"wwxxxxxx",
"agentId":"1000001",
"secret":"xxx",
"token":"your_token",// 可选，用于验证
"encodingAESKey":"xxx"// 可选，用于消息加密
}
}
}
启动验证：在企业微信中找到应用，发送测试消息。
9.4 钉钉 Bot 部署说明
9.4.1 钉钉机器人能力
钉钉在考勤、审批等企业管理场景具有优势：
| 企业办公 | |
| 协同工具 | |
| 开放能力 | |
| 成本 |
9.4.2 创建与配置
步骤 1：登录钉钉开放平台
• 访问 https://open.dingtalk.com/，使用钉钉扫码登录
步骤 2：创建应用
• 进入“应用开发” → “企业内部开发” • 创建应用，获取 AppKey 和 AppSecret
步骤 3：配置机器人
• 在应用详情中启用机器人 • 设置消息接收地址（或使用 WebSocket） • 添加必要权限（消息、通讯录等）
步骤 4：OpenClaw 配置
{
"channels":{
"dingtalk":{
"enabled":true,
"appKey":"dingxxx",
"appSecret":"xxx",
"robotCode":"xxx"// 机器人编号，可选
}
}
}
启动验证：在钉钉中向机器人发送消息。
9.5 平台对比与选型建议
9.5.1 核心功能对比
9.5.2 场景推荐
| 飞书 | ||
| 企业微信 | ||
| 钉钉 |
9.5.3 组合策略
• 工作+生活分离：飞书/企微/钉钉（工作） + QQ（生活） • 全平台覆盖：同时接入所有平台（维护成本高） • 主次搭配（推荐）：飞书（主力） + 企微（客户沟通）
9.6 可视化管理工具
9.6.1 OpenClaw Manager
基于 React + Tailwind 的 Web 管理面板，专为多 Gateway 实例设计。
核心功能：
• 🔍 自动发现 ~/.openclaw-*目录下的所有实例• ➕ 图形化创建新 Gateway（无需手动编辑配置） • ✏️ 在线编辑配置与 Agent 人格（SOUL.md） • ⚙️ 一键配置 launchd 保活服务 • 📝 实时日志查看 • 🎮 批量启动/停止/重启
安装使用：
git clone https://github.com/xianyu110/openclaw-manager.git
cd openclaw-manager
npm install && npm start
# 访问 http://localhost:3000
9.6.2 ClawX
开源桌面应用，支持 24/7 自主运行，可推送通知至 20+ 通讯平台。
项目地址：https://clawx.dev/ | GitHub: https://github.com/ValueCell-ai/ClawX
9.6.3 ClawPanel
基于 Tauri v2 的跨平台桌面面板，提供 AI 对话、模型管理、记忆编辑等全功能可视化。
项目地址：https://claw.qt.cool/ | GitHub: https://github.com/qingchencloud/clawpanel
9.6.4 工具对比
📝 本章回顾
通过本章学习，你已经掌握：
• 飞书、QQ、企业微信、钉钉四大平台的 Bot 接入流程 • 多账号、多 Agent 的进阶配置技巧 • 可视化管理工具的使用方法 • 平台选型与组合策略
🎯 实战任务
1. 完成一个飞书机器人的完整配置与测试 2. 尝试为不同场景配置两个独立 Agent 3. 使用 OpenClaw Manager 管理多实例 4. 为你的助手定制人格设定文件（SOUL.md）
💡 常见问题速查
contact:contact.base:readonly 权限是否添加 | |
openclaw doctor --fix 自动修复 | |
下一章预告：第 10 章将深入 API 集成，带你对接 Banana 绘图、Notion 同步、视频生成等第三方服务，构建多功能 AI 工具箱。
漫绘系列：漫绘OpenClaw-第9章多平台集成
