OpenClaw进阶配置指南:在飞书打造你的AI员工团队

随着OpenClaw日常使用场景的增加,如果将所有任务都交给同一个AI助手,容易导致其“记忆混乱”或上下文超载。 本文档将指导您如何利用OpenClaw 的多Agent智能体机制,结合火山引擎方舟大模型,在飞书中创建多个独立的AI 员工(例如:专门负责写文案的助手、专门负责写代码的助手等),实现专人专岗,互不干扰。

⚠️部署前须知(请务必阅读):

  1. 版本要求: 多 Agent 机制为高级特性,您的 OpenClaw 应用版本必须升级至 2026.3.2 或更高版本方可支持本教程中的操作。
  2. 性能与资源说明:每一个独立的 Agent 都会在您的服务器上占用一定的内存和计算资源。您可以部署的 Agent 数量上限及运行流畅度,直接取决于您当前 ECS 实例的硬件配置。若您计划部署较多数量的 Agent,建议提前在火山引擎控制台升级您的实例规格,以保障多并发下的响应速度。

步骤一:在飞书创建独立的机器人应用

每增加一个AI员工,我们就需要在飞书开放平台创建一个对应的机器人应用。

  1. 创建企业自建应用: 使用企业管理员或开发者账号登录飞书开发者平台,单击“创建企业自建应用”按钮,填写机器人名称和头像。
  2. 获取凭证: 进入应用后,在左侧菜单点击凭证与基础信息,复制并保存 App IDApp Secret,稍后配置时需要用到。

picture.image

  1. 开通权限: 在左侧菜单点击 添加应用能力 -> 添加 机器人。

picture.image

  1. 在左侧目录树选择“开发配置 > 权限管理”,单击“批量导入/导出权限”按钮。

picture.image

  1. 在“导入”页签中,将如下权限替换原有示例,单击“下一步,确认新增权限”按钮。
{
  "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"
    ]
  }
}
  1. 在弹窗中确认权限无误后,单击“申请开通”按钮。

picture.image

  1. 单击“配置”按钮设置权限可访问的数据范围(本文保持默认“与应用的可用范围一致”),单击“确定”按钮完成操作。

picture.image

  1. 创建版本 权限开通后,点击 版本管理与发布 -> 创建版本,暂存当前配置(稍后配置完长连接后还需重新发布)。

步骤二:配置 OpenClaw 网关(Gateway)

接下来,我们需要在 Linux 服务器上修改 OpenClaw 的配置文件,将刚刚创建的飞书机器人接入系统。

  1. 编辑配置文件

登录到您的火山引擎 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" 是为新机器人自定义的标识名,您可以按需修改。

  1. 重启网关服务: 保存文件后,在终端执行以下命令使配置生效:
openclaw gateway restart

步骤三:完成飞书事件与回调配置

网关重启后,回到飞书开发者后台,完成最后的通讯配置。

  1. 选择“企业自建应用”页签,并单击您创建的飞书开放应用。

picture.image

  1. 在左侧目录树选择“开发配置 > 事件与回调”。

    1.   选择“事件配置”页签,单击“订阅方式”旁的编辑按钮。

picture.image

选择“使用 长连接 接收事件”,并单击“保存”按钮。

picture.image

  1. 在“已添加事件”区域,单击“添加事件”按钮。

picture.image

  1. 在添加事件对话框中,选择“应用身份订阅”页签,搜索“消息”并勾选“接收消息”、“消息被reaction”及“消息被取消reaction”三个事件,单击“确认添加”按钮。

picture.image

  1. 回调配置

选择“回调配置”页签,单击“订阅方式”旁的编辑按钮。选择“使用 长连接 接收回调”,并单击“保存”按钮。

picture.image

在添加回调对话框中,选择“卡片”页签,并勾选“卡片回传交互”,单击“确认添加”按钮。

picture.image

  1. 重新发布应用 完成上述配置后,前往版本管理与发布,重新发布一个新版本。您的企业成员现在可以在飞书中搜索到这个新机器人了。

步骤四:在服务器创建并绑定子 Agent

现在,我们要在 OpenClaw 系统内创建一个独立的工作区(Workspace)来充当这个新员工的大脑,并与火山引擎方舟大模型对接。

  1. 创建子 Agent 在服务器终端输入以下命令(注意将 xiaoniu 替换为您在第二步设定的标识名):
openclaw agents add xiaoniu

按照终端的交互提示,在步骤"Configure model/auth for this agent now?"及"Configure chat channels now?"时都选择选择 No ,因为我们已在 JSON 文件中配过了。

picture.image

picture.image

  1. 绑定飞书应用 执行以下命令,将新建的 Agent 与飞书通道绑定:
openclaw agents bind --agent xiaoniu --bind feishu:xiaoniu

picture.image

  1. ‼️再次重启网关 务必再次执行重启命令,防止不同机器人的对话内容串台:
openclaw gateway restart
  1. 获取并校验匹配码 打开飞书客户端,给刚刚创建的机器人发送任意消息,它会回复一串“匹配码”(Pairing Code)。

picture.image

  1. 回到服务器终端,执行以下命令完成最终授权:
openclaw pairing approve feishu [此处填入飞书上显示的匹配码]

picture.image


步骤五:为您的 AI 员工注入“灵魂”(人设配置)

为了让新 Agent 表现得像一个专业的特定岗位员工(如文案策划),我们需要修改其工作区下的三个核心 Markdown 文件。

进入该 Agent 的工作区目录(通常位于 ~/.openclaw/workspace-xiaoniu/):

  1. IDENTITY.md(我是谁) 决定 AI 的角色设定和语言风格。
  2. USER.md(我在为谁服务) 描述您的个人偏好和要求,让 AI 提供个性化服务。
  3. SOUL.md(我的价值观与潜意识) 定义 AI 的思维模式。

💡 进阶技巧: 您可以将上述配置要求直接发给火山引擎方舟(如 Doubao-pro 模型),让大模型帮您自动生成这三个 MD 文件的规范内容,然后粘贴进服务器即可。

至此,您的独立 AI 员工已正式上岗!您可以重复上述步骤,为您团队组建包括研发、数据分析、文案策划在内的完整 AI 员工矩阵。

0
0
0
0
评论
未登录
暂无评论