A comprehensive framework for deploying an autonomous AI companion on Feishu featuring long-term memory, voice messaging, and image generation.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install clawgirl
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 clawgirl 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 AI Companion Agent for Feishu?
This skill provides a complete blueprint for creating a sophisticated AI companion within the Openclaw Skills ecosystem. By leveraging the Openclaw multi-agent framework, developers can craft agents that possess a unique soul (personality), a rhythmic heartbeat (automated behaviors), and the ability to interact via text, high-quality voice messages, and realistic selfies.
The framework is specifically designed to overcome common limitations in automated messaging, such as session isolation and media format requirements, providing a battle-tested architecture for persistent AI personas. Using this approach within Openclaw Skills ensures that your agent remains context-aware and human-like in its interactions.
AI Companion Agent for Feishu Use Cases
- Creating branded AI mascots for team engagement in Feishu/Lark.
- Developing personal AI assistants with long-term memory of user preferences and past interactions.
- Building autonomous social agents that share content, voice notes, and generated selfies periodically.
- Implementing proactive notification systems that use natural, persona-driven language rather than robotic alerts.
How AI Companion Agent for Feishu Works
- A configured cron job triggers the agent heartbeat at regular intervals.
- The agent initializes by reading its personality definition from SOUL.md and its behavioral logic from HEARTBEAT.md.
- The agent retrieves historical context from a date-based memory system located in the workspace directory.
- Based on current time, historical context, and persona constraints, the agent decides on an action (e.g., sending a greeting, sharing a link, or generating a voice note).
- The agent writes its planned action to memory to maintain state.
- Finally, the agent executes specialized bash scripts (send.sh, voice.sh, or selfie.sh) to deliver the message to the Feishu platform via direct API calls.
AI Companion Agent for Feishu Setup
To deploy this companion within your Openclaw Skills environment, follow these steps:
- Install system dependencies:
brew install ffmpeg jq
pip install edge-tts fal-client
- Configure your
openclaw.jsonwith the necessary environment variables:FAL_KEY: For image and high-quality TTS generation.FEISHU_APP_ID&FEISHU_APP_SECRET: For messaging API access.
- Initialize the workspace structure with
SOUL.md,HEARTBEAT.md, and thememory/directory. - Register the agent and add the heartbeat cron job:
openclaw cron add --name "companion-heartbeat" --every 15m --session isolated --message "Follow HEARTBEAT.md logic and send messages via send.sh" {agent_id}
AI Companion Agent for Feishu Data Schema & Taxonomy
The skill organizes its internal logic and state using the following file structure within the agent workspace:
| File/Folder | Purpose |
|---|---|
SOUL.md |
Defines identity, persona, linguistic style, and anti-AI constraints. |
HEARTBEAT.md |
Maps specific times and contexts to agent behaviors and actions. |
TOOLS.md |
Technical documentation for the agent to understand how to use bash scripts. |
memory/ |
Directory containing YYYY-MM-DD.md logs for long-term context retention. |
scripts/ |
Contains send.sh, voice.sh, and selfie.sh for platform interaction. |
AI Companion Agent for Feishu Advanced Features
- Direct Feishu API Integration: Bypasses standard messaging limitations to send native opus-encoded audio messages.
- Multimodal Persona: Integrates MiniMax Speech-02-HD and Grok Imagine for realistic voice and visual identity.
- Isolated Session Management: Uses isolated cron sessions to ensure background autonomous behavior does not interfere with active user sessions.
- Seed Memory Injection: Allows developers to bootstrap an agent's relationship with a user by pre-populating historical context.
- Prompt-Based Output Enforcement: Includes specific instructions to force agents to display bash output, preventing simulated tool execution.
SKILL.md
Loading
Related Openclaw Skills
AI Companion Agent Setup
A comprehensive framework for deploying lifelike AI agents with personality, persistent memory, and multi-modal communication capabilities.
Agent Batch Guard
A comprehensive framework and configuration guide designed to prevent AI agents from freezing during large-scale batch operations by managing session transcript bloat.
OpenClaw Workspace Pro
A production-grade workspace enhancement for OpenClaw agents that implements enterprise-level artifact management, security protocols, and memory optimization.
Leak Migration Stub
A compatibility layer designed to transition users from legacy monolithic leak skills to hardened, specialized Openclaw Skills.
Feishu App Setup Automation
An automated browser-based skill designed to handle the entire lifecycle of Feishu open platform application configuration for AI agents.
Feishu Multi-Agent Orchestration
A production-grade blueprint for orchestrating a team of AI agents through Feishu using a foreman-worker model and file-driven task queues.
Featured*
