@yrzhao/openclaw-fs-plugin

@yrzhao/openclaw-fs-plugin 是一个 OpenClaw 飞书插件。它的目标不是让你先手工创建一堆配置，而是把“飞书接入 OpenClaw”做成一条尽量自动化的主流程。

执行 openclaw feishu-connect 后，插件会：

1. 拉起一个受控的可见浏览器窗口
2. 进入飞书开放平台，等待你扫码登录
3. 使用全新浏览器会话，强制走“新建应用”而不是复用旧应用页面
4. 尝试自动完成应用创建、凭据提取、权限页跳转
5. 将 channels.feishu 和 plugins.entries.openclaw-lark 写入 OpenClaw 配置
6. 优先调用 openclaw gateway restart

这条接入流程不再复用 ~/.openclaw-autoclaw/openclaw.json、环境变量中的 appId/appSecret，也不再使用旧的 Device Flow 作为首次接入主路径。

安装

openclaw plugins install @yrzhao/openclaw-fs-plugin

本地开发：

pnpm install
pnpm test
pnpm smoke

直接使用

openclaw feishu-connect

这条命令要求：

• 当前机器安装了 Chrome / Chromium
• 当前登录的飞书账号有飞书开放平台访问权限
• 最好具备应用创建/配置权限

注意：

• --no-open 已废弃。新的接入流程必须使用受控浏览器。
• 浏览器会使用临时用户目录启动，目的是避免直接复用之前停留在错误账号或旧应用页面上的状态。

成功后会写入什么

{
  "channels": {
    "feishu": {
      "enabled": true,
      "dmPolicy": "open",
      "allowFrom": ["*"],
      "streaming": false,
      "domain": "feishu",
      "appId": "cli_xxx",
      "appSecret": "xxx"
    }
  },
  "plugins": {
    "entries": {
      "feishu": {
        "enabled": false
      },
      "openclaw-lark": {
        "enabled": true
      }
    }
  }
}

使用中的两个阶段

首次接入：

• openclaw feishu-connect
• /feishu connect
• /feishu_connect

接入完成后补用户授权：

• /feishu auth

说明：

• feishu-connect 负责创建并接通飞书应用
• /feishu auth 负责后续用户级 OAuth 授权，不是首次接入入口

常见阻断

• 打开页面后显示“无权限 / Access denied” 说明当前账号不能访问飞书开放平台，插件会直接中止，不再继续误操作。
• 已登录但跳到旧应用页面 新实现默认使用临时浏览器目录，目标就是避免复用旧会话。
• 创建应用后仍然不可用 先执行 openclaw feishu-diagnose 或 /feishu doctor，确认机器人能力和应用权限是否已经真正生效。

文档

• 使用者接入指南：USER_GUIDE.zh-CN.md
• 技术说明：TECHNICAL.md
• 原始需求背景：feishu.md

许可

MIT