moltbot-feishu 0.2.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +37 -37
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -2,47 +2,45 @@
2
2
 
3
3
  [![npm version](https://img.shields.io/npm/v/moltbot-feishu.svg)](https://www.npmjs.com/package/moltbot-feishu)
4
4
 
5
- 让 Clawdbot/Moltbot AI 助手接入飞书，一行命令搞定。
5
+ > **🆕 2025.1.31 更新**：v0.2.0 多版本兼容，修复 Zod schema 问题，支持 Clawdbot / OpenClaw / Moltbot
6
6
 
7
- Connect your Clawdbot/Moltbot AI assistant to Feishu (Lark) with one command.
7
+ 让 AI 助手接入飞书，无需服务器。
8
+ Connect your AI assistant to Feishu (Lark) — no server required.
8
9
 
9
10
  ---
10
11
 
11
- ## 🚀 最快安装方式 / Quickest Install
12
+ ## 🚀 三种安装方式 / Three Install Methods
12
13
 
13
- **非技术用户**：直接把这段话发给你的 Clawdbot：
14
+ | 方式 | 命令 | 适合 |
15
+ |------|------|------|
16
+ | **① Clawdbot 一键安装** | 告诉你的 Clawdbot：`帮我安装飞书插件` | 新手首选，全自动 |
17
+ | **② npm 插件安装** | `clawdbot plugins install moltbot-feishu` | 开发者，一体化管理 |
18
+ | **③ 独立桥接** | [feishu-openclaw](https://github.com/AlexAnys/feishu-openclaw) | 求稳/隔离部署 |
14
19
 
15
- > 帮我安装飞书插件：https://github.com/AlexAnys/moltbot-feishu
20
+ ### 方式对比 / Comparison
16
21
 
17
- Clawdbot 会自动完成安装和配置引导。
18
-
19
- **For non-technical users**: Just send this to your Clawdbot:
20
-
21
- > Install the Feishu plugin for me: https://github.com/AlexAnys/moltbot-feishu
22
-
23
- ---
24
-
25
- ## 手动安装 / Manual Install
26
-
27
- ```bash
28
- clawdbot plugins install moltbot-feishu
29
- ```
22
+ | | 插件 (①②) | 桥接 (③) |
23
+ |---|---|---|
24
+ | 进程数 | 1 个（内置 Gateway） | 2 个（独立进程） |
25
+ | 崩溃影响 | 影响 Gateway | 互不影响 |
26
+ | 配置方式 | `clawdbot config` | 环境变量 |
27
+ | 适合场景 | 日常使用 | 生产/隔离部署 |
30
28
 
31
29
  ---
32
30
 
33
- ## 你必须做的事 / What You Must Do
31
+ ## 📋 你必须做的事 / What You Must Do
34
32
 
35
33
  ### 1. 创建飞书机器人 / Create Feishu Bot
36
34
 
37
35
  1. [飞书开放平台](https://open.feishu.cn/app) → 创建企业自建应用
38
36
  2. 添加「机器人」能力
39
- 3. **权限配置**，开启：
40
- - `im:message`（发消息）
41
- - `im:message.group_at_msg`（群聊@消息）
42
- - `im:message.p2p_msg`（私聊消息）
43
- 4. **事件订阅** → `im.message.receive_v1` → ⚠️ 选「**使用长连接接收事件**」
37
+ 3. **权限配置** — 开启：
38
+ - `im:message`
39
+ - `im:message.group_at_msg`
40
+ - `im:message.p2p_msg`
41
+ 4. **事件订阅** → `im.message.receive_v1` → ⚠️ **选「长连接」不是 webhook**
44
42
  5. 版本管理 → 创建版本 → 发布上线
45
- 6. 记下 **App ID**（`cli_xxx`）和 **App Secret**
43
+ 6. 记下 **App ID** (`cli_xxx`) 和 **App Secret**
46
44
 
47
45
  ### 2. 配置 / Configure
48
46
 
@@ -59,29 +57,29 @@ clawdbot gateway restart
59
57
 
60
58
  ---
61
59
 
62
- ## ⚠️ 常见问题 / Common Issues
60
+ ## ⚠️ 常见问题 / Troubleshooting
63
61
 
64
- ### 收不到消息？/ Not receiving messages?
62
+ ### 收不到消息？ / Not receiving messages?
65
63
 
66
64
  | 检查项 | Check |
67
65
  |--------|-------|
68
66
  | 应用已发布（不是草稿） | App is published (not draft) |
69
- | 事件订阅选的是「长连接」**不是** webhook | Event subscription uses "long connection", **not** webhook |
70
- | 权限都已开启 | All permissions are enabled |
67
+ | 事件订阅用「长连接」 | Event uses "long connection" |
68
+ | 权限都已开启 | All permissions enabled |
71
69
 
72
- ### 配置报错 `not configured`？
70
+ ### 报错 `not configured`？
73
71
 
74
- ⚠️ **必须用 `appSecret`，不是 `appSecretPath`**
72
+ **必须用 `appSecret`，不是 `appSecretPath`**：
75
73
 
76
74
  ```bash
77
75
  # ✅ 正确
78
76
  clawdbot config set channels.feishu.appSecret "你的secret"
79
77
 
80
- # ❌ 错误 — 插件不支持从文件读取
78
+ # ❌ 错误 — 插件不支持
81
79
  clawdbot config set channels.feishu.appSecretPath "/path/to/file"
82
80
  ```
83
81
 
84
- ### 群聊不回复？/ Bot not responding in groups?
82
+ ### 群聊不回复？ / No response in groups?
85
83
 
86
84
  @机器人，或消息末尾加问号。
87
85
 
@@ -89,7 +87,7 @@ clawdbot config set channels.feishu.appSecretPath "/path/to/file"
89
87
 
90
88
  ## 特点 / Features
91
89
 
92
- - **无需服务器** — WebSocket 长连接，本地运行
90
+ - **无需服务器** — WebSocket 长连接
93
91
  - **私聊+群聊** — 都支持
94
92
  - **图片文件** — 收发都行
95
93
  - **多账号** — 可同时接多个机器人
@@ -98,9 +96,11 @@ clawdbot config set channels.feishu.appSecretPath "/path/to/file"
98
96
 
99
97
  ## 链接 / Links
100
98
 
101
- - [Clawdbot 文档](https://docs.clawd.bot)
102
- - [飞书开放平台](https://open.feishu.cn/document/home/index)
103
- - [问题反馈 / Issues](https://github.com/AlexAnys/moltbot-feishu/issues)
99
+ - 📦 [npm: moltbot-feishu](https://www.npmjs.com/package/moltbot-feishu)
100
+ - 🔌 [GitHub: moltbot-feishu](https://github.com/AlexAnys/openclaw-feishu) (插件)
101
+ - 🌉 [GitHub: feishu-openclaw](https://github.com/AlexAnys/feishu-openclaw) (桥接)
102
+ - 📖 [Clawdbot 文档](https://docs.clawd.bot)
103
+ - 🐛 [问题反馈](https://github.com/AlexAnys/openclaw-feishu/issues)
104
104
 
105
105
  ## License
106
106
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "moltbot-feishu",
3
- "version": "0.2.0",
3
+ "version": "0.2.1",
4
4
  "type": "module",
5
5
  "description": "飞书机器人插件 - 让 AI 助手接入飞书，无需服务器 | Feishu/Lark channel plugin for Moltbot",
6
6
  "author": "Alex Yang <anyangsen@hotmail.com>",