mirror of
https://github.com/NanmiCoder/cc-haha
synced 2026-08-01 16:43:37 +08:00
73 lines
2.2 KiB
Markdown
73 lines
2.2 KiB
Markdown
# Feishu Integration
|
|
|
|
The Feishu adapter connects an enterprise custom app to local Desktop sessions. It handles `p2p` private chats only; group chats are not supported.
|
|
|
|
## Create the Feishu app
|
|
|
|
Feishu provides a template with the messaging, event, and card capabilities needed by this integration:
|
|
|
|
[Create a Feishu bot from the template](https://open.feishu.cn/page/openclaw?form=multiAgent)
|
|
|
|
Choose a name, create the app, and save its **App ID** and **App Secret**.
|
|
|
|
In the [Feishu developer console](https://open.feishu.cn/app?lang=en-US), create and publish a bot version. Optional menu entries can invoke:
|
|
|
|
- `/projects`
|
|
- `/new`
|
|
- `/clear`
|
|
|
|
The app must be published before users can reliably receive the configured bot behavior.
|
|
|
|
## Configure Desktop
|
|
|
|
Open **Settings → IM Integration → Feishu**:
|
|
|
|
1. Enter the App ID and App Secret.
|
|
2. Generate a six-character pairing code.
|
|
3. Save the configuration.
|
|
4. Send a private message to the bot and provide the code.
|
|
|
|
Pairing codes expire after 60 minutes, work once, and are rate limited after repeated failures. App credentials do not authorize every organization user.
|
|
|
|
## Commands
|
|
|
|
- `/help` or `帮助`
|
|
- `/status` or `状态`
|
|
- `/clear` or `清空`
|
|
- `/projects` or `项目列表`
|
|
- `/new` or `新会话`
|
|
- `/stop` or `停止`
|
|
|
|
## Permission approval
|
|
|
|
Permission requests are sent as interactive cards. Selecting allow or deny returns the result to the pending Desktop session.
|
|
|
|
If card actions do not work, confirm that the latest application version is published and includes the required card-action capability.
|
|
|
|
## Reply behavior
|
|
|
|
- Normal text uses Feishu post messages.
|
|
- Permission approval uses cards.
|
|
- Streaming output prefers patching the same message.
|
|
- Long completed content is split to respect platform limits.
|
|
|
|
## Development
|
|
|
|
Packaged Desktop starts the sidecar automatically. For source development:
|
|
|
|
```bash
|
|
cd adapters
|
|
bun install
|
|
bun run feishu
|
|
```
|
|
|
|
Optional overrides:
|
|
|
|
```bash
|
|
export FEISHU_APP_ID="cli_xxx"
|
|
export FEISHU_APP_SECRET="xxx"
|
|
export ADAPTER_SERVER_URL="ws://127.0.0.1:3456"
|
|
```
|
|
|
|
If messages are missing, confirm that the app is published, the conversation is a private chat, and the sender is paired or explicitly allowlisted.
|