Telegram-user: add onboarding + docs
This commit is contained in:
1 parent
a4bea14162
commit
b953e0bff8
4 files changed
+407
No files matched your search
@@ -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.
|
||||
|
||||
@@ -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.
|
||||
Reference in new issue
Block a user