Feishu Chat

Feishu 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

1. In a Feishu group - OpenClaw connected to Feishu 2. Configure renderMode - Set to "card" for consistent formatting 3. Know member IDs: - Human: open_id (ou_xxx format) - Bot: App ID (cli_xxx format)

0. Message Format Stability

The Problem: Raw vs Card Mixing

Without proper renderMode configuration, messages can inconsistently appear as:

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:

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: "nickname Hello!"
})

Raw Mode Limitations:

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):

- Tables | table |

Supported in Card Mode:
| Style | Syntax | Status |
|-------|--------|--------|
| Bold | bold | ✅ Supported |
| Italic | *italic* | ✅ Supported |
| Strikethrough | ~~text~~ | ✅ Supported |
| Color | text | ✅ Supported |
| Links | link | ✅ Supported |
| Headings | # heading | ✅ Supported |
| Lists | - item or 1. item | ✅ Supported |
| Code blocks | 

| Style | Syntax | Status | |-------|--------|--------| | Blockquote | > quote | ❌ Not supported | | Inline code | code | ❌ Unstable | | Horizontal rule | --- | ❌ Not supported | | Complex nesting | Multiple levels | ❌ Unstable |

Best Practice for Card Mode:

1. Ask the human to @ mention the bot and send any message 2. When the message arrives, the system shows: [Feishu oc_xxx:ou_xxx timestamp] nickname: message content 3. The ou_xxx is the sender's open_id

Bot App ID (requires user to provide): 1. Go to Feishu Developer Console: https://open.feishu.cn/app 2. Click on the bot you want to view 3. In "Application Credentials" (应用凭证), copy the App ID (cli_xxx format) 4. @ mention the bot and send the App ID

Maintain Member List

Store member info in memory file:

## Group Members (oc_xxx)
Humans
nickname1: ou_xxx

nickname2: ou_xxx
AI Bots

bot1: cli_xxx (must @ to receive messages)

3. @ Mention Tips

@ Format Difference (Critical!)

| Mode | @ Format | Example | |------|----------|---------| | Raw (message tool) | nickname | kk | | Card (direct reply) | | |

@ Different Target Types

| @ Target | ID Type | Raw Format | Card Format | |----------|---------|------------|-------------| | Human | open_id (ou_xxx) | nickname | | | Bot | App ID (cli_xxx) | botname | | | Everyone | "all" | everyone | |

@ Bot vs @ Human

Important difference:

// Raw mode
message({
  action: "send",
  channel: "feishu",
  target: "oc_xxx",
  message: "botname Please reply!"
})

// Card mode
 Please reply!
Markdown content

// Raw mode
message({
  action: "send",
  channel: "feishu",
  target: "oc_xxx",
  message: "everyone Important announcement!"
})

// Card mode
 Important announcement!

Card mode errors:

4. Quick Reference

Message Decision Tree

Need to send message
    │
    ├─ Plain text only?
    │   └─ YES → message tool (Raw mode)
    │
    └─ Need Markdown?
        └─ YES → Direct reply (Card mode)

@ Mention Decision Tree

Need to @ mention
    │
    ├─ Using message tool?
    │   └─ YES → nickname
    │
    └─ Direct reply (Card mode)?
        └─ YES → 

ID Format Reference

| Type | Format | Example | |------|--------|---------| | Human open_id | ou_xxx | ou_example123abc | | Bot App ID | cli_xxx | cli_example456def | | Group chat_id | oc_xxx | oc_example789ghi |

5. Important Notes

1. Card and Raw mode use different @ formats - Wrong format = @ fails 2. Bots MUST be @ mentioned to receive messages - Humans don't need @ 3. Bot-to-bot communication is NOT possible - Bots can only receive messages from humans, not other bots 4. message tool only sends Raw mode - No Markdown rendering 5. @everyone requires group permission 6. Avoid unsupported styles in Card mode (blockquote, inline code, horizontal rule)

6. Configuration Reference

renderMode Settings

Location: OpenClaw config file or environment

Quick Setup:

# Set to card mode (recommended)
openclaw config set channels.feishu.renderMode "card"
openclaw gateway restart

Environment-specific configurations:

Development:

channels:
  feishu:
    renderMode: "raw"  # Easier debugging
    dmPolicy: "open"   # Easier testing

Production:

channels:
  feishu:
    renderMode: "card"      # Consistent formatting
    dmPolicy: "pairing"     # Security
    requireMention: true    # Avoid spam

Troubleshooting

Messages appear as raw markdown: 1. Check: openclaw config get channels.feishu.renderMode 2. Set: openclaw config set channels.feishu.renderMode "card" 3. Restart: openclaw gateway restart

Format switches between raw and card:

Proactive messages not using card:

1. In a Feishu group - OpenClaw connected to Feishu 2. Configure renderMode - Set to "card" for consistent formatting 3. Know member IDs: - Human: open_id (ou_xxx format) - Bot: App ID (cli_xxx format)

Messages appear as raw markdown: 1. Check: openclaw config get channels.feishu.renderMode 2. Set: openclaw config set channels.feishu.renderMode "card" 3. Restart: openclaw gateway restart

Format switches between raw and card:

Proactive messages not using card: