OpenClaw 提供了基于 Gateway 的飞书应用与 AI Agent 对接方案。系统采用多 Agent 架构，每个飞书机器人对应独立的 AI Agent，拥有专属的工作空间、知识库和模型配置。
核心隔离机制
设计之初就考虑了多租户场景下的数据隔离问题：
- 每个 Agent 的模型状态完全独立，互不干扰。
- 每个 Agent 对应一个飞书机器人实例。
- 技能（Skills）单独安装维护，避免冲突。
- 模型切换仅对当前会话生效，持久化到 Agent 配置中。
- 严格隔离：每个 Agent 拥有独立的 workspace 和数据目录。
添加新 Agent
使用 CLI 工具可以快速创建新的 Agent 实例。以下命令展示了如何添加财务助手和代码助手，并设置它们的身份标识。
# 添加 agent
openclaw agents add finance_agent
openclaw agents add code_agent
# 设置身份
openclaw agents set-identity --agent code_agent --name "全栈开发专家"
openclaw agents set-identity --agent main --name "OpenClaw" --emoji "🦞" --avatar avatars/openclaw.png
# 查看 agents 列表
openclaw agents list
安装与配置过程
执行添加命令后，系统会引导你完成工作空间目录选择、认证配置文件复制以及模型配置。注意，这里需要输入有效的 API Key，生产环境中请妥善保管，切勿泄露。
cobrew@DESKTOP-9449JCG:~$ openclaw agents add finance_agent
?? OpenClaw 2026.3.13 (61d171a) ? Your AI assistant, now without the $3,499 headset.
┌ Add OpenClaw agent │ ◇ Workspace directory │ /home/cobrew/.openclaw/workspace-finance_agent
│ ◇ Copy auth profiles from "main"? │ Yes
│ ◇ Configure model/auth for this agent now? │ Yes
│ ◇ Model configured ──────────────────────────────────────────────? │ Default model set to xiaomi/mimo-v2-flash for agent "finance_agent".
│ ◇ Channel status ────────────────────? │ Feishu: install plugin to enable
└ Agent "finance_agent" ready.
在日志输出中，你可能会看到类似 Model not found 的提示，这通常意味着默认模型未预装或名称有误，此时可运行 /models list 查看可用模型。此外，Feishu 通道默认处于未启用状态，需要安装插件才能激活。
插件加载与验证
配置完成后，系统会自动扫描并注册相关插件。以下是 Feishu 插件加载的典型日志片段，确认这些工具是否成功注册至关重要。
cobrew@DESKTOP-9449JCG:~$ openclaw agents add code_agent
[plugins] plugins.allow is empty; discovered non-bundled plugins may auto-load: feishu (/home/cobrew/.npm-global/lib/node_modules/openclaw/extensions/feishu/index.ts)
[plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
[plugins] feishu_chat: Registered feishu_chat tool
[plugins] feishu_wiki: Registered feishu_wiki tool
[plugins] feishu_drive: Registered feishu_drive tool
