乐于分享
好东西不私藏
夜雨聆风 > > 办公文件 > OpenClaw 多飞书 AppID 配置

OpenClaw 多飞书 AppID 配置

当前时间： 2026-08-15 21:27:00 分类：办公文件 评论(0)
OpenClaw 多飞书 AppID 配置
我从来不懂什么叫 “过度设计”，只知道复杂是万恶之源。——Linus Torvalds

今天笔者想聊一聊 OpenClaw 最实用的功能之一：飞书消息渠道配置多个 AppID。

01
为什么要搞多个飞书 AppID？

很多业务场景里，多 AppID 是刚需： 

研发群要代码助手，运营群要数据助手，HR 群要人事助手，身份必须分开，权限不能混； 

不同团队的机器人要独立头像、独立名字、独立权限，互不干扰，出问题不互相背锅； 

业务拆分后，一个 AppID 权限太大、风险太高，拆分才是稳当做法。

Bad programmers worry about the code. Good programmers worry about data structures and their relationships.

放到这事上：烂架构堆功能，好架构分实例。OpenClaw 原生就支持多账号，多APPID（腾讯云后台管理界面不支持，需要手工修改配置文件，嗯，程序员的优势又出来了）。

01
配置文件设计

直接打开 ~/.openclaw/openclaw.json，找到 channels 飞书配置。

它的设计极其直白： 

• 每个 AppID 对应一个独立 account； 

• 每个 account 有独立 appId、appSecret、botName； 

• 每个 account 可绑定不同 Agent，消息路由精准隔离。

使用的就是简单的 “多账号映射”，清晰、直接、不出错。

01
3 步搞定配置

1. 飞书侧：创建多个企业自建应用

每个 AppID 对应一个飞书应用，步骤都一样：

  • 登录飞书开放平台，创建企业自建应用；
  • 拿到 AppID（cli_xxx 格式）和 AppSecret；
  • 开通权限：im:message、im:message.group_at_msg 等；
  • 启用机器人能力，事件订阅选 WebSocket（长连接）；
  • 发布应用，等待审核通过。

别偷懒，一个应用只干一件事，干净利落，避免脏数据和人格分裂。

2. OpenClaw 侧：写死配置，简单粗暴最可靠

直接改配置文件，比敲命令行更直观、更可控，完整配置示例如下：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "domain": "feishu",
      "accounts": {
        "dev_bot": {
          "appId": "cli_xxxxxxxx_dev",
          "appSecret": "your-dev-secret",
          "botName": "研发助手",
          "groupAllowFrom": ["ou_id_dev"]
        },
        "ops_bot": {
          "appId": "cli_xxxxxxxx_ops",
          "appSecret": "your-ops-secret",
          "botName": "运营助手",
          "groupAllowFrom": ["ou_id_ops"]
        },
        "hr_bot": {
          "appId": "cli_xxxxxxxx_hr",
          "appSecret": "your-hr-secret",
          "botName": "人事助手",
          "groupAllowFrom": ["ou_id_hr"]
        }
      }
    }
  },
  "agents": {
    "list": [
      {
        "id": "dev_agent",
        "name": "研发Agent",
        "workspace": "~/.openclaw/workspaces/dev"
      },
      {
        "id": "ops_agent",
        "name": "运营Agent",
        "workspace": "~/.openclaw/workspaces/ops"
      },
      {
        "id": "hr_agent",
        "name": "人事Agent",
        "workspace": "~/.openclaw/workspaces/hr"
      }
    ]
  },
  "bindings": [
    {
      "channel": "feishu",
      "account": "dev_bot",
      "agentId": "dev_agent"
    },
    {
      "channel": "feishu",
      "account": "ops_bot",
      "agentId": "ops_agent"
    },
    {
      "channel": "feishu",
      "account": "hr_bot",
      "agentId": "hr_agent"
    }
  ]
}

核心就三点： 

• accounts 里按业务定义多个机器人账号； 

• agents 里创建对应的业务处理实例； 

• bindings 把账号和 Agent 一一绑定，消息来一个、路由一个、互不串。

3. 重启网关，生效

01
运行重启命令

openclaw gateway restart

完事。重启即生效。