titor/mimiclaw
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Docs: fix feishu md subscription mode description

Browse Source
This commit is contained in:
wjc1207
2026-03-14 23:13:27 +08:00
parent 974ec7f974
commit 07ca630b69
1 changed files with 9 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
main/channels/feishu/README.md
View File

@@ -5,7 +5,7 @@ This directory contains the Feishu bot integration for MimiClaw.
## Features ## Features
- Send text messages to Feishu chats - Send text messages to Feishu chats
- Receive messages via webhook (HTTP event subscription) - Receive messages via WebSocket persistent connection (long-connection mode)
- Automatic message chunking (4096 chars per message) - Automatic message chunking (4096 chars per message)
- Tenant access token management with auto-refresh - Tenant access token management with auto-refresh
- Message deduplication - Message deduplication
@@ -46,17 +46,17 @@ mimi> set_feishu_creds cli_xxxxxxxxxxxxxx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
- `im:message` - Send and receive messages - `im:message` - Send and receive messages
- `im:message:send_as_bot` - Send messages as bot - `im:message:send_as_bot` - Send messages as bot
4. Configure Event Subscription: 4. Configure Event Subscription:
- Request URL: `http://<ESP32_IP>:18790/feishu/events` - Set subscription mode to **Persistent connection** (长连接)
- Subscribe to: `im.message.receive_v1` - Subscribe to: `im.message.receive_v1`
5. The ESP32 will auto-respond to the URL verification challenge 5. The ESP32 will connect to Feishu automatically on boot
## Architecture ## Architecture
``` ```
Feishu Server Feishu Server (wss://open.feishu.cn)
| ^
v (HTTP POST /feishu/events) | (WebSocket persistent connection, ESP32 initiates)
[ESP32 Webhook Server :18790] [feishu_ws_task]
| |
v (message_bus_push_inbound) v (message_bus_push_inbound)
[Message Bus] --> [Agent Loop] --> [Message Bus] [Message Bus] --> [Agent Loop] --> [Message Bus]
@@ -73,7 +73,7 @@ Feishu API
| Function | Description | | Function | Description |
|----------|-------------| |----------|-------------|
| `feishu_bot_init()` | Load credentials from NVS/build-time | | `feishu_bot_init()` | Load credentials from NVS/build-time |
| `feishu_bot_start()` | Start webhook HTTP server | | `feishu_bot_start()` | Start WebSocket persistent connection task |
| `feishu_send_message(chat_id, text)` | Send text message | | `feishu_send_message(chat_id, text)` | Send text message |
| `feishu_reply_message(message_id, text)` | Reply to a specific message | | `feishu_reply_message(message_id, text)` | Reply to a specific message |
| `feishu_set_credentials(app_id, secret)` | Save credentials to NVS | | `feishu_set_credentials(app_id, secret)` | Save credentials to NVS |
@@ -82,4 +82,4 @@ Feishu API
- [Feishu Open Platform Docs](https://open.feishu.cn/document/home/index) - [Feishu Open Platform Docs](https://open.feishu.cn/document/home/index)
- [Message API](https://open.feishu.cn/document/server-docs/im-v1/message/create) - [Message API](https://open.feishu.cn/document/server-docs/im-v1/message/create)
- [Event Subscription](https://open.feishu.cn/document/server-docs/event-subscription/event-subscription-guide) - [Long-connection Event Subscription](https://open.feishu.cn/document/server-docs/event-subscription/long-connection)