Harness 与 Agent 工程 · Agent架构与协作 · 2026-03-21

OpenClaw+飞书官方插件 多Agent 部署指南

飞书企业高效部署多AI助手,OpenClaw+飞书插件实现智能分工协作。

核心内容:

  1. 多机器人应用对接不同AI Agent的完整配置方案
  2. 独立工作空间与性格文件实现个性化Agent
  3. 详细部署步骤与常见问题解决指南

基于 @larksuite/openclaw-lark 官方飞书插件,实现一个飞书企业下多个机器人应用分别对接不同 AI Agent 的完整配置方案。

本文档基于 OpenClaw 2026.3.13 + openclaw-lark 2026.3.17 实际部署验证。

目录

架构概览

飞书企业├── 主助手 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" } } }}

关键点:

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…
— 以上为试看内容(约 40%),开通会员后阅读全文 —

原文出处:https://www.53ai.com/news/Openclaw/2026032110695.html