admin

  • 本文记录我在使用 OpenClaw + 飞书时的一些配置信息,因为偶尔需要操作,故记录如下。

    1. 在 OpenClaw 中添加多个 Agent

    这一次是需要新增一个叫 Clark 的 Agent ,该 Agent 用于在本地执行 Codex 完成一些复杂的任务。所以,特别的编写了一个对应的 Skill 用于告诉 OpenClaw 如何按照我的要求使用 Codex 。

    1.1 添加新的 agent

    openclaw agents add openclaw-codex
    ...(一些配置,需要注意,按需调整 workspace 的位置)
    openclaw tui
    /agent openclaw-codex

    如果要切换当前的默认的agent,可以使用如下命令:

    cd ~/.openclaw/workspace-family-magazine/
    openclaw tui
    -- or --
    openclaw config set agents.defaults.workspace "/home/ubuntu/.openclaw/workspace-family-magazine"
    openclaw tui

    完成了 Agent 添加后,接着是 SKILL 的配置以及飞书 IM 的配置。

    2. 飞书的多 Agent 配置

    当只有单个 Agent 时,要配置飞书 IM 连接时,可以参考本文档的附录小结:“OpenClaw 内置插件教程(从零配置)”。本节主要介绍,当有多个 Agent 时,如何使用多个聊天机器人分别于不同的 Agent 通信。

    在目前阶段,OpenClaw 依旧是面向于开发者的产品。例如,这里为了配置多 Agent ,并同时使用飞书进行管理时,整个的配置过程,就不是很简单,不喜欢折腾的开发者大概是会放弃的(注:当前版本 OpenClaw 2026.4.23 (a979721) )。

    首先,在开始配置之前,需要理解一些概念:

    • openclaw 中的“Agent”: openclaw 可以支持多 Agent 运行,每个 Agent 可以完成完全独立的一些事情,每个 Agent 都有自己的对的 workspace,以及完全独立的 SOUL/USER.md 等文件。大多数时候,我们默认的,都是只是默认的、“main” 这个 Agent。为了更好的管理,我这里额外在openclaw 中配置了一个叫“english Echo” 的Agent。可以参考本文档的章节“在 OpenClaw 中添加多个 Agent”了解多个 Agent 的添加。
    • openclaw 中的 “channel”:channel 是指聊天通道,例如,与飞书的聊天通道。需要特别注意的是,通常,我们在这个通道中仅会配置一个 App(开放平台上的应用,对应于一个机器人)。但,要比较好的启用多 Agent 功能,这里需要建两个或多个 App (飞书开放平台的应用),从而我的飞书就可以与不同的飞书机器人对话,从而与不同的Agent 通信。

    如果只是看上述的描述,大概比较难理解,这里先看看最终配置的效果,再看看对应的配置文件,从而完整的理解配置、以及如何使用。

    2.1 飞书的 channel 配置

    为了实现个人飞书能够通过两个独立的飞书机器人去调用一个openclaw 中的两个 Agent 。如右图注意到,机器人 Echo 和 Mike 都来自同一个 openclaw 中两个独立的 Agent。

    例如,这里的 Echo 是一个英语助手,Mike 则是一个通用助手。而在 openclaw 中两个Agent 对应完全不同的workspace,也就是使用完全不同的 SOUL.md、IDENTITY.md 等。

    如下的文本图描述了“消息流”,即我的飞书消息会到不同的机器人,然后 openclaw 的 Gateway 则将消息根据配置文件的绑定规则(即Binding 部分)将消息分发到不同 Agent 。文本图如左下:

                                     ------- OpenClaw -----
                                     |                    |
                                     |                    |
                 ---> feishu bot 1 ---   --> Agent 1      |
                 |                   |   |                |
     [ feishu ] -|                Gateway-                |
     [  chat  ]  |                   |   |                |
                 ---> feishu bot 2 ---   --> Agent 2      |
                                     |                    |
                                     |                    |
                                     ----------------------

    右边则是对应 “channels” 部分的配置,即在 “feishu”这个 channels 下有两个 accounts,分别是 main和english,根据对应 appId 则对应于聊天机器人 Mike 和 Echo。

      "channels": {
        "feishu": {
          "defaultAccount": "main",
          "accounts":{
            "main": {
              "enabled": true,
              "appId": "cli_***",
              "appSecret": "Qo92***",
              "connectionMode": "websocket",
              "domain": "feishu",
              "groupPolicy": "allowlist"
            },
            "english": {
              "enabled": true,
              "appId": "cli_***",
              "appSecret": "4y9h***",
              "connectionMode": "websocket",
              "domain": "feishu",
              "groupPolicy": "allowlist"
            }
          }
        }
      },

    2.2 飞书的 bindings 配置

    在新建了飞书的账号(channels.accounts)后,还需要将其于对应的 Agent 进行绑定,这样 Gateway 才知道该将对应机器人的转发给对应的Agent。这个绑定则由右边的配置文件来描述。

    新增 Agent 则新增配置:

      "bindings": [
        ...
        {
          "agentId": "openclaw-codex",
          "match": {
            "channel": "feishu",
            "accountId": "codex"
          }
        }
      ],
      "bindings": [
        {
          "agentId": "main",
          "match": {
            "channel": "feishu",
            "accountId": "default"
          }
        },
        {
          "agentId": "english",
          "match": {
            "channel": "feishu",
            "accountId": "english"
          }
        }
      ],

    2.3 终端使用 TUI

    TUI 是 Text User Interface 的缩写,在 openclaw 中也可以通过 TUI 的方式更为方便的与多Agent 对话。首先通过 openclaw tui进入 TUI,然后使用 /agent english 即可与对应的 Agent 对话:

    openclaw tui
     session agent:main:main
     ...
     If you want, give me a real task and I’ll show you instead of pitching myself.
     gateway connected | idle
     agent main | session main (heartbeat) | openai/gpt-5.4 | think low | tokens 10k/272k (4%)
    ─────────────────────────────────────────────────────────────────────────────────────
    
    ─────────────────────────────────────────────────────────────────────────────────────

    在 TUI 中则可以通过 /agent english 进行 Agent 切换:

     session agent:english:main
     ...
     connected | idle
     agent english (english) | session main (openclaw-tui) | openai/gpt-5.4 | think low | tokens 11k/272k (4%)
    ───────────────────────────────────────────────────────────────────────────────────────────────────────────
    
    ───────────────────────────────────────────────────────────────────────────────────────────────────────────

    2.4 session key

    上述内容中,值得注意的是,两个 session 取值分别为:session agent:english:main和session agent:main:main。在实现底层,这时非常重要两个值,Gateway 用来管理不同的 session 。适当的理解这个这个值,则对我们理解和配置 openclaw 非常重要:

    agent : english : main
    agent : main    : main
    agent :<agentId>:<sessionKey>

    三列分别表示:

    • agent “这是一个 agent 会话”
    • <agentId> 对应的 agent 是哪个?如果使用的是默认的agent则通常是 main
    • <sessionKey> 这个对话对应“名称”,默认也是 main

    如果通过某个具体的 IM 与Agent 通信,那么对应的 Key 则可能是如下样子:

    agent:main:feishu:direct:ou_80d10b4***********************5df8

    附录

    🚀 OpenClaw 内置插件教程(从零配置)

    该部分参考链接:openclaw-feishu/README.md

    适用于:第一次使用 OpenClaw + 飞书的新用户,选择 OpenClaw 内置插件方案。 前提:已安装 OpenClaw 并正常运行(openclaw gateway status 能看到状态)。 预计耗时:15–20 分钟。

    第一步:创建飞书应用(机器人)

    1. 打开 飞书开放平台,用飞书账号登录
    2. 点击 创建企业自建应用
    3. 填写应用名称(随意,比如 “我的 AI 助手”)和描述
    4. 选一个图标(可以之后改)
    第二步:启用机器人能力

    进入你刚创建的应用:

    1. 左侧菜单找到 应用能力 > 机器人
    2. 开启机器人能力
    3. 给机器人起个名字
    第三步:配置权限

    1. 左侧菜单进入 权限管理
    2. 点击 批量导入
    3. 粘贴以下 JSON(一键导入所有需要的权限):
    {
      "scopes": {
        "tenant": [
          "aily:file:read",
          "aily:file:write",
          "application:application.app_message_stats.overview:readonly",
          "application:application:self_manage",
          "application:bot.menu:write",
          "cardkit:card:write",
          "contact:user.employee_id:readonly",
          "corehr:file:download",
          "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"
        ]
      }
    }
    第四步:配置事件订阅

    ⚠️ 这一步必须在 OpenClaw 网关启动后再做,否则保存会失败。 先做第五、六步,回来再做这一步也可以。

    1. 左侧菜单进入 事件与回调 > 事件配置
    2. 请求方式选择:使用长连接接收事件(这是关键!不需要公网服务器)
    3. 添加事件:搜索 im.message.receive_v1(接收消息),勾选添加
    第五步:记下凭证

    在应用的 凭证与基础信息 页面,复制:

    • App ID(格式如 cli_xxxxxxxxx)
    • App Secret

    ❗ App Secret 很重要,请妥善保管,不要分享。

    第六步:发布应用

    1. 左侧菜单 版本管理与发布
    2. 创建版本 → 填写版本说明 → 提交
    3. 等待审批(企业内部应用通常自动通过,几秒到几分钟)
    第七步:在 OpenClaw 中配置飞书

    OpenClaw ≥ 2026.2 已内置飞书插件,不需要额外安装,直接配置即可。

    💡 如果你在首次 openclaw setup 时看到 “Install Feishu plugin?”,选择 “Download from npm” 即可进入配置流程。选了 “Skip” 也没关系,用下面的命令随时添加。

    打开 终端(Terminal):

    # 1. 添加飞书渠道(交互式,跟着提示走)
    openclaw channels add
    # 选择 Feishu → 粘贴 App ID → 粘贴 App Secret
    第八步:发消息测试
    1. 在飞书里搜索你的机器人名字,打开对话
    2. 发一条消息,比如”你好”
    3. 如果机器人回复了配对码,在终端运行:
    openclaw pairing approve feishu <配对码>
    1. 授权后再发一条消息,收到正常回复 = 配置完成 🎉

    回来补第四步:如果你先跳过了事件订阅,现在网关已启动,回到飞书开放平台把第四步做完,保存后重启网关(openclaw gateway restart)。

    第九步(可选):让机器人开机自启
    openclaw gateway install

    这样电脑重启后机器人也会自动上线。

  • This content is password-protected. To view it, please enter the password below.

  • This content is password-protected. To view it, please enter the password below.

  • This content is password-protected. To view it, please enter the password below.

  • This content is password-protected. To view it, please enter the password below.

  • This content is password-protected. To view it, please enter the password below.