← 返回 Skills 市场

Delete Agent With Telegram Group

Name: Delete Agent With Telegram Group
Author: sheetaa

作者 Sheeta · GitHub ↗ · v0.1.2

cross-platform ✓ 安全检测通过

533

总下载

当前安装

版本数

在 OpenClaw 中安装

/install delete-agent-with-telegram-group

功能描述

Safely and thoroughly delete an OpenClaw agent and its artifacts. Use when user asks to remove an agent completely, including workspace, agent files under ~/...

使用说明 (SKILL.md)

Delete Agent (Clean)

Permanently remove an agent and its related local config/files.

Safety Rules

This is destructive. Always require explicit user confirmation.
Enforce 3-step gate:
1. run --dry-run,
2. explicit confirmation for local deletion,
3. separate explicit confirmation for Telegram browser/session-controlled group deletion.
Ask user whether to also delete the dedicated Telegram group.
Never auto-delete Telegram groups without the separate confirmation.
Prefer script execution for local cleanup (stable, low token).

Inputs

Collect:

agent_id (required)
delete_workspace (yes/no)
delete_telegram_group_config (yes/no; usually yes)
delete_telegram_group (yes/no; requires explicit confirmation)
delete_cron_jobs (yes/no; usually yes)

Script-first Commands

Dry-run:

python3 scripts/delete_agent.py --agent-id \x3Cagent_id> --dry-run

Execute (after confirmation):

python3 scripts/delete_agent.py --agent-id \x3Cagent_id> --yes --delete-workspace --delete-telegram-group-config --delete-cron-jobs

Script Safety Guardrails

scripts/delete_agent.py validates agent_id format: [a-z0-9-]+.
It refuses deletion when target paths are outside allowed directories.
Workspace deletion is allowed only when path is under user home and folder name starts with claw-.
It creates backup files before writing config changes.

What the script removes

Agent entry in ~/.openclaw/openclaw.json (agents.list)
Agent bindings (bindings[] with matching agentId)
Telegram group routing entries linked by those bindings
- channels.telegram.groups.\x3Cchat_id>
Agent directory:
- ~/.openclaw/agents/\x3Cagent_id>
Workspace directory from agent config (if --delete-workspace)
Cron jobs owned by this agent from ~/.openclaw/cron/jobs.json (if --delete-cron-jobs)

Dedicated Telegram Group Deletion

This skill does not bundle Telegram deletion automation code; it uses external browser automation tooling or manual user actions.

After local script deletion and only if user confirmed delete_telegram_group=yes:

Require a separate explicit confirmation: user agrees to browser/session control and irreversible group deletion.
Identify dedicated group chat_id from removed bindings.
Use browser automation (Telegram Web) to open the group and run Delete Group.
In Telegram delete dialog, enable Delete for all members when available, then confirm deletion.
Report final group status clearly: deleted / left-only / pending-manual.

Post-step

Surface backup files created by the script (openclaw.json.bak.*, jobs.json.bak.*) so user can retain recovery points.
If gateway reload is available, let hot reload apply.
If not applied, ask for explicit confirmation before restarting gateway, then verify logs.
Return concise summary with removed items.

安全使用建议

This skill appears to do exactly what it says: run the dry-run first and inspect its JSON plan; confirm local deletion explicitly; the script will back up openclaw.json and jobs.json before overwriting and will only delete workspaces under your home when the folder name starts with "claw-". It does NOT automatically delete Telegram groups — SKILL.md instructs you to perform browser automation or manual deletion separately and to require an extra confirmation for that step. Before using: (1) run the provided dry-run and review the printed plan, (2) inspect the backup files it creates, (3) verify openclaw.json contents and other data you may want to keep, and (4) avoid running any separate browser automation unless you trust the tooling. If you need higher assurance, open the script yourself to confirm there are no unexpected network calls (there are none) and consider making offline copies of critical files before proceeding.

功能分析

Type: OpenClaw Skill Name: delete-agent-with-telegram-group Version: 0.1.2 The skill bundle is designed for the legitimate, albeit destructive, purpose of cleanly deleting an OpenClaw agent and its associated artifacts. The `scripts/delete_agent.py` script implements robust security guardrails, including strict input validation (`re.fullmatch` for agent ID), path traversal prevention (`validate_within` function ensuring operations are confined to expected directories and user home), and explicit confirmation (`--yes` flag) for destructive actions. The `SKILL.md` instructions emphasize multiple user confirmations for irreversible actions like Telegram group deletion, which, while powerful, is explicitly stated as part of the skill's purpose and not an attempt at unauthorized access or data exfiltration. No evidence of malicious intent, data exfiltration, persistence, or obfuscation was found.

能力评估

✓ Purpose & Capability

The name/description (delete an agent and related local artifacts including Telegram routing config) aligns with the included script and SKILL.md: the script edits ~/.openclaw/openclaw.json, cron jobs, agent dir, and optional workspace removal. Nothing requested or included appears unrelated to that purpose.

ℹ Instruction Scope

SKILL.md enforces a 3-step destructive gate and instructs a dry-run first; the Python script implements those behaviors. The SKILL.md mentions Telegram group deletion via external browser automation/manual steps but does not include code to perform remote/browser control—this is an out-of-band action that correctly requires separate explicit user consent. Verify any browser automation you run independently.

✓ Install Mechanism

No install spec (instruction-only with a bundled script). No downloads or package installs are performed by the skill, so no install-time code-fetch risk.

✓ Credentials

The skill requests no environment variables, credentials, or config paths beyond standard home-dir file paths. The script only reads/writes files under the user's home (~/.openclaw) and optionally workspaces under the user's home with a claw-* name guard.

✓ Persistence & Privilege

The skill is not always-enabled and does not request persistent system-wide privileges. It does modify only its own OpenClaw config files and writes backups in-place; that is expected for a deletion tool.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install delete-agent-with-telegram-group
安装完成后，直接呼叫该 Skill 的名称或使用 /delete-agent-with-telegram-group 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v0.1.2

Security hardening: add strict agent_id/path validation in delete script, restrict workspace deletion to safe claw-* paths under home, enforce 3-step confirmation gates, and require explicit approval before any gateway restart/browser-driven Telegram group deletion.

v0.1.1

Improve safety controls: enforce dry-run-first workflow, require separate explicit confirmation before browser/session-controlled Telegram group deletion, clarify external automation dependency, and explicitly report backup files for recovery.

v0.1.0

Cleanly remove an agent and related artifacts (workspace, ~/.openclaw agent files/config/bindings) and, when confirmed, delete the dedicated Telegram group via browser automation.

元数据

Slug delete-agent-with-telegram-group

版本 0.1.2

许可证 —

累计安装 0

当前安装数 0

历史版本数 3

常见问题