A specialized tool that enables AI agents to bypass passive reply limitations and proactively send text messages via the Feishu OpenAPI.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install feishu-proactive-messenger
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install feishu-proactive-messenger using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Feishu Proactive Messenger?
The Feishu Proactive Messenger is a technical bridge designed to solve the one-way communication limitation inherent in many bot platforms. In standard configurations, Feishu agents are restricted to passive replies, meaning a human must speak first. This skill, as part of the wider library of Openclaw Skills, unlocks the ability for agents to initiate outbound communication, making it indispensable for complex workflows where an agent needs to report progress or hand off tasks independently.
By directly interfacing with the Feishu OpenAPI, this skill provides a robust mechanism for delivering text messages. It is designed to work across multiple agents, automatically resolving credentials and target recipients from localized configuration files. This ensures that your automated processes remain fluid and can engage users or other bots at any time, rather than waiting for a user trigger.
Feishu Proactive Messenger Use Cases
- Dispatching automated notifications from one agent to another in multi-agent environments.
- Sending "Mission Accomplished" or status update alerts to specific users without a prior prompt.
- Initiating proactive customer support or internal reminders based on scheduled triggers.
- Filling the messaging gap in workflows where agents operate autonomously in the background.
How Feishu Proactive Messenger Works
- The skill identifies the target agent ID through the --agent parameter or by analyzing the current working directory.
- It securely accesses the appId and appSecret from the local openclaw.json configuration.
- The script determines the recipient by checking the provided arguments, environment variables, or the defaultTo setting.
- It communicates with Feishu to obtain a valid tenant access token for authorized API access.
- The bot's identity is verified and retrieved via the Feishu bot/v3/info endpoint.
- The text content is transmitted to the recipient using the Feishu Send Message (im/v1/messages) API.
- A clean success message is returned to the terminal, confirming the bot has successfully sent the message.
Feishu Proactive Messenger Setup
To integrate this into your existing Openclaw Skills setup, first configure your target recipient for the specific Feishu account:
openclaw config set channels.feishu.accounts.<account>.defaultTo "user:ou_xxx"
Once configured, you can trigger a proactive message using the following command:
python3 scripts/feishu_proactive_messenger.py --agent <agent_id> --text "Hello from the agent!"
Feishu Proactive Messenger Data Schema & Taxonomy
The skill utilizes the standard configuration hierarchy found in Openclaw Skills. Key data points include:
| Attribute | Description |
|---|---|
| appId | The unique application identifier provided by the Feishu Developer Console. |
| appSecret | The secure credential used to generate access tokens. |
| defaultTo | A string identifying the default recipient (e.g., user:ou_xxx or chat:oc_xxx). |
| receive-id-type | Specifies the ID format: chat_id, open_id, or user_id. |
Feishu Proactive Messenger Advanced Features
- Context-aware agent resolution that falls back to workspace defaults if no ID is specified.
- Multi-ID support with intelligent auto-detection based on prefix (oc_, ou_, or on_).
- Seamless integration with environment variables like OPENCLAW_CHAT_ID for dynamic routing in CI/CD pipelines.
- High-security architecture that reads credentials locally and never transmits them to external third-party servers.
- Full compatibility with other Openclaw Skills such as the file sender for comprehensive outbound capabilities.
SKILL.md
Loading
Related Openclaw Skills
Feishu File Sender
A specialized tool that enables AI agents to upload and send local files directly to Feishu chats using the Feishu OpenAPI.
NEWMAN_SUPREME: Strategic Leadership Skill
A high-IQ strategic leadership engine designed for moral guidance, logical dominance, and Moltbook social integration.
Zapper API
A comprehensive CLI tool for querying multi-chain DeFi portfolios, NFT valuations, and transaction histories via the Zapper GraphQL API.
Zapper API
A powerful tool for querying DeFi portfolios, NFT holdings, and cross-chain transactions through the Zapper GraphQL API.
Chirp (X/Twitter Browser Automation)
A browser-based automation tool that allows AI agents to perform full X/Twitter interactions through the Openclaw browser environment.
Korean Claw
A specialized Korean-language community platform and service marketplace designed specifically for autonomous AI agents to interact, share, and collaborate.
Featured*
