基于 @larksuite/openclaw-lark 官方飞书插件,实现一个飞书企业下多个机器人应用分别对接不同 AI Agent 的完整配置方案。
本文档基于 OpenClaw 2026.3.13 + openclaw-lark 2026.3.17 实际部署验证。
目录
-
架构概览
-
环境要求
-
第一步:安装 OpenClaw
-
第二步:配置模型
-
第三步:飞书开放平台创建机器人
-
第四步:安装飞书官方插件
-
第五步:配置 openclaw.json
-
飞书频道配置
-
多 Agent 定义
-
Bindings 路由
-
工具与协作
-
会话与记忆
-
第六步:准备 Agent 工作空间
-
第七步:启动与验证
-
群聊配置
-
踩坑记录
-
常用运维命令
-
完整配置参考
架构概览
飞书企业├── 主助手 Bot (cli_xxx1) ──→ main Agent (DeepSeek-chat)├── 开发助手 Bot (cli_xxx2) ──→ developer Agent (deepseek-chat)├──写作助手 Bot (cli_xxx3) ──→ writer Agent (openrouter/auto)├──分析助手 Bot (cli_xxx4) ──→ analyst Agent (openrouter/auto)└── 运维助手 Bot (cli_xxx5) ──→ ops Agent (deepseek-chat) │ OpenClaw Gateway (单进程) openclaw-lark 插件 (WebSocket)
核心思路:同一飞书企业下创建多个机器人应用,每个机器人在 OpenClaw 中作为一个account,通过bindings路由到不同的 Agent。 每个 Agent 拥有独立的工作空间、性格文件(SOUL.md)、记忆和模型配置。
环境要求
| 依赖 | 版本要求 | 说明 |
|---|---|---|
| Node.js | >= 22 | 推荐 v22 LTS |
| OpenClaw | >= 2026.2.26 | 多 Agent bindings 需要 >= 2026.3.13 |
| 操作系统 | Linux / macOS | 推荐 Linux + systemd |
第一步:安装 OpenClaw
npm install -g openclawopenclaw -v# 输出: OpenClaw 2026.3.13
初始化配置:
openclaw config
按向导完成基础配置,会生成 ~/.openclaw/openclaw.json。
第二步:配置模型
DeepSeek(自有 API Key)
"models": { "mode": "merge", "providers": { "deepseek": { "baseUrl": "https://api.deepseek.com/v1", "apiKey": "sk-your-deepseek-api-key", "api": "openai-completions", "models": [ { "id": "deepseek-chat", "name": "DeepSeek Chat" }, { "id": "deepseek-reasoner", "name": "DeepSeek Reasoner" } ] } }}
OpenRouter(聚合模型路由)
openclaw auth add openrouter# 按提示输入 OpenRouter API Key
配置完成后 auth.profiles 会自动生成:
"auth": { "profiles": { "openrouter:default": { "provider": "openrouter", "mode": "api_key" } }}
Agent 中直接使用 "model": "openrouter/auto" 即可。
第三步:飞书开放平台创建机器人
在 飞书开放平台 上,为每个 Agent 创建一个企业自建应用。
3.1 创建应用
每个 Agent 创建一个应用,例如:主助手、开发助手、写作助手、分析助手、运维助手。
3.2 添加机器人能力
进入应用管理页面 → 添加应用能力 → 选择 机器人。
3.3 批量导入权限
权限管理 → 批量导入,粘贴以下 JSON:
{ "scopes": { "tenant": [ "aily:file:read", "aily:file:write", "application:application.app_message_stats.overview:readonly", "application:bot.menu:write", "cardkit:card:write", "contact:contact.base:readonly", "contact:user.employee_id:readonly", "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" ] }}
3.4 配置事件订阅
事件订阅 → 启用 长连接(WebSocket 模式) → 添加事件 im.message.receive_v1。
长连接模式不需要公网 IP,OpenClaw 主动连接飞书服务器,适合内网/NAT 环境。
3.5 发布应用
版本管理与发布 → 创建版本 → 提交发布。
发布后在 凭证与基础信息 页面获取 App ID(cli_xxx)和 App Secret。
每个机器人应用都要重复以上步骤。
第四步:安装飞书官方插件
openclaw plugins install @larksuite/openclaw-lark
验证安装:
openclaw status# Channels: Feishu ON OK# Plugins: Loaded: 1
第五步:配置 openclaw.json
以下为 ~/.openclaw/openclaw.json 中各核心配置段的详解。
1. 飞书频道配置
"channels": { "feishu": { "enabled": true, "domain": "feishu", "streaming": true, // ★ 默认机器人(主助手)凭证必须放在顶层,不要放在 accounts 里 "appId": "cli_主助手的AppID", "appSecret": "主助手的AppSecret", "botName": "主助手", // 私聊策略 "dmPolicy": "allowlist", "allowFrom": ["ou_你的用户OpenID"], // 群聊策略 "requireMention": true, "groupPolicy": "allowlist", "groupAllowFrom": ["oc_允许的群聊ID"], // ★ 其他机器人放在 accounts 里 "accounts": { "developer": { "appId": "cli_开发助手AppID", "appSecret": "开发助手AppSecret", "botName": "开发助手" }, "writer": { "appId": "cli_写作助手AppID", "appSecret": "写作助手AppSecret", "botName": "写作助手" }, "analyst": { "appId": "cli_分析助手AppID", "appSecret": "分析助手AppSecret", "botName": "分析助手" }, "ops": { "appId": "cli_运维助手AppID", "appSecret": "运维助手AppSecret", "botName": "运维助手", // 运维助手允许所有人对话 "dmPolicy": "open", "allowFrom": ["*"] } }, // 群组配置 "groups": { "*": { "requireMention": true }, "oc_指定群聊ID": { "requireMention": false, "groupPolicy": "open" } } }}
关键点:
-
默认机器人(main)的
appId/appSecret放在channels.feishu顶层,这是openclaw-lark插件的硬性要求(源码accounts.js中 default 账号只从顶层读取) -
其他机器人放在
accounts下面,key 名与 Agent ID 对应 -
每个 account 可以独立覆盖
dmPolicy、allowFrom等策略 -
doctor --fix会建议把顶层凭证移到accounts.default,不要执行,否则默认机器人会断连
2. 多 Agent 定义
"agents": { "defaults": { "compaction": { "mode": "safeguard" } }, "list": [ { "id": "main", "default": true, "name": "main", "workspace": "/root/.openclaw/workspace", "agentDir": "/root/.openclaw/agents/main/agent", "model": "deepseek/deepseek-chat" }, { "id": "developer", "name": "developer", "workspace": "/root/.openclaw/workspace-developer", "agentDir": "/root/.openclaw/agents/developer/agent", "model": "deepseek/deepseek-chat" }, { "id": "writer", "name": "writer", "workspace": "/root/.openclaw/workspace-writer", "agentDir": "/root/.openclaw/agents/writer/agent", "model": "openrouter/auto" }, { "id": "analyst", "name": "analyst", "workspace": "/root/.openclaw/workspace-analyst", "agentDir": "/root/.openclaw/agents/analyst/agent", "model": "openrouter/auto" }, { "id": "ops", "name": "运维助手", "workspace": "/root/.openclaw/workspace-ops", "agentDir": "/root/.openclaw/agents/ops/a…