Feishu Openclaw Onboarding

README

# feishu-openclaw-onboarding

一个给 OpenClaw 用的**飞书官方插件入口 skill**。

它不是飞书能力大全，而是一个更符合真实交互体验的**安装 / 升级 / 迁移 / 授权 / 验证 / 排障总入口**：

- 用户说“帮我装飞书官方插件”
- 用户说“把旧飞书插件升级成 openclaw-lark”
- 用户说“/feishu auth 怎么用”
- 用户说“以前能用，现在飞书插件不行了”
- 用户说“学一下我装的新飞书插件有哪些能力”

这类请求都应优先走本 skill。

## 为什么要单独做这个 skill

如果没有这个入口 skill，agent 很容易出现两个问题：

1. 把“飞书插件迁移”误做成“飞书能力大全”
2. 一上来就给大段文档，不符合真实对话式安装体验

这个 skill 的目标是：
- 先判断用户处于哪个阶段
- 用最少的问题把链路跑通
- 把用户从旧链路平滑切到 `@larksuite/openclaw-lark`
- 完成后再把具体业务动作路由到专项 skill

## 解决的问题

本 skill 负责：
- 从零安装飞书官方插件
- 从旧版链路迁移到 `@larksuite/openclaw-lark`
- 指导 `/feishu auth`、`/feishu start`、`/feishu doctor`
- 处理常见权限、卡片回调、配置与兼容问题
- 安装完成后，把用户路由到文档 / IM / Bitable / Calendar / Task 等专项 skill

## 不负责的事

本 skill 不负责长期承接下面这些具体业务操作：
- 读写飞书文档
- 查聊天记录
- 管理多维表格
- 建日程
- 建任务

这些能力由插件自带的专项 skill 继续处理。

## 目录结构

```text
feishu-openclaw-onboarding/
├── SKILL.md
├── README.md
├── .gitignore
├── evals/
│   └── evals.json
└── references/
    ├── migration-map.md
    ├── feature-routing.md
    └── source-notes.md
```

## 典型交互体验

### 场景 1：从零安装
用户：
> 帮我装飞书官方插件

期望行为：
- 先检查 OpenClaw / Node 版本
- 再给安装命令
- 再引导 `/feishu auth` → `/feishu start` → `/feishu doctor`
- 不先灌一大段高级配置

### 场景 2：旧版迁移
用户：
> 以前那个飞书官方插件能用，现在我想切到 openclaw-lark

期望行为：
- 先识别为“旧版迁移”
- 明确新推荐链路是 `@larksuite/openclaw-lark`
- 收束到：版本 → 安装 → 授权 → 验证
- 不继续默认推荐旧 `feishu-plugin-onboard` 链路

### 场景 3：排障
用户：
> 飞书插件以前好好的，现在突然不行了

期望行为：
- 先判断是权限 / 配置 / 回调 / 版本问题
- 默认让用户先跑 `/feishu doctor`
- 不先靠猜

## 当前依据

当前主要基于：
- 本地《飞书官方插件.md》笔记
- 当前可用的 `@larksuite/openclaw-lark` README
- 旧版 `feishu-openclaw-plugin` 资料备份
- 新版自带专项 skill 的能力划分

## 发布建议

如果发布到 Gitee / GitHub，建议仓库名与 skill 名一致：

```text
feishu-openclaw-onboarding
```

## License

MIT