@alfe.ai/openclaw-telegram
v0.0.20
Published
Local-custody Telegram MTProto user-session listener for OpenClaw
Readme
@alfe.ai/openclaw-telegram
Local Telegram user-session access for an Alfe/OpenClaw agent. It uses Telethon/MTProto, so it can see the same dialog list as the signed-in Telegram account instead of the restricted Bot API view.
Open the agent's Connections in Alfe and choose Connect Telegram. Enter your phone number, Telegram verification code, and optional two-step password. Alfe supplies the application credentials and prepares the isolated local runtime. There are no commands or developer credentials for the user to provide.
The browser encrypts each private answer for a short-lived login attempt on the agent. The cloud relays ciphertext; the agent decrypts it and passes it directly to the local Telegram client. Codes and passwords do not enter agent prompts, logs, or configuration. The Telegram device session stays on that machine. The local login attempt expires after ten minutes and can be cancelled.
Managed hosts provide Python 3. Self-hosted hosts need Python 3.9 or newer; the
integration creates its own virtual environment and installs pinned Telethon.
If Python's built-in venv support is missing, it downloads a hash-verified PyPA
virtualenv zipapp into the agent's private directory without changing system
packages. Operators may still use alfe-telegram login --agent-id <agent-id>
as a diagnostic fallback with their own Telegram application credentials.
Agent tools:
telegram_statustelegram_list_chatstelegram_list_subscriptionstelegram_subscribetelegram_unsubscribe
Subscriptions are explicit and read-only toward Telegram. Incoming text and captions can trigger agent turns; generated responses are not posted back. Only subscribe where you have permission to process the messages, and follow Telegram's API terms.
Removing the Alfe Connection stops and uninstalls the listener but deliberately does not erase a logged-in device during an ordinary reinstall. Before retiring the machine, revoke the device session and remove its local state with:
npx -y @alfe.ai/[email protected] logout --agent-id <agent-id>