Telegram gateway

Akvan Agent را به یک ربات تلگرام خصوصی متصل کنید؛ فقط کاربران مجاز به bot دسترسی دارند.

Telegram gateway به شما اجازه می‌دهد از طریق پیام خصوصی با همان Akvan Agent و sessions ذخیره‌شده کار کنید. دسترسی با token از BotFather و فهرست user IDهای مجاز تلگرام کنترل می‌شود.

ساخت bot

در Telegram با @BotFather گفتگو کنید.
یک bot بسازید و token آن را دریافت کنید.
user ID حساب تلگرام خود را با رباتی مانند @userinfobot پیدا کنید.

تنظیم تعاملی

مدیریت gateway را اجرا کنید:

bash

akvan gateway

در این بخش، Telegram را تنظیم و فعال کنید. Akvan gateway را در یک process پس‌زمینه اجرا می‌کند؛ بازماندن terminal لازم نیست.

تنظیم دستی

این مقادیر را در ~/.akvan/.env قرار دهید:

bash

TELEGRAM_BOT_TOKEN=your_bot_token
TELEGRAM_ALLOWED_USERS=your_telegram_user_id

فقط شناسه‌های موجود در TELEGRAM_ALLOWED_USERS اجازهٔ استفاده از bot را دارند. اگر چند کاربر مجاز هستند، شناسه‌ها را با comma جدا کنید.

provider و billing

Telegram gateway از همان provider و مدل تنظیم‌شده برای CLI استفاده می‌کند. اگر provider فعال akvan باشد، مصرف از اعتبار حساب Akvan کسر می‌شود. اگر provider فعال openrouter، deepseek یا openai-codex باشد، gateway از همان کلید API یا ورود Codex CLI استفاده می‌کند.

فرمان‌ها و approvalها

bot فرمان‌های /new، /status، /settings، /stop و /help را ارائه می‌کند. فرمان /learn فعلاً فقط در CLI در دسترس است، نه در Telegram gateway. برای یادگیری skill از طریق bot، ابتدا workflow را در گفتگو انجام دهید و در CLI با /learn یا /resume ادامه دهید.

برای عملیات حساس، دکمه‌های Allow once، Allow for session، Always allow و Deny نمایش داده می‌شوند.

کاربرهای مجاز Telegram همان tool access محلی CLI را دارند: فایل، terminal، memory، skills و sessions. بنابراین از --yolo برای gateway راه دور استفاده نکنید، مگر اینکه کاملاً به همهٔ کاربرهای مجاز و پروژه اعتماد دارید.

برای بررسی log gateway:

bash

akvan logs gateway telegram -f

گزارش مشکل مستندات