Sponsored by

Find leads on Reddit on auto pilot

Agent skills
channel-telegram

Agent skill

channel-telegram

Run and operate a Telegram channel worker for LionClaw using the kernel channel bridge APIs.

View SKILL.md on GitHub Repository

Stars 1

Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/moshthepitt/lionclaw/tree/main/skills/channel-telegram

SKILL.md

Telegram Channel Worker

Use this skill when the user wants Telegram as a LionClaw channel.

What you run:

start LionClaw in service mode,
run the Telegram worker,
let it bridge Telegram traffic into LionClaw.

Under the hood, the worker:

polls Telegram updates,
posts inbound text to /v0/channels/inbound and treats the response as queued work, not completed work,
long-polls /v0/channels/stream/pull,
starts Telegram typing from kernel queue/runtime status events and coalesces answer deltas into provider-facing Telegram replies,
advances its consumer cursor through /v0/channels/stream/ack.

Prerequisites

curl
jq
Telegram bot token with DM access
LionClaw running (default http://127.0.0.1:8979)

Setup

Register the skill and channel:

bash

lionclaw skill add skills/channel-telegram --alias telegram
lionclaw channel add telegram

Start LionClaw for background channels:

bash

lionclaw service up --runtime codex

Run the worker script:

bash

TELEGRAM_BOT_TOKEN=... \
LIONCLAW_BASE_URL=http://127.0.0.1:8979 \
./skills/channel-telegram/scripts/worker.sh

Notes

LionClaw enforces peer pairing (pending -> approved via /v0/channels/peers/approve).
peer_id is Telegram chat.id serialized as string.
The worker defaults consumer_id to telegram:<channel_id> and start_mode=resume, so undelivered stream events are replayed after worker restart.
Telegram delivery is message-oriented by default: typing while a turn is active, final answer on done, no reasoning lane delivery.
Runtime selection normally comes from lionclaw service up --runtime .... LIONCLAW_RUNTIME_ID is an optional per-worker override for low-level testing.
The worker stores Telegram offset in .lionclaw-telegram-offset by default.

Maintainer

moshthepitt Core maintainer

Source details

Full Name: moshthepitt/lionclaw
Branch: main
Path in repo: skills/channel-telegram
License: MIT License
Topics: ai agent-skills ai-agents skills llm openclaw codex openai opencode agentic-ai ai-skills openclaw-skills nanoclaw ironclaw

Featured Tools

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

moshthepitt/lionclaw

channel-terminal

Run and operate a local terminal/TUI channel for LionClaw using the kernel channel bridge APIs.

computerlovetech/agr

migrate-to-skills

computerlovetech/agr

discover-assumptions

Use after solution concepts exist to surface and prioritize assumptions behind outcomes, opportunities, or solution ideas and design experiments to test them.

computerlovetech/agr

discover-opportunities

Use after outcomes are defined to discover opportunities, unmet needs, market gaps, or JTBD insights before choosing solutions.

computerlovetech/agr

discover-outcomes

Use at the start of product strategy to define or refine desired outcomes and success metrics (e.g., for Opportunity Solution Trees or continuous discovery) before selecting opportunities or solutions.

computerlovetech/agr

ideate-solutions

Use after opportunities are defined to generate and evaluate multiple product solution concepts before validating assumptions. Triggers when you need a set of distinct solution options tied to outcomes and opportunities.

Didn't find tool you were looking for?