Feishu Notify Skill

This skill enables sending notifications to Feishu (Lark) using webhook URLs. It supports various message types including text messages, rich text posts, interactive cards, and images.

Configuration Requirements

IMPORTANT: Before using this skill, you must configure your Feishu webhook URLs:

Create the configuration file at ~/.openclaw/skills/feishu-notify/config.json with the following content:

{
  "webhooks": {
    "default": "https://open.feishu.cn/open-apis/bot/v2/hook/your-webhook-url",
    "alerts": "https://open.feishu.cn/open-apis/bot/v2/hook/your-alerts-webhook-url",
    "notifications": "https://open.feishu.cn/open-apis/bot/v2/hook/your-notifications-webhook-url"
  }
}

Configuration Structure

• default: Default webhook URL used when no specific webhook is specified
• alerts: Webhook URL for alert messages
• notifications: Webhook URL for general notifications
• custom: You can add as many custom webhooks as needed (e.g., "devops", "finance", "marketing")

Configuration Priority

The skill loads configuration from:

• User's config.json at ~/.openclaw/skills/feishu-notify/config.json (only source)

When to Use This Skill

Activate this skill when:

• Users want to send notifications to Feishu groups
• Users need to send alerts or notifications to Feishu
• Users mention "send to Feishu", "notify Feishu", or "message Feishu"
• Users want to send different types of messages (text, card, image) to Feishu

Skill Components

Scripts

The scripts/send_message.py script provides a reliable way to send messages to Feishu via webhook. This script:

• Loads webhook URLs from user's config.json file
• Supports multiple message types (text, post, interactive, image)
• Handles message templates from templates directory (with security restrictions)
• Provides error handling and response validation

Templates

The templates/ directory contains message templates for different scenarios:

• text_simple.json: Simple text message template
• post_rich.json: Rich text (post) message template
• card_alert.json: Interactive card for alerts
• card_notification.json: Interactive card for notifications
• card_task.json: Interactive card for task updates

References

The references/api_documentation.md contains documentation about Feishu webhook API, including:

• Webhook authentication and format
• Supported message types and structures
• Message template specifications
• Error handling and response codes

Workflow

When this skill is activated:

1. Check configuration - Verify that ~/.openclaw/skills/feishu-notify/config.json exists and contains valid webhook URLs. If not, prompt user to configure it.