OpenClaw飞书配置避坑指南：8个常见问题与解决方案

OpenClaw飞书配置失败？本文详解8个常见坑点：groupPolicy设置、enabled配置、权限授权、群ID绑定、subagent调用等问题，附带30分钟速通checklist。

坑1：groupPolicy设成open，群里被刷屏 ​

一开始图省事，配置写成了这样：

{
  "channels": {
    "feishu": {
      "groupPolicy": "open"
    }
  }
}

结果Bot一进群，所有人发的消息它都回。

正确做法：

{
  "channels": {
    "feishu": {
      "groupPolicy": "allowlist",
      "groupAllowlist": ["oc_xxx", "oc_yyy"]
    }
  }
}

只有 groupAllowlist 里的群，Bot 才会响应。

坑2：enabled忘了写，Bot根本不启动 ​

配置检查了三遍，但Bot就是没反应。日志里连飞书频道的影子都没有。

最后发现，少了这一行：

{
  "channels": {
    "feishu": {
      "enabled": true
    }
  }
}

血泪教训：配完config，先检查enabled。

坑3：权限加了但没重新授权 ​

我在飞书后台加了文档权限、消息权限、云空间权限，全加上了。但Bot还是说"我没有权限"。

最后在飞书后台点了「重新授权」，好了。

关键点：

飞书权限管理有三层：

• 申请权限
• 管理员授权
• 重新授权让权限生效

坑4：用群名称绑定Agent，死活不生效 ​

配置写成：

{
  "bindings": [
    {
      "agentId": "dev",
      "match": {
        "peer": {
          "id": "技术开发实验室"
        }
      }
    }
  ]
}

用了群名称，结果完全没用。

必须用Chat ID，就是oc_开头那串字符：

{
  "bindings": [
    {
      "agentId": "dev",
      "match": {
        "peer": {
          "id": "oc_a56feea76a7bab8aa9def44353f26294"
        }
      }
    }
  ]
}

坑5：subagent调用报错"allowed: none" ​

一调用sessions_spawn就报错：

agentId is not allowed for sessions_spawn (allowed: none)

需要在根级别加配置：

{
  "acp": {
    "allowedAgents": ["research", "content", "dev", "media"]
  }
}

坑6：创建文档后打不开，只有Bot能看 ​

让Bot创建飞书文档，创建成功了，点进去却显示「你没有权限查看此文档」。

创建文档时要指定owner_open_id：

{
  "action": "create",
  "title": "新文档",
  "owner_open_id": "ou_b41062fdea541153a3ce577be16fb5a8"
}

坑7：创建根目录文件夹，直接报错400 ​

没传folder_token，想着默认在根目录创建。结果报错：

400 Bad Request - Bot has no root folder

Bot用的是tenant_access_token，只能操作被共享给它的文件夹。

坑8：Markdown表格不支持，格式全乱了 ​

feishu_doc不支持Markdown表格，只支持基本格式。

表格怎么办？用create_table动作：

{
  "action": "create_table_with_values",
  "doc_token": "ABC123",
  "row_size": 3,
  "column_size": 2,
  "values": [
    ["配置项", "说明"],
    ["enabled", "是否启用"],
    ["appId", "应用ID"]
  ]
}

30分钟速通 Checklist ​

第一步：飞书后台（10分钟） ​

• 创建企业自建应用
• 添加机器人能力
• 批量导入权限
• 申请权限并等待审批
• 发布应用版本
• 记录App ID和App Secret

第二步：OpenClaw配置（10分钟） ​

• 安装飞书插件：openclaw plugins install feishu
• 配置channels.feishu（enabled=true, appId, appSecret）
• 设置groupPolicy为allowlist
• 添加群ID到groupAllowlist
• 配置Agent绑定（用Chat ID，不是群名称）

第三步：测试验证（10分钟） ​

• 启动Gateway：openclaw gateway run
• 在群里@Bot，测试消息收发
• 测试文档创建（检查权限）

记住三点：

1. 配置要完整：enabled、groupPolicy、权限授权缺一不可
2. 用ID不用名称：Chat ID、open_id，别用群名称
3. 权限分两层：应用权限 + 资源权限，都要处理