# Openclaw Async Telegram Bot

> Add or update asynchronous Telegram bot accounts in OpenClaw. Use when user asks to add multiple Telegram bots, run bots in parallel, or asks OpenClaw to guide BotFather-based provisioning. Enforces username pattern Nebutra[three digits]_bot and philosopher-style English bot names.

- **Type:** Skill
- **Install:** `agentstack add skill-nebutra-openclaw-async-telegram-bot-skill-openclaw-async-telegram-bot-skill`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Nebutra](https://agentstack.voostack.com/s/nebutra)
- **Installs:** 0
- **Category:** [Communication](https://agentstack.voostack.com/c/communication)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Nebutra](https://github.com/Nebutra)
- **Source:** https://github.com/Nebutra/OpenClaw-Async-Telegram-Bot-Skill

## Install

```sh
agentstack add skill-nebutra-openclaw-async-telegram-bot-skill-openclaw-async-telegram-bot-skill
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# OpenClaw Async Telegram Bot

## Use This Skill When

- User asks for multiple Telegram bots in parallel ("async bots", "multi-bot setup", "parallel telegram bots")
- User asks OpenClaw to guide creation of a new Telegram bot via BotFather and configure it
- User wants one bot per account (optionally one bot per dedicated agent)

## Naming Rules

- Bot username must be `Nebutra[three-digits]_bot` (example: `Nebutra007_bot`)
- Bot display name must be an English ancient Greek philosopher name
- This skill uses this fixed set:
  - `Socrates`
  - `Plato`
  - `Aristotle`
  - `Pythagoras`
  - `Heraclitus`
  - `Democritus`
  - `Epicurus`
  - `Zeno`
  - `Thales`
  - `Anaxagoras`

## BotFather Constraint

- OpenClaw cannot mint new Telegram bot tokens directly.
- Telegram bot token creation must be done in BotFather by the user (`/newbot`).
- This skill must guide the user through BotFather, then configure OpenClaw with the fresh token.

## Token Freshness Rules

- For **new bot** requests, never auto-reuse a token from memory or earlier conversation context.
- Always request a fresh token generated in BotFather for the new bot.
- If a provided token is already bound to an existing OpenClaw account, treat it as an update flow and require explicit confirmation.

## Workflow

1. If user asks for a **new bot**, prefer RPA-assisted flow on macOS with `botfather_rpa_assist_mac.sh`.
2. If RPA is not available, run `prepare_botfather_new_bot.sh` to generate deterministic BotFather inputs.
3. Get fresh token from BotFather.
4. Validate token with Telegram `getMe`.
5. Reject token if username does not match `^Nebutra[0-9]{3}_bot$`.
6. Reject token if it is already registered in OpenClaw, unless user explicitly confirms update flow.
7. Add/update Telegram account in OpenClaw (`channels add`).
8. Restart gateway and verify `running + probe.ok=true`.
9. Optional: create a dedicated isolated agent bound to `telegram:`.

## Command

RPA-assisted end-to-end flow (macOS):

```bash
bash scripts/botfather_rpa_assist_mac.sh --name "Aristotle"
```

Optional RPA flags:

```bash
# include dedicated agent creation
bash scripts/botfather_rpa_assist_mac.sh --name "Aristotle" --agent-id "aristotle-agent"

# run only the BotFather RPA step (no OpenClaw configuration yet)
bash scripts/botfather_rpa_assist_mac.sh --name "Aristotle" --no-configure

# extend clipboard wait window for auto-token pickup
bash scripts/botfather_rpa_assist_mac.sh --name "Aristotle" --wait-clipboard 300
```

BotFather-assisted new bot planning:

```bash
bash scripts/prepare_botfather_new_bot.sh
```

Optional planning flags:

```bash
# Force serial (otherwise auto-pick next available)
bash scripts/prepare_botfather_new_bot.sh --serial 2

# Force display name and include dedicated agent in follow-up command
bash scripts/prepare_botfather_new_bot.sh --name "Aristotle" --agent-id "aristotle-agent"

# Emit machine-readable JSON for automation
bash scripts/prepare_botfather_new_bot.sh --json
```

Configure bot after receiving fresh token:

```bash
bash scripts/add_async_telegram_bot.sh --token ""
```

Optional flags:

```bash
# Force account id
bash scripts/add_async_telegram_bot.sh --token "" --account-id "plato-007"

# Force philosopher display name
bash scripts/add_async_telegram_bot.sh --token "" --name "Plato"

# Create isolated agent bound to this telegram account
bash scripts/add_async_telegram_bot.sh --token "" --agent-id "plato-agent"

# Reuse an already-registered token intentionally (update flow only)
bash scripts/add_async_telegram_bot.sh --token "" --allow-existing-token

# Dry run
bash scripts/add_async_telegram_bot.sh --token "" --dry-run
```

## BotFather Notes

If user needs a fresh token, or username validation fails, stop and ask user to recreate bot in BotFather:

1. `/newbot`
2. Bot display name: philosopher English name
3. Bot username: `Nebutra###_bot`
4. Return the new token

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Nebutra](https://github.com/Nebutra)
- **Source:** [Nebutra/OpenClaw-Async-Telegram-Bot-Skill](https://github.com/Nebutra/OpenClaw-Async-Telegram-Bot-Skill)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-nebutra-openclaw-async-telegram-bot-skill-openclaw-async-telegram-bot-skill
- Seller: https://agentstack.voostack.com/s/nebutra
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.