feishu-chat
Feishu (Lark) group chat messaging guide for OpenClaw. Includes Raw/Card message modes, @ mention formatting, and group member management. Use when sending messages in Feishu groups, mentioning users/bots, or formatting messages with Markdown.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/heimo-he/feishu-chatFeishu Group Chat Guide
Quick Start: Configure renderMode
⚠️ IMPORTANT: Set renderMode explicitly for stable message formatting
# Recommended configuration
channels:
feishu:
renderMode: "card" # Always use card format
Why? The default "auto" mode causes unpredictable format switching (raw vs card), creating poor user experience.
Configuration:
openclaw config set channels.feishu.renderMode "card"
openclaw gateway restart
Verify:
openclaw config get channels.feishu.renderMode
Prerequisites
- In a Feishu group - OpenClaw connected to Feishu
- Configure renderMode - Set to "card" for consistent formatting
- Know member IDs:
- Human:
open_id(ou_xxx format) - Bot:
App ID(cli_xxx format)
- Human:
0. Message Format Stability
The Problem: Raw vs Card Mixing
Without proper renderMode configuration, messages can inconsistently appear as:
- Raw text: Plain markdown source, no formatting
- Card format: Rendered markdown with syntax highlighting, tables, links
The Solution: Explicit renderMode
| Mode | Behavior | Use Case |
|---|---|---|
auto | Detects content, uses card for code/tables | ❌ Avoid - unpredictable |
raw | Always plain text | Simple text-only responses |
card | Always interactive card | ✅ Recommended - consistent |
Recommended: renderMode: "card" for all production use.
1. Message Sending
⚠️ CRITICAL: Only Use ONE Method
DO NOT use both direct reply and message tool for the same content! This will send two messages.
Choose ONE:
- Plain text → message tool only
- Markdown → direct reply only
Two Methods
| Method | Tool | Render Mode | Use Case |
|---|---|---|---|
| message tool | message | Raw (plain text) | Plain text, @ mentions |
| Direct reply | Session reply | Card (with Markdown) | Markdown formatted messages |
Raw Mode (Plain Text)
When to use: Plain text messages, @ mentions
How to send:
message({
action: "send",
channel: "feishu",
target: "oc_xxx",
message: "Plain text content"
})
@ Mention format:
message({
action: "send",
channel: "feishu",
target: "oc_xxx",
message: "<at user_id=\"ou_xxx\">nickname</at> Hello!"
})
Raw Mode Limitations:
- ❌ No Markdown rendering (bold, italic, code blocks won't render)
- ❌ Tables won't render
- ❌ Links won't render
- ✅ @ mentions work correctly
Card Mode (Markdown)
When to use: Formatted messages with code blocks, tables, bold/italic text
How to send: Direct reply in session with Markdown elements.
Card Mode Triggers (any of these):
- Code blocks
- Tables
| table | - Bold
**bold** - Italic
*italic* - Strikethrough
~~text~~ - Links
[link](url) - Headings
# heading - Lists
- itemor1. item
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-heimo-he-feishu-chat": {
"enabled": true,
"auto_update": true
}
}
}