| name | telegram |
| description | Owner-only Telegram text bridge and Mini App gateway for the existing Ouroboros interface. |
| version | 1.0.1 |
| type | extension |
| entry | plugin.py |
| runtime | python3 |
| os | any |
| permissions | ["net","read_settings","widget","route","supervised_task","subscribe_event","inject_chat","subprocess","companion_process"] |
| env_from_settings | ["TELEGRAM_BOT_TOKEN"] |
| subscribe_events | ["chat.outbound","chat.typing","chat.photo","chat.video","chat.document"] |
| conflicts | ["telegram-bridge","telegram-miniapp-poc"] |
| when_to_use | The owner wants to communicate with and control Ouroboros through Telegram. |
| timeout_sec | 60 |
| companion_processes | [{"name":"miniapp_gateway","command":["python3","scripts/companion.py"],"runtime":"python3","restart_policy":"on_failure","max_restarts":5}] |
Telegram
One owner-only Telegram integration provides both the established bot bridge
and the optional Mini App. The first positive private Telegram chat binds as
the sole owner. Text and photos can be sent to Ouroboros; replies, photos,
videos, documents, typing state, subagent cards, and opt-in notifications are
mirrored back to that owner.
The Mini App exposes the unchanged Ouroboros SPA through the established
owner-authenticated sidecar and a pinned Cloudflare Quick Tunnel. It is enabled
by default after owner binding and can be turned off independently without
stopping the text bridge. Disabling the skill destroys process-memory Mini App
sessions, stops public exposure, and best-effort restores the prior Telegram
menu button. Rotate the bot token only while the skill is disabled, then
re-enable it.
Set TELEGRAM_BOT_TOKEN in Settings, grant it to this skill, enable the skill,
and send the bot a private message to bind the owner. No legacy Telegram skill
state is copied or changed. Installations that use telegram-bridge or
telegram-miniapp-poc must disable or remove those skills before enabling this
one.
The Mini App supports macOS arm64/x86_64, Linux arm64/x86_64, and Windows
x86_64. Only the explicit unsupported OS/architecture case degrades
independently: the text bridge remains available while Mini App status reports
that no pinned cloudflared asset exists. Invalid host runtime, unsafe state, or
companion registration errors fail the skill load instead of claiming a partial
healthy installation.
The Mini App is Beta. Its best-effort Cloudflare Quick Tunnel has no SLA and
does not support Server-Sent Events (SSE). It targets native Telegram clients;
Telegram WebA/WebK are not supported.
