OpenClaw 飞书渠道配置问题解决备忘录

问题背景

日期 :2026-04-08
版本 :1Panel 部署的 OpenClaw,从 3.28(2026.3.28)升级至 2026.4.7
现象:容器启动后卡住循环重启,日志反复出现:

复制代码
Config invalid
File: ~/.openclaw/openclaw.json
Problem:
  - channels.feishu: unknown channel id: feishu
Run: openclaw doctor --fix

根本原因

原因一:1Panel 镜像的飞书插件路径问题

路径 说明
OPENCLAW_BUNDLED_PLUGINS_DIR=/app/extensions 容器默认的 bundled 插件目录(不含 feishu)
/app/dist/extensions/feishu/ feishu 插件的实际位置(编译好的 .js 版本)

结论 :1Panel 的 openclaw:latest 镜像打包时,/app/extensions/ 目录里没有包含 feishu 插件 ,但 feishu 的编译版本存在于 /app/dist/extensions/feishu/。环境变量指向错误,导致 openclaw 始终找不到 feishu 插件。

原因二:旧版配置字段不兼容

旧配置中包含以下字段,在新版本 schema 严格校验下不被支持 ,会导致 must NOT have additional properties 错误:

json 复制代码
"replyInThread": "disabled",
"topicSessionMode": "disabled",
"reactionNotifications": "own",
"renderMode": "card",
"actions": { "reactions": true },
"typingIndicator": true,
"resolveSenderNames": true,
"streaming": true,
"blockStreaming": true,
"textChunkLimit": 2000,
"mediaMaxMb": 30,
"webhookPath": "/feishu/events"

注意:typingIndicator、resolveSenderNames、streaming 等字段在 2026.4.x 版本中已移至插件内部默认值,不再允许在 channel 配置中手动指定。


解决方案

步骤一:修改 docker-compose.yml(需要 root 权限)

文件路径:/opt/1panel/apps/openclaw/openclaw/docker-compose.yml

在 environment 下添加一行环境变量,并将镜像版本指定为 2026.4.7:

yaml 复制代码
environment:
    HOME: /home/node
    TERM: xterm-256color
    OPENCLAW_BUNDLED_PLUGINS_DIR: /app/dist/extensions  # ← 新增此行
image: 1panel/openclaw:2026.4.7                         # ← 指定版本

作用 :将 openclaw 的 bundled 插件目录覆盖为 /app/dist/extensions,使其能正确找到 feishu 插件。

步骤二:重建容器

bash 复制代码
docker stop 1Panel-openclaw-7tjZ
docker rm 1Panel-openclaw-7tjZ
cd /opt/1panel/apps/openclaw/openclaw
docker compose up -d

或在 1Panel 管理面板中保存配置后重启。

步骤三:写入正确的飞书 channel 配置

容器启动后执行:

bash 复制代码
docker exec 1Panel-openclaw-7tjZ python3 -c "
import json

with open('/home/node/.openclaw/openclaw.json', 'r') as f:
    config = json.load(f)

# 添加 feishu 插件
plugins = config.setdefault('plugins', {})
allow = plugins.setdefault('allow', [])
if 'feishu' not in allow:
    allow.append('feishu')
plugins.setdefault('entries', {})['feishu'] = {'enabled': True, 'config': {}}

# 写入 feishu channel 配置(仅使用 2026.4.x 支持的字段)
config['channels']['feishu'] = {
    'enabled': True,
    'defaultAccount': 'main',
    'accounts': {
        'main': {
            'appId': 'cli_a94ba863b9f9dcb1',
            'appSecret': 'DWJWRZMIqMRIXriLsxNBYfTw'
        },
        'hoare': {
            'appId': 'cli_a948989a8879dcd3',
            'appSecret': 'z2Xj6thGjUzHccuFDwBfCjbN8'
        }
    },
    'domain': 'feishu',
    'connectionMode': 'websocket',
    'dmPolicy': 'open',
    'allowFrom': ['*'],
    'groupPolicy': 'open',
    'requireMention': True
}

