После установки_

Руслан установлен. Осталось 3 шага – и бот работает.

Чек-лист

1. Telegram ID – указать свой ID в config.yaml

2. Bot Token – получить токен у @BotFather

3. Провайдер LLM – выбрать модель и ввести API-ключ

4. Запуск – ruslan

## Шаг 1: Узнать свой Telegram ID

~/Руслан/TELEGRAM_ID.md

Руслан должен знать, кто его хозяин – иначе он будет отвечать всем.

Как узнать свой Telegram ID:

1. Открой Telegram и найди бота @userinfobot

2. Напиши ему /start

3. Он ответит твоим ID – это число вроде 123456789

Запиши ID в config:

telegram: allowed_users: - 123456789 # ← твой ID bot_token: "" # ← заполним на шаге 2

💡 Можно добавить несколько ID через дефис – это для семьи или команды.

## Шаг 2: Получить Bot Token

~/Руслан/BOT_TOKEN.md

Bot Token – это «пароль» твоего бота в Telegram. Получи его у BotFather:

1. Открой Telegram, найди @BotFather

2. Напиши /newbot

3. Придумай имя: например Мой Руслан

4. Придумай username: например my_ruslan_bot (должен заканчиваться на _bot)

5. BotFather пришлёт токен вида:

# Токен выглядит так: 1234567890:AAExxxxxx-yyyyyyyyyyyyyyyyyyyyyyyyyyy

Запиши токен в config:

telegram: allowed_users: - 123456789 bot_token: "1234567890:AAExxxxxx-yyyyyyyyyyyyyyyyyyyyyyyyyyy"

⚠ Никому не показывай токен! Кто знает токен – тот управляет ботом.

## Шаг 3: Выбрать провайдера LLM

~/Руслан/PROVIDER.md

Руслану нужен «мозг» – языковая модель. Есть бесплатные и платные варианты.

🆓 Бесплатно: OpenRouter :free

1. Зарегистрируйся: openrouter.ai/keys

2. Нажми «Create API Key», скопируй sk-or-v1-...

3. Запиши в config:

model: default: qwen/qwen3-coder:free # бесплатная модель providers: openrouter: base_url: https://openrouter.ai/api/v1 # В .env добавь: OPENROUTER_API_KEY=sk-or-v1-твой-ключ

⚡ Быстро: Groq

1. Получи ключ: console.groq.com/keys

2. Запиши в config:

model: default: llama-3.3-70b-versatile providers: groq: base_url: https://api.groq.com/openai/v1 # В .env: GROQ_API_KEY=твой-ключ

🧠 Умно: DeepSeek

1. Получи ключ: platform.deepseek.com

2. Запиши в config:

model: default: deepseek-chat providers: deepseek: base_url: https://api.deepseek.com/v1 # В .env: DEEPSEEK_API_KEY=твой-ключ

🦙 Локально: Ollama (без ключа)

Без интернета, без ключей. Подходит для Mac/Linux/Windows.

# Установить Ollama: curl -fsSL https://ollama.com/install.sh | sh # Скачать модель (1.5 ГБ): ollama pull qwen2.5:1.5b

model: default: qwen2.5:1.5b providers: ollama: base_url: http://localhost:11434/v1 # Ключ не нужен!

⚠ Ollama не подходит для Android – модель на телефоне слишком медленная.

[ Все способы получить LLM ]

## Шаг 4: Запустить

~/Руслан/START.sh

Всё готово. Запускай:

# Запусти gateway: ruslan

Руслан запустится, покажет баннер 🛡 и начнёт слушать Telegram.

Напиши своему боту в Telegram – он ответит!

Проверка:

# Напиши боту в Telegram: /status # покажет модель, провайдера, статус /help # список всех команд

💡 Если мастер настройки не запустился автоматически, выполни: ruslan setup

Где лежит config.yaml?

~/Руслан/PATHS.md

Конфигурация Руслана живёт в папке ~/.ruslan/

# Linux / macOS / Termux: ~/.ruslan/config.yaml # основной конфиг ~/.ruslan/.env # API-ключи (секретно) ~/.ruslan/SOUL.md # личность агента # Windows: %USERPROFILE%\.ruslan\config.yaml %USERPROFILE%\.ruslan\.env

Отредактировать конфиг:

# Открой в редакторе: nano ~/.ruslan/config.yaml # Linux/Mac/Termux notepad %USERPROFILE%\.ruslan\config.yaml # Windows

Пример config.yaml

~/Руслан/config.yaml.example

Минимальный рабочий конфиг (OpenRouter :free):

# ~/.ruslan/config.yaml display: language: ru # русский язык skin: ruslan # зелёная тема 🛡 model: default: qwen/qwen3-coder:free telegram: allowed_users: - 123456789 # ← твой Telegram ID bot_token: "1234567890:AAExxxxxx-yyy..." providers: openrouter: base_url: https://openrouter.ai/api/v1

И соответствующий .env:

# ~/.ruslan/.env OPENROUTER_API_KEY=sk-or-v1-твой-ключ-здесь

Не работает?

~/Руслан/TROUBLESHOOTING.md

❌ Бот не отвечает в Telegram

• Проверь, что bot_token в config.yaml указан правильно

• Проверь, что allowed_users содержит твой ID

• Убедись, что gateway запущен: руслан

• Перезапусти: руслан

❌ Ошибка API / модель не отвечает

• Проверь ключ в ~/.ruslan/.env

• Ключ без кавычек: OPENROUTER_API_KEY=sk-or-v1-...

• Для OpenRouter используй модели с :free

• Перезапусти gateway после изменения .env

❌ Termux: процесс убивается

• На HyperOS/Xiaomi – настрой фоновую активность (см. инструкцию по Android)

• Закрепи Termux в списке недавних приложений

• Установи termux-boot для автозапуска

❌ Windows: ошибка TLS

• Выполни перед установкой: [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

• Используй Python 3.10+ (на Vista/Win7 – 3.10 максимум)