{"id":"ab6eb27a-2fdb-4fef-839e-605172cc8c9d","shortId":"t5dK8U","kind":"skill","title":"channel-telegram","tagline":"Run and operate a Telegram channel worker for LionClaw using the kernel channel bridge APIs.","description":"# Telegram Channel Worker\n\nUse this skill when the user wants Telegram as a LionClaw channel.\n\nWhat you run:\n\n1. start LionClaw for background work,\n2. run the Telegram worker,\n3. let it bridge Telegram traffic into LionClaw.\n\nUnder the hood, the worker:\n\n1. polls Telegram updates,\n2. posts inbound text to `/v0/channels/inbound` and treats the response as queued work, not completed work,\n3. long-polls `/v0/channels/stream/pull`,\n4. starts Telegram typing from kernel queue/runtime status events and coalesces `answer` deltas into provider-facing Telegram replies,\n5. advances its consumer cursor through `/v0/channels/stream/ack`.\n\n## Prerequisites\n\n- `python3`\n- `uv`\n- Telegram bot token with DM access\n- LionClaw running (default `http://127.0.0.1:8979`)\n\n## Setup\n\n1. Register the skill and channel:\n\n```bash\nlionclaw skill add skills/channel-telegram --alias telegram\nlionclaw channel add telegram --required-env TELEGRAM_BOT_TOKEN\n```\n\n2. Start LionClaw for background channels:\n\n```bash\nlionclaw up\n```\n\n3. Run the worker script:\n\n```bash\nTELEGRAM_BOT_TOKEN=... \\\nLIONCLAW_BASE_URL=http://127.0.0.1:8979 \\\n./skills/channel-telegram/scripts/worker\n```\n\n## Notes\n\n- LionClaw enforces peer pairing (`pending` -> `approved` via `/v0/channels/peers/approve`).\n- `peer_id` is Telegram `chat.id` serialized as string.\n- The worker defaults `consumer_id` to `telegram:<channel_id>` and `start_mode=resume`, so undelivered stream events are replayed after worker restart.\n- Telegram delivery is message-oriented by default: typing while a turn is active, final answer on `done`, no reasoning lane delivery.\n- Runtime selection normally comes from the selected instance's default runtime. `LIONCLAW_RUNTIME_ID` is an optional per-worker override for low-level testing.\n- The worker stores Telegram offset in `$LIONCLAW_HOME/runtime/channels/$LIONCLAW_CHANNEL_ID/telegram.offset` by default.","tags":["channel","telegram","lionclaw","moshthepitt","agent-skills","agentic-ai","ai-agents","ai-skills","codex","ironclaw","llm","nanoclaw"],"capabilities":["skill","source-moshthepitt","skill-channel-telegram","topic-agent-skills","topic-agentic-ai","topic-ai-agents","topic-ai-skills","topic-codex","topic-ironclaw","topic-llm","topic-nanoclaw","topic-openai","topic-openclaw","topic-openclaw-skills","topic-opencode"],"categories":["lionclaw"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/moshthepitt/lionclaw/channel-telegram","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add moshthepitt/lionclaw","source_repo":"https://github.com/moshthepitt/lionclaw","install_from":"skills.sh"}},"qualityScore":"0.454","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 8 github stars · SKILL.md body (1,891 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:09:16.112Z","embedding":null,"createdAt":"2026-05-18T13:20:36.492Z","updatedAt":"2026-05-18T19:09:16.112Z","lastSeenAt":"2026-05-18T19:09:16.112Z","tsv":"'/skills/channel-telegram/scripts/worker':173 '/v0/channels/inbound':70 '/v0/channels/peers/approve':182 '/v0/channels/stream/ack':111 '/v0/channels/stream/pull':85 '1':37,61,127 '127.0.0.1':124,171 '2':43,65,150 '3':48,81,159 '4':86 '5':105 '8979':125,172 'access':120 'activ':224 'add':136,142 'advanc':106 'alia':138 'answer':97,226 'api':18 'approv':180 'background':41,154 'base':169 'bash':133,156,164 'bot':116,148,166 'bridg':17,51 'channel':2,9,16,20,33,132,141,155,268 'channel-telegram':1 'chat.id':187 'coalesc':96 'come':236 'complet':79 'consum':108,194 'cursor':109 'default':123,193,218,242,271 'deliveri':212,232 'delta':98 'dm':119 'done':228 'enforc':176 'env':146 'event':94,205 'face':102 'final':225 'home/runtime/channels':266 'hood':58 'id':184,195,246 'id/telegram.offset':269 'inbound':67 'instanc':240 'kernel':15,91 'lane':231 'let':49 'level':257 'lionclaw':12,32,39,55,121,134,140,152,157,168,175,244,265,267 'long':83 'long-pol':82 'low':256 'low-level':255 'messag':215 'message-ori':214 'mode':200 'normal':235 'note':174 'offset':263 'oper':6 'option':249 'orient':216 'overrid':253 'pair':178 'peer':177,183 'pend':179 'per':251 'per-work':250 'poll':62,84 'post':66 'prerequisit':112 'provid':101 'provider-fac':100 'python3':113 'queu':76 'queue/runtime':92 'reason':230 'regist':128 'replay':207 'repli':104 'requir':145 'required-env':144 'respons':74 'restart':210 'resum':201 'run':4,36,44,122,160 'runtim':233,243,245 'script':163 'select':234,239 'serial':188 'setup':126 'skill':24,130,135 'skill-channel-telegram' 'skills/channel-telegram':137 'source-moshthepitt' 'start':38,87,151,199 'status':93 'store':261 'stream':204 'string':190 'telegram':3,8,19,29,46,52,63,88,103,115,139,143,147,165,186,197,211,262 'test':258 'text':68 'token':117,149,167 'topic-agent-skills' 'topic-agentic-ai' 'topic-ai-agents' 'topic-ai-skills' 'topic-codex' 'topic-ironclaw' 'topic-llm' 'topic-nanoclaw' 'topic-openai' 'topic-openclaw' 'topic-openclaw-skills' 'topic-opencode' 'traffic':53 'treat':72 'turn':222 'type':89,219 'undeliv':203 'updat':64 'url':170 'use':13,22 'user':27 'uv':114 'via':181 'want':28 'work':42,77,80 'worker':10,21,47,60,162,192,209,252,260","prices":[{"id":"202a9273-ddea-472f-b134-23f0d76f29a3","listingId":"ab6eb27a-2fdb-4fef-839e-605172cc8c9d","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"moshthepitt","category":"lionclaw","install_from":"skills.sh"},"createdAt":"2026-05-18T13:20:36.492Z"}],"sources":[{"listingId":"ab6eb27a-2fdb-4fef-839e-605172cc8c9d","source":"github","sourceId":"moshthepitt/lionclaw/channel-telegram","sourceUrl":"https://github.com/moshthepitt/lionclaw/tree/main/skills/channel-telegram","isPrimary":false,"firstSeenAt":"2026-05-18T13:20:36.492Z","lastSeenAt":"2026-05-18T19:09:16.112Z"}],"details":{"listingId":"ab6eb27a-2fdb-4fef-839e-605172cc8c9d","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"moshthepitt","slug":"channel-telegram","github":{"repo":"moshthepitt/lionclaw","stars":8,"topics":["agent-skills","agentic-ai","ai","ai-agents","ai-skills","codex","ironclaw","llm","nanoclaw","openai","openclaw","openclaw-skills","opencode","skills"],"license":"mit","html_url":"https://github.com/moshthepitt/lionclaw","pushed_at":"2026-05-18T17:12:27Z","description":"Secure-first local AI CLI with a small auditable kernel, durable sessions, and installable skills.","skill_md_sha":"d955589ece031f32533b18b4a5b4f042d62adccc","skill_md_path":"skills/channel-telegram/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/moshthepitt/lionclaw/tree/main/skills/channel-telegram"},"layout":"multi","source":"github","category":"lionclaw","frontmatter":{"name":"channel-telegram","description":"Run and operate a Telegram channel worker for LionClaw using the kernel channel bridge APIs."},"skills_sh_url":"https://skills.sh/moshthepitt/lionclaw/channel-telegram"},"updatedAt":"2026-05-18T19:09:16.112Z"}}