with open('/home/node/.openclaw/openclaw.json', 'w') as f:
    json.dump(config, f, indent=2, ensure_ascii=False)
print('配置写入完成')
"

验证成功的标志

容器日志出现以下内容即为成功:

log 复制代码
[gateway] feishu_doc: Registered feishu_doc, feishu_app_scopes
[gateway] feishu_chat: Registered feishu_chat tool
[gateway] feishu_wiki: Registered feishu_wiki tool
[gateway] feishu_drive: Registered feishu_drive tool
[gateway] feishu_bitable: Registered bitable tools
[gateway] ready (4 plugins, 1.4s)          ← 插件数从3变4
[feishu] feishu[main]: bot open_id recovered: ou_xxx   ← WebSocket连接成功

最终配置状态

docker-compose.yml 关键配置

yaml 复制代码
environment:
    HOME: /home/node
    TERM: xterm-256color
    OPENCLAW_BUNDLED_PLUGINS_DIR: /app/dist/extensions
image: 1panel/openclaw:2026.4.7

openclaw.json 飞书 channel 配置(2026.4.x 兼容版)

json 复制代码
"feishu": {
  "enabled": true,
  "defaultAccount": "main",
  "accounts": {
    "main": {
      "appId": "cli_a94ba863b9f9dcb1",
      "appSecret": "DWJWRZMIqMRIXriLsxNBYfT"
    },
    "hoare": {
      "appId": "cli_a948989a8879dcd3",
      "appSecret": "z2Xj6thGjUzHccuFDwBfCjbN8"
    }
  },
  "domain": "feishu",
  "connectionMode": "websocket",
  "dmPolicy": "open",
  "allowFrom": ["*"],
  "groupPolicy": "open",
  "requireMention": true
}

问题根因(两个):

镜像路径问题:1Panel 的 openclaw 镜像默认 OPENCLAW_BUNDLED_PLUGINS_DIR=/app/extensions,但 feishu 插件实际在 /app/dist/extensions/feishu/,路径对不上所以始终报 unknown channel id: feishu

配置字段不兼容:旧配置里的 replyInThread、topicSessionMode、renderMode、typingIndicator 等字段在新版本 schema 严格校验下不被支持

解决方案核心(一行环境变量):

在 docker-compose.yml 的 environment 下加:

OPENCLAW_BUNDLED_PLUGINS_DIR: /app/dist/extensions

升级时记住:每次换新镜像版本,这个环境变量必须保留,且 feishu channel 配置只保留文档明确支持的字段。

相关推荐
前进的李工4 天前
Agent 学习笔记 15:Agent 怎样响应事件与中途打断?
人工智能·笔记·agent·openclaw·工具设计·gpt-6 astra·原生异步
w3296362715 天前
飞书接单到月度结算:我用一个 DSH 插件跑通鞋类采购 WMS,附 22 项验收
pdf·node.js·飞书·后端开发·ai agent
宝哥聊编程17 天前
主流 Agent 平台对比:Coze、Dify、飞书、扣子、OpenClaw 落地实操手册
前端·人工智能·飞书
guoran_shini19 天前
Agent系统服务化封装和IM接入
飞书
xzlAwin21 天前
Win10 安装OpenClaw 龙虾
ai·openclaw·龙虾
mudtools21 天前
在飞书 SDK 上用 Microsoft Agent Framework 搭一个能干活的工作搭子
人工智能·ai·.net·飞书·agent
极致了22 天前
飞书插件、RPA、API三条路的真实分界线
飞书·rpa
玩泥巴的23 天前
在飞书 SDK 上用 Microsoft Agent Framework 搭一个能干活的工作搭子
ai·.net·飞书·agent
玩泥巴的24 天前
一份声明,多份产物:飞书 SDK 的 AI 工具面是怎么生成的
ai·.net·飞书·agent