Telegram-user: add onboarding + docs

This commit is contained in:
Muhammed Mukhthar CM committed 2026-01-30 12:19:19 +00:00
1 parent a4bea14162
commit b953e0bff8
4 files changed
+407

No files matched your search

+1
View File
@@ -13,6 +13,7 @@ Text is supported everywhere; media and reactions vary by channel.
- [WhatsApp](/channels/whatsapp) — Most popular; uses Baileys and requires QR pairing.
- [Telegram](/channels/telegram) — Bot API via grammY; supports groups.
- [Telegram User](/channels/telegram-user) — MTProto user account; DM-only for now (plugin, installed separately).
- [Discord](/channels/discord) — Discord Bot API + Gateway; supports servers, channels, and DMs.
- [Slack](/channels/slack) — Bolt SDK; workspace apps.
- [Google Chat](/channels/googlechat) — Google Chat API app via HTTP webhook.
+68
View File
@@ -0,0 +1,68 @@
---
summary: "Connect a Telegram user account via MTProto (DM-only)"
---
# Telegram User
Telegram User connects Clawdbot to a **personal Telegram account** using MTProto.
Use this when you need user-level DMs or want to message from your own account.
## Requirements
- Telegram API ID + API hash from [my.telegram.org](https://my.telegram.org).
- The `telegram-user` plugin installed.
## Install the plugin
If the plugin is not bundled, install it:
```bash
clawdbot plugins install @clawdbot/telegram-user
```
## Configure
You can store credentials in config or use env vars.
Option A: env vars (default account only)
```bash
export TELEGRAM_USER_API_ID="123456"
export TELEGRAM_USER_API_HASH="your_api_hash"
clawdbot channels add --channel telegram-user --use-env
```
Option B: config
```bash
clawdbot channels add --channel telegram-user --api-id 123456 --api-hash your_api_hash
```
## Login (QR or phone code)
QR login (default):
```bash
clawdbot channels login --channel telegram-user
```
Phone login:
```bash
export TELEGRAM_USER_PHONE="+15551234567"
clawdbot channels login --channel telegram-user
```
Optional env helpers:
- `TELEGRAM_USER_CODE` (one-time code)
- `TELEGRAM_USER_PASSWORD` (2FA password)
## Security (DM policy)
By default, DMs are protected with pairing. Approve requests with:
```bash
clawdbot pairing approve telegram-user <code>
```
See [Pairing](/start/pairing) for details.
## Limitations
- DM-only (no groups or channels yet).
- Calls are not supported.