Feishu Post
Scanned@autogame-17
npx machina-cli add skill @autogame-17/feishu-post --openclawFeishu Post (RichText) Skill
Send Rich Text (Post) messages to Feishu. This format is distinct from Cards. It supports native rich text elements but is less flexible in layout than cards. It is better for long-form text mixed with images/links.
Prerequisites
- Install
feishu-commonfirst. - This skill depends on
../feishu-common/index.jsviautils/feishu-client.js.
Features
- Native Emoji Support: Automatically converts
[微笑],[得意]etc. to Feishu native emoji tags. - Markdown-like Parsing: Supports simple newlines and paragraphs.
- Rich Text: Uses Feishu's Post content structure.
Usage
node skills/feishu-post/send.js --target "ou_..." --text-file "temp/msg.md" --title "Optional Title"
Options
-t, --target <id>: Target ID (userou_...or chatoc_...).-x, --text <text>: Text content (supports\nfor newlines and[emoji]tags).-f, --text-file <path>: Read content from file.--title <text>: Title of the post.--reply-to <id>: Message ID to reply to.
Emoji List
Supported emojis include: [微笑], [色], [亲亲], [大哭], [强], [加油], and many more.
See emoji-map.js for the full mapping.
Overview
Feishu Post (RichText) sends long-form messages using Feishu's Post content structure. It supports native emoji conversion and simple markdown-like formatting, making it ideal for text that combines images and links. Prerequisites include installing feishu-common and leveraging the shared Feishu client to publish to users or chats.
How This Skill Works
Text can be supplied via --text or --text-file, and emoji codes like [微笑] are mapped to Feishu native emojis. The skill builds a Feishu Post object using the Post content structure and sends it to a target ID (ou_... for users or oc_... for chats) through the feishu-client. A title can be provided with --title for long-form posts.
When to Use It
- Announce a long-form update to a team chat
- Share product release notes with images and links
- Post HR policies or handbook updates to a department
- Publish a weekly digest with embedded media
- Distribute knowledge base articles or FAQs to a support chat
Quick Start
- Step 1: Install feishu-common and ensure the Feishu client is accessible via utils/feishu-client.js
- Step 2: Create your message using --text or --text-file and optionally --title
- Step 3: Run the command to publish, e.g.: node skills/feishu-post/send.js --target ou_... --text-file temp/msg.md --title Optional Title
Best Practices
- Use -f/--text-file for long-form posts to keep formatting intact
- Include emoji with [tag] syntax to leverage Feishu native emojis
- Keep content focused and paragraphs clear; avoid complex layouts
- Add a concise --title when posting to channels that need context
- Validate the target ID (ou_ for users, oc_ for chats) before posting
Example Use Cases
- Post a weekly team update to the #team-chat with a summary and links
- Share a product release note with a banner image and links to docs
- Publish updated HR policies to the Engineering channel
- Distribute a knowledge base article to the Support chat
- Announce an upcoming maintenance window with steps and contacts
