随着OpenClaw日常使用场景的增加,如果将所有任务都交给同一个AI助手,容易导致其“记忆混乱”或上下文超载。 本文档将指导您如何利用OpenClaw 的多Agent智能体机制,结合火山引擎方舟大模型,在飞书中创建多个独立的AI 员工(例如:专门负责写文案的助手、专门负责写代码的助手等),实现专人专岗,互不干扰。
⚠️部署前须知(请务必阅读):
- 版本要求: 多 Agent 机制为高级特性,您的 OpenClaw 应用版本必须升级至
2026.3.2或更高版本方可支持本教程中的操作。- 性能与资源说明:每一个独立的 Agent 都会在您的服务器上占用一定的内存和计算资源。您可以部署的 Agent 数量上限及运行流畅度,直接取决于您当前 ECS 实例的硬件配置。若您计划部署较多数量的 Agent,建议提前在火山引擎控制台升级您的实例规格,以保障多并发下的响应速度。
步骤一:在飞书创建独立的机器人应用
每增加一个AI员工,我们就需要在飞书开放平台创建一个对应的机器人应用。
- 创建企业自建应用: 使用企业管理员或开发者账号登录飞书开发者平台,单击“创建企业自建应用”按钮,填写机器人名称和头像。
- 获取凭证: 进入应用后,在左侧菜单点击凭证与基础信息,复制并保存
App ID和App Secret,稍后配置时需要用到。
- 开通权限: 在左侧菜单点击 添加应用能力 -> 添加 机器人。
- 在左侧目录树选择“开发配置 > 权限管理”,单击“批量导入/导出权限”按钮。
- 在“导入”页签中,将如下权限替换原有示例,单击“下一步,确认新增权限”按钮。
{
"scopes": {
"tenant": [
"contact:contact.base:readonly",
"docx:document:readonly",
"im:chat:read",
"im:chat:update",
"im:message.group_at_msg:readonly",
"im:message.p2p_msg:readonly",
"im:message.pins:read",
"im:message.pins:write_only",
"im:message.reactions:read",
"im:message.reactions:write_only",
"im:message:readonly",
"im:message:recall",
"im:message:send_as_bot",
"im:message:send_multi_users",
"im:message:send_sys_msg",
"im:message:update",
"im:resource",
"application:application:self_manage",
"cardkit:card:write",
"cardkit:card:read"
],
"user": [
"contact:user.employee_id:readonly",
"offline_access",
"base:app:copy",
"base:field:create",
"base:field:delete",
"base:field:read",
"base:field:update",
"base:record:create",
"base:record:delete",
"base:record:retrieve",
"base:record:update",
"base:table:create",
"base:table:delete",
"base:table:read",
"base:table:update",
"base:view:read",
"base:view:write_only",
"base:app:create",
"base:app:update",
"base:app:read",
"board:whiteboard:node:create",
"board:whiteboard:node:read",
"calendar:calendar:read",
"calendar:calendar.event:create",
"calendar:calendar.event:delete",
"calendar:calendar.event:read",
"calendar:calendar.event:reply",
"calendar:calendar.event:update",
"calendar:calendar.free_busy:read",
"contact:contact.base:readonly",
"contact:user.base:readonly",
"contact:user:search",
"docs:document.comment:create",
"docs:document.comment:read",
"docs:document.comment:update",
"docs:document.media:download",
"docs:document:copy",
"docx:document:create",
"docx:document:readonly",
"docx:document:write_only",
"drive:drive.metadata:readonly",
"drive:file:download",
"drive:file:upload",
"im:chat.members:read",
"im:chat:read",
"im:message",
"im:message.group_msg:get_as_user",
"im:message.p2p_msg:get_as_user",
"im:message:readonly",
"search:docs:read",
"search:message",
"space:document:delete",
"space:document:move",
"space:document:retrieve",
"task:comment:read",
"task:comment:write",
"task:task:read",
"task:task:write",
"task:task:writeonly",
"task:tasklist:read",
"task:tasklist:write",
"wiki:node:copy",
"wiki:node:create",
"wiki:node:move",
"wiki:node:read",
"wiki:node:retrieve",
"wiki:space:read",
"wiki:space:retrieve",
"wiki:space:write_only"
]
}
}
- 在弹窗中确认权限无误后,单击“申请开通”按钮。
- 单击“配置”按钮设置权限可访问的数据范围(本文保持默认“与应用的可用范围一致”),单击“确定”按钮完成操作。
- 创建版本 权限开通后,点击 版本管理与发布 -> 创建版本,暂存当前配置(稍后配置完长连接后还需重新发布)。
步骤二:配置 OpenClaw 网关(Gateway)
接下来,我们需要在 Linux 服务器上修改 OpenClaw 的配置文件,将刚刚创建的飞书机器人接入系统。
- 编辑配置文件
登录到您的火山引擎 ECS 服务器,找到全局配置文件 openclaw.json先备份再进行编辑。
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak
vi ~/.openclaw/openclaw.json
添加飞书账号: 找到 channels -> feishu 字段,并在 accounts 中添加您的新飞书应用凭证。 配置示例如下:
"channels": {
"feishu": {
"accounts": {
"defaults": {
"appId": "原本已有的飞书应用ID",
"appSecret": "原本已有的飞书应用秘钥"
},
"xiaoniu": {
"appId": "刚刚新建的飞书应用ID",
"appSecret": "刚刚新建的飞书应用秘钥"
}
}
}
},
说明:此处的 "xiaoniu" 是为新机器人自定义的标识名,您可以按需修改。
- 重启网关服务: 保存文件后,在终端执行以下命令使配置生效:
openclaw gateway restart
步骤三:完成飞书事件与回调配置
网关重启后,回到飞书开发者后台,完成最后的通讯配置。
- 选择“企业自建应用”页签,并单击您创建的飞书开放应用。
-
在左侧目录树选择“开发配置 > 事件与回调”。
- 选择“事件配置”页签,单击“订阅方式”旁的编辑按钮。
选择“使用 长连接 接收事件”,并单击“保存”按钮。
- 在“已添加事件”区域,单击“添加事件”按钮。
- 在添加事件对话框中,选择“应用身份订阅”页签,搜索“消息”并勾选“接收消息”、“消息被reaction”及“消息被取消reaction”三个事件,单击“确认添加”按钮。
- 回调配置
选择“回调配置”页签,单击“订阅方式”旁的编辑按钮。选择“使用 长连接 接收回调”,并单击“保存”按钮。
在添加回调对话框中,选择“卡片”页签,并勾选“卡片回传交互”,单击“确认添加”按钮。
- 重新发布应用 完成上述配置后,前往版本管理与发布,重新发布一个新版本。您的企业成员现在可以在飞书中搜索到这个新机器人了。
步骤四:在服务器创建并绑定子 Agent
现在,我们要在 OpenClaw 系统内创建一个独立的工作区(Workspace)来充当这个新员工的大脑,并与火山引擎方舟大模型对接。
- 创建子 Agent 在服务器终端输入以下命令(注意将
xiaoniu替换为您在第二步设定的标识名):
openclaw agents add xiaoniu
按照终端的交互提示,在步骤"Configure model/auth for this agent now?"及"Configure chat channels now?"时都选择选择 No ,因为我们已在 JSON 文件中配过了。
- 绑定飞书应用 执行以下命令,将新建的 Agent 与飞书通道绑定:
openclaw agents bind --agent xiaoniu --bind feishu:xiaoniu
- ‼️再次重启网关 务必再次执行重启命令,防止不同机器人的对话内容串台:
openclaw gateway restart
- 获取并校验匹配码 打开飞书客户端,给刚刚创建的机器人发送任意消息,它会回复一串“匹配码”(Pairing Code)。
- 回到服务器终端,执行以下命令完成最终授权:
openclaw pairing approve feishu [此处填入飞书上显示的匹配码]
步骤五:为您的 AI 员工注入“灵魂”(人设配置)
为了让新 Agent 表现得像一个专业的特定岗位员工(如文案策划),我们需要修改其工作区下的三个核心 Markdown 文件。
进入该 Agent 的工作区目录(通常位于 ~/.openclaw/workspace-xiaoniu/):
- IDENTITY.md(我是谁) 决定 AI 的角色设定和语言风格。
- USER.md(我在为谁服务) 描述您的个人偏好和要求,让 AI 提供个性化服务。
- SOUL.md(我的价值观与潜意识) 定义 AI 的思维模式。
💡 进阶技巧: 您可以将上述配置要求直接发给火山引擎方舟(如 Doubao-pro 模型),让大模型帮您自动生成这三个 MD 文件的规范内容,然后粘贴进服务器即可。
至此,您的独立 AI 员工已正式上岗!您可以重复上述步骤,为您团队组建包括研发、数据分析、文案策划在内的完整 AI 员工矩阵。
