A specialized skill for managing the lifecycle of AI agent participation in multi-user group conversations across various messaging platforms.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install chat-group-behavior
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 chat-group-behavior 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 Chat Group Behavior?
The Chat Group Behavior skill provides a standardized framework for AI agents to join, engage with, and exit group chats on platforms like WhatsApp, Telegram, and Signal. It ensures agents behave like polite human participants rather than spamming bots by managing active listening windows and response filters through the Openclaw Skills framework.
By utilizing this skill, developers can implement secure gates that prevent agents from responding to every message unless explicitly invited or when a session is active. It relies on hot-reloading configurations to change agent visibility and accessibility in real-time without requiring system restarts, making it a robust addition to any collection of Openclaw Skills.
Chat Group Behavior Use Cases
- Adding an AI agent to a WhatsApp project group for a specific brainstorming duration.
- Allowing an agent to provide research support in a Signal group when tagged by the owner.
- Automating the exit of an agent from a Telegram group after a predefined period using cron jobs.
- Managing granular sender permissions to ensure the agent processes messages from all group members while active.
How Chat Group Behavior Works
- Context Capture: The agent identifies the platform, group ID, and requested duration from an owner's mention.
- Configuration Patching: The skill updates the openclaw.json file to set requireMention to false for the specific group, effectively opening the gate.
- Sender Filter Adjustment: The groupAllowFrom setting is updated to allow all group members' messages to reach the agent.
- Engagement and Signaling: The agent acknowledges requests immediately before performing complex tasks to maintain a human-like presence.
- Lifecycle Management: A one-shot cron job is scheduled to revert settings and close the communication window automatically.
- Clean Exit: Upon duration expiry, the agent sends a farewell and restores original mention requirements.
Chat Group Behavior Setup
Ensure your messaging channels are configured in openclaw.json. Trigger the skill by mentioning the agent in a group chat. To manually verify the configuration within the Openclaw Skills environment, use the following command:
openclaw doctor
The system will validate your configuration against the schema. No restart is needed as the gateway supports hot-reloading.
Chat Group Behavior Data Schema & Taxonomy
| Key | Description | Default/Value |
|---|---|---|
channels.<platform>.groups.<group_id>.requireMention |
Boolean flag to toggle active listening in groups. | true (locked) / false (active) |
channels.<platform>.groupAllowFrom |
List of allowed sender IDs; use ["*"] to enable full group participation. |
["owner_id"] |
agents.list[main].groupChat.mentionPatterns |
RegEx patterns used to identify agent invitations. | Defined in config |
openclaw.json |
Main configuration file watched by the gateway. | JSON file |
Chat Group Behavior Advanced Features
- Automated Cron Management: Schedules at jobs to automatically close participation windows without manual intervention.
- Hot-Reloading: Configuration changes in Openclaw Skills are applied instantly without service interruption.
- Adaptive Sender Filtering: Dynamically switches between owner-only and group-wide message delivery based on context.
- Reasoning Token Recovery: Specific procedures to clear session transcripts if API errors occur during complex multi-user reasoning steps.
SKILL.md
Loading
Related Openclaw Skills
KYC Vault
A security-focused automation tool for completing identity verification processes using locally stored documents.
SeaLegs Marine Forecast
An AI-driven marine weather skill that provides vessel-specific safety classifications and detailed atmospheric data for any maritime coordinate.
rag-ingest
A specialized skill for chunking, embedding, and ingesting pre-processed text directly into a Qdrant vector database for RAG workflows.
Scrapling Web Scraping Skill
A powerful Python web scraping skill designed to bypass anti-bot protections and extract structured data from complex dynamic websites.
Group Activation
Automates the process of an AI agent joining and leaving time-limited group chat conversations on messaging platforms.
Clawpheus
Clawpheus transforms an AI's daily memories into symbolic dream sequences to foster pattern recognition and introspective pondering.
Featured*
