A safety-first skill designed to permanently delete OpenClaw agents, including their workspaces, local configurations, and associated Telegram group routings.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install delete-agent-with-telegram-group
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 delete-agent-with-telegram-group 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 Delete Agent with Telegram Group?
This skill provides a rigorous and secure workflow for decommissioning agents within the OpenClaw ecosystem. As a vital part of Openclaw Skills, it handles the removal of agent files, workspace directories, cron jobs, and complex Telegram routing configurations while enforcing strict confirmation gates to prevent accidental data loss. It ensures that system resources are reclaimed and that no ghost configurations remain in the global registry.
By leveraging script-first commands and browser automation for group management, this skill maintains the integrity of the host environment. It is designed for developers who need to manage the lifecycle of multiple agents and want a reliable way to perform clean uninstalls without leaving behind artifacts in the openclaw.json configuration or local storage.
Delete Agent with Telegram Group Use Cases
- Permanently decommissioning an AI agent that is no longer needed.
- Cleaning up local storage by removing agent-specific workspaces and log files.
- Removing Telegram group routings and optionally deleting the dedicated Telegram group via browser automation.
- Pruning outdated cron jobs and bindings from the OpenClaw global configuration.
How Delete Agent with Telegram Group Works
- The user initiates the deletion process by providing the unique agent identifier.
- A dry-run execution is performed using a local script to simulate the deletion and identify all affected paths.
- Upon explicit confirmation, the skill executes a script to remove the agent from the global configuration and delete local directories.
- The skill identifies and removes specific agent bindings and Telegram routing entries.
- If requested, the skill proceeds to handle workspace and cron job cleanup with path validation.
- A separate, high-level confirmation is requested for Telegram group deletion, which is then handled via browser-based automation tools to ensure the group is fully removed from the platform.
Delete Agent with Telegram Group Setup
To use this tool within the Openclaw Skills framework, ensure the deletion script is available in your local directory.
# Perform a dry-run to identify artifacts for removal
python3 scripts/delete_agent.py --agent-id <agent_id> --dry-run
# Execute full cleanup after explicit confirmation
python3 scripts/delete_agent.py --agent-id <agent_id> --yes --delete-workspace --delete-telegram-group-config --delete-cron-jobs
Delete Agent with Telegram Group Data Schema & Taxonomy
The skill organizes its cleanup process by targeting specific nodes in the OpenClaw metadata taxonomy:
| Component | Location / Key | Action |
|---|---|---|
| Agent Registry | ~/.openclaw/openclaw.json | Entry removal from agent list |
| Agent Bindings | openclaw.json -> bindings[] | Removes objects matching agentId |
| Telegram Routing | channels.telegram.groups | Deletes associated chat_id entries |
| Filesystem | ~/.openclaw/agents/ |
Recursive deletion of agent folder |
| Workspace | User-defined path | Optional deletion if under home directory |
| Cron Jobs | ~/.openclaw/cron/jobs.json | Filtered removal of agent-owned tasks |
Delete Agent with Telegram Group Advanced Features
- Three-step safety gate requiring separate confirmations for local file deletion and remote Telegram group removal.
- Automatic creation of configuration backups (.bak files) before any write operations occur.
- Path validation guardrails that prevent the script from deleting files outside of designated OpenClaw directories.
- Support for browser-session control to automate the physical deletion of Telegram groups.
- Integration with gateway hot-reloading to apply configuration changes without a full system restart.
SKILL.md
Loading
Related Openclaw Skills
Create Agent with Telegram Group
An automated provisioning tool for creating dedicated AI agents with isolated workspaces and bound Telegram groups.
Viral Video Analysis
An AI-powered diagnostic tool that analyzes video ad transcripts and pacing to provide actionable coaching feedback for high-ROI content.
Influencer Report Skill
An automated vetting tool that generates comprehensive brand safety and content quality reports for influencers using advanced video intelligence.
Spotify CLI
A robust command-line interface for controlling Spotify playback across your devices from a Linux or Raspberry Pi environment.
Miniflux
A powerful CLI-based tool for AI agents to interact with Miniflux RSS feeds, allowing for article discovery, reading, and management.
Google Calendar Skill
A comprehensive automation skill that enables AI agents to manage Google Calendar events, query availability, and handle multiple accounts through a streamlined CLI interface.
Featured*
