feishu-all-in-one

What This Skill Does

The feishu-all-in-one skill is a comprehensive communication powerhouse for OpenClaw users, designed to transform your agent into a professional FeiShu (Lark) bot. It enables your AI to seamlessly interact with users within the FeiShu ecosystem, supporting everything from simple text responses to complex, interactive business workflows. With native support for message dispatching, media transmission, and advanced interactivity, this skill removes the friction of building custom integrations. Whether you need to send automated report notifications, receive user-uploaded documents for analysis, or deploy interactive workflow cards that capture user intent via buttons, this skill handles the heavy lifting through a unified, well-documented interface.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/arvenwang/feishu-all-in-one. After installation, navigate to your OpenClaw configuration directory (~/.openclaw/openclaw.json) to add the feishu channel. Ensure you have obtained your App ID and App Secret from the FeiShu Developer Console, and configure the necessary permissions including im:message:send_as_bot and im:message:receive. For production environments, remember to set your credentials via system environment variables to maintain security.

Use Cases

• Automated Alerts: Send real-time notifications or alerts to specific users or groups based on internal AI logic or event triggers.
• Interactive Workflow Management: Deploy custom interactive cards to gather input, conduct polls, or manage approvals directly within a chat window.
• Content Processing: Enable the bot to receive images or documents from users, process them using other AI skills, and send results back instantly.
• Voice-to-Text Transcription: Automatically transcribe incoming voice notes using the integrated faster-whisper engine, allowing the agent to handle audio-based requests efficiently.

Example Prompts

1. "Send a confirmation card to user ou_123456 asking if they approve the latest deployment report."
2. "Please transcribe the audio file received in the last message and summarize the key action items for the team."
3. "Upload the generated project report PDF to the FeiShu chat with group ID oc_987654 and notify the team that the analysis is complete."

Tips & Limitations

To ensure optimal performance, verify that your FeiShu application has been published or authorized for your specific organization. The skill utilizes 'long-link' mode for event reception, which simplifies setup by removing the need for an exposed public web server; however, ensure your local environment maintains a stable connection to the OpenClaw service to prevent message loss. For interactive cards, utilize the provided send-card.js utility, which abstracts complex JSON card structures into simple command-line arguments. Always keep your App Secret secure and never hardcode it in scripts shared in public repositories. Note that high-volume message throughput may be subject to FeiShu's API rate limits; implement appropriate error handling in your AI flows to manage potential retries gracefully.