Feishu Chat

Feishu Group Chat 图形界面de Quick 启动: 配置 renderMode

⚠️ 导入ANT: 设置 renderMode explicitly for stable message 格式化ting

# Recommended configuration channels: feishu: renderMode: "card" # Always use card 格式化

Why? The default "auto" mode causes unpredictable 格式化 switching (raw vs card), creating poor user experience.

Configuration:

OpenClaw config 设置 channels.feishu.renderMode "card" OpenClaw gateway re启动

验证:

OpenClaw config 获取 channels.feishu.renderMode

Prerequisites In a Feishu group - OpenClaw connected to Feishu 配置 renderMode - 设置 to "card" for consistent 格式化ting Know member IDs: Human: open_id (ou_xxx 格式化) 机器人: 应用 ID (命令行工具_xxx 格式化)

• Message 格式化 Stability

The Problem: Raw vs Card Mixing

Without proper renderMode configuration, messages can inconsistently 应用ear as:

Raw text: PlAIn markdown source, no 格式化ting Card 格式化: Rendered markdown with syntax highlighting, tables, links The Solution: Explicit renderMode Mode Behavior Use Case auto 检测s content, uses card for code/tables ❌ Avoid - unpredictable raw Always plAIn text Simple text-only 响应s card Always interactive card ✅ Recommended - consistent

Recommended: renderMode: "card" for all production use.

• Message 发送ing

⚠️ CRITICAL: Only Use ONE Method

DO NOT use 机器人h direct reply and message 工具 for the same content! This will 发送 two messages.

Choose ONE:

PlAIn text → message 工具 only Markdown → direct reply only Two Methods Method 工具 Render Mode Use Case message 工具 message Raw (plAIn text) PlAIn text, @ mentions Direct reply 会话 reply Card (with Markdown) Markdown 格式化ted messages Raw Mode (PlAIn Text)

When to use: PlAIn text messages, @ mentions

How to 发送:

message({ action: "发送", channel: "feishu", tar获取: "oc_xxx", message: "PlAIn text content" })

@ Mention 格式化:

message({ action: "发送", channel: "feishu", tar获取: "oc_xxx", message: "nickname 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: 格式化ted messages with code blocks, tables, bold/italic text

How to 发送: Direct reply in 会话 with Markdown elements.

Card Mode Triggers (any of these):

Code blocks Tables | table | Bold bold Italic italic Strikethrough ~~text~~ Links link Headings # heading 列出s - item or 1. item

@ Mention 格式化:

This is Card mode @ mention

Markdown content renders correctly

Supported in Card Mode:

Style Syntax 状态 Bold bold ✅ Supported Italic italic ✅ Supported Strikethrough ~~text~~ ✅ Supported Color text ✅ Supported Links link ✅ Supported Headings # heading ✅ Supported 列出s - item or 1. item ✅ Supported Code blocks code ✅ Supported Tables table

Not Supported in Card Mode:

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

Best Practice for Card Mode:

Use bold for emphasis Use italic for light emphasis Use numbered 列出s 1. or bullet 列出s - Avoid ---, >, and inline code Keep 格式化ting simple Avoid Auto Mode

Problem: Auto mode can incorrectly choose between Raw and Card.

Best Practice:

PlAIn text → Use message 工具 (Raw mode) Markdown content → Direct reply (Card mode)

Don't:

Use message 工具 for Markdown (won't render) Use complex structures in Card mode (may trigger Raw incorrectly)

• Group Member Management

⚠️ 导入ant: 机器人s Only See @ Mentioned Messages

机器人s can only see messages that @ mention them! If a group member 发送s a message without @ mentioning the 机器人, the 机器人 won't 接收 it.

This means:

To identify a human member's open_id, they must @ mention the 机器人 and 发送 a message The 机器人 cannot see past messages where it wasn't mentioned How to 获取 Member IDs

Human open_id (must @ mention 机器人):

Ask the human to @ mention the 机器人 and 发送 any message When the message arrives, the 系统 shows: [Feishu oc_xxx:ou_xxx timestamp] nickname: message content The ou_xxx is the 发送er's open_id

机器人 应用 ID (requires user to provide):

Go to Feishu Developer Console: https://open.feishu.cn/应用 命令行工具ck on the 机器人 you want to view In "应用 凭证s" (应用凭证), copy the 应用 ID (命令行工具_xxx 格式化) @ mention the 机器人 and 发送 the 应用 ID MAIntAIn Member 列出

Store member 信息 in memory file:

Group Members (oc_xxx)

Humans

• nickname1: ou_xxx
• nickname2: ou_xxx

AI 机器人s

• 机器人1: 命令行工具_xxx` (must @ to 接收 messages)

• @ Mention Tips

@ 格式化 Difference (Critical!) Mode @ 格式化 Example Raw (message 工具) nickname kk Card (direct reply) @ Different Tar获取 Types @ Tar获取 ID Type Raw 格式化 Card 格式化 Human open_id (ou_xxx) n