# Send Create Agent With Telegram Group to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "create-agent-with-telegram-group",
    "name": "Create Agent With Telegram Group",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/Sheetaa/create-agent-with-telegram-group",
    "canonicalUrl": "https://clawhub.ai/Sheetaa/create-agent-with-telegram-group",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/create-agent-with-telegram-group",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=create-agent-with-telegram-group",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/init_workspace.py",
      "scripts/provision_config.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "create-agent-with-telegram-group",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-29T15:43:05.473Z",
      "expiresAt": "2026-05-06T15:43:05.473Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=create-agent-with-telegram-group",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=create-agent-with-telegram-group",
        "contentDisposition": "attachment; filename=\"create-agent-with-telegram-group-0.1.5.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "create-agent-with-telegram-group"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/create-agent-with-telegram-group"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/create-agent-with-telegram-group",
    "downloadUrl": "https://openagent3.xyz/downloads/create-agent-with-telegram-group",
    "agentUrl": "https://openagent3.xyz/skills/create-agent-with-telegram-group/agent",
    "manifestUrl": "https://openagent3.xyz/skills/create-agent-with-telegram-group/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/create-agent-with-telegram-group/agent.md"
  }
}
```
## Documentation

### Agent Create + Dedicated Telegram Group

Create one dedicated Telegram group per agent, bind the agent to that group, and set an isolated workspace path.

### Script-first Rule

Prefer bundled scripts for deterministic steps (more stable + lower token cost). Only do manual JSON editing when scripts cannot cover a special case.

Use:

scripts/provision_config.py for agent/config/binding/no-mention setup (with automatic backup of openclaw.json)
scripts/init_workspace.py for USER.md / IDENTITY.md / SOUL.md initialization

### Access Scope

This skill accesses the following files on the host:

~/.openclaw/openclaw.json — read (model discovery) and write (agent binding)
~/.openclaw/cron/jobs.json — read-only (for job listing if needed)
~/claw-<agent-name>/ — workspace directory created by script
~/.openclaw/agents/<agent-id>/agent/ — directory created (no auth files copied)

### Config Safety

scripts/provision_config.py reads and writes ~/.openclaw/openclaw.json.
By default it creates a backup file: ~/.openclaw/openclaw.json.bak.<timestamp>.
It updates only:

agents.list (add/update target agent) — does NOT copy auth credentials
bindings (add target telegram group binding)
channels.telegram.groups.<chat_id>.requireMention=false
gateway.reload.mode only if missing (sets default hybrid)


The skill does NOT propagate API keys or auth tokens between agents.
Gateway-level auth is inherited automatically; do not manually copy auth files.

### Inputs

Collect (before executing):

agent_name (required)
model (required): ask user explicitly which model to use; model options must be read live from the user’s ~/.openclaw/openclaw.json (do not hardcode examples)
Optional telegram_group_title override (custom group name)
Initialization preferences (required ask):

whether to create/update USER.md
whether to create/update IDENTITY.md
whether to create/update SOUL.md


If initialization is enabled, collect content fields before writing files:

USER.md: user name / preferred call name / language / goals / notes
IDENTITY.md: agent display name / vibe / emoji (optional)
SOUL.md: role/mission / tone / constraints (short bullet points)

Normalize agent_name:

Keep lowercase letters, digits, and hyphens only.
Replace spaces/underscores with -.
Use this value in paths and IDs.

Telegram group title rule:

If user provides telegram_group_title, use it directly.
If not provided, generate default title from agent name in PascalCase.

Example: test-skill -> TestSkill, bilingual-agent -> BilingualAgent.

### Workflow

Read available models from ~/.openclaw/openclaw.json first, then confirm inputs with user (agent name, model, init-file preferences, optional telegram group title).
Build workspace path as ~/claw-<agent-name> and create it if missing.
Resolve group title:

custom telegram_group_title if provided
otherwise PascalCase(agent_name)


Create and bind Telegram group (use resolved group title):

use browser automation/user-account flow (Telegram bot API cannot reliably create groups)
CONFIRM with user before triggering browser automation (explicit yes/no required)
if browser automation is unavailable, request the minimal manual steps and resume


Create/update OpenClaw config via script (preferred):

CONFIRM with user before modifying openclaw.json (explicit yes/no required)
python3 scripts/provision_config.py --agent-name <agent_name> --model <model> --chat-id <chat_id>
this sets: agent entry, workspace, binding, and requireMention=false


Apply config and activate it:

if hot reload is enabled, verify reload logs show applied changes
if reload is off or not applied, CONFIRM with user before restarting gateway (explicit yes/no required)
restart gateway only after user approval


Bootstrap agent runtime files (required for first-run stability):

ensure ~/.openclaw/agents/<agent-id>/agent exists
do NOT copy any auth files from other agents (this prevents credential/API key propagation)
new agents inherit authentication from the gateway's shared auth context automatically
do NOT manually copy or create auth-profiles.json, auth.json, or models.json


If initialization is requested, ask user for file content fields first, then write files:

collect required values for USER.md / IDENTITY.md / SOUL.md
then run: python3 scripts/init_workspace.py --workspace <workspace> --agent-name <agent_name> [--with-user] [--with-identity] [--with-soul]
if user provided custom text, apply it after script initialization (overwrite placeholders)


Ensure routing validity for current schema (no invalid allowFrom entries for groups).
Post-provision verification:

send a test message in group and ask user to send ping
confirm agent responds without @mention

Return completion summary with:

agent name
model
workspace path
group title
chat_id
no-mention reply mode (enabled/disabled)
status and next step (if any)

### Telegram Automation Rules

Group creation/deletion and member operations should use browser automation (user-account flow).
For browser flow, prefer Chrome relay profile for existing logged-in Telegram sessions.
If no connected Chrome tab is available, ask user to attach once, then continue.
If Telegram shows confirmation/captcha that cannot be automated, request one manual click, then resume.

### OpenClaw Command Discovery

Do not invent OpenClaw commands.

When agent create/update command syntax is unknown:

Run openclaw help.
If needed, run openclaw <subcommand> --help for the relevant subcommand.
Use only discovered command forms.

### Idempotency

If ~/claw-<agent-name> already exists, reuse it.
If a same-name group already exists, confirm whether to reuse or create a fresh one.
If agent already exists, update model/binding/workdir instead of duplicating.

### Reliability Checks (must do)

Verify requireMention=false for the bound group.
Verify gateway config actually applied:

check reload mode/status logs (config hot reload applied, restarting telegram channel)
if reload is off or not applied, restart gateway and re-check logs.


Send one bot-originated test message to the new group, then require one live user ping.
Verify agent replies without @mention.
Do not claim success before ping -> pong verification passes.

### Failure Handling

If group creation succeeds but binding fails:

Keep created group.
Report exact failed step.
Provide one-command resume instruction for the next run.

If chat_id cannot be resolved automatically:

Report that as a partial success.
Provide the shortest fallback step to fetch chat_id, then continue binding.

### Output Template

Return concise status:

agent: <agent-name>
model: <selected-model>
workspace: ~/claw-<agent-name>
telegram_group: <title>
chat_id: <id or PENDING>
binding: <done|pending>
reply_without_mention: <enabled|disabled>
initialized_files: <USER.md, IDENTITY.md, SOUL.md or subset>
verification: <passed|failed>
next_step: <none or exact minimal action>
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: Sheetaa
- Version: 0.1.5
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-29T15:43:05.473Z
- Expires at: 2026-05-06T15:43:05.473Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/create-agent-with-telegram-group)
- [Send to Agent page](https://openagent3.xyz/skills/create-agent-with-telegram-group/agent)
- [JSON manifest](https://openagent3.xyz/skills/create-agent-with-telegram-group/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/create-agent-with-telegram-group/agent.md)
- [Download page](https://openagent3.xyz/downloads/create-agent-with-telegram-group)