Skip to content
privatekey7Public

About

One-command auto-deploy of a Telegram AI agent (OpenClaw + Qwen via OpenRouter) on a fresh VPS. Handles proxy-per-key rotation and real-time rate-limit monitoring.

Topics

Resources

Stars

6 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

Repository files navigation

🇷🇺 Русский | 🇬🇧 English

FreeClaw

Заполни конфиг — получи бесплатного OpenClaw агента в Telegram за пару минут. Без ошибок рейт-лимитов.

python freeclaw.py

Одна команда — и на твоём сервере работает OpenClaw с Qwen 3.6. Бот отвечает в Telegram, сервер живёт сам.


Что нужно подготовить

Что Где взять
Linux VPS Immers Cloud (+20% к первому пополнению по реф. ссылке), Hetzner, DigitalOcean, Timeweb... Ubuntu 20/22/24
Telegram-бот @BotFather → /newbot → скопируй токен
Твой Telegram ID Напиши @userinfobot — он пришлёт цифровой ID
OpenRouter ключи openrouter.ai/settings/keys → Create Key
Прокси по одному на каждый ключ — Travchis Proxies

Зачем прокси на каждый ключ? OpenRouter видит IP-адрес. Если все ключи идут с одного IP — общий лимит быстро кончается. С разными прокси каждый ключ = независимый лимит. 1 ключ = 50 req/день


Установка

1 — Клонируй и установи зависимости

git clone https://github.com/your-repo/FreeClaw
cd FreeClaw
pip install -r requirements.txt

2 — Заполни config.yaml

# Токен бота от @BotFather
bot_token: "1234567890:AABBCCddEEFFggHHiiJJkkLL..."

# Твой Telegram ID (узнать у @userinfobot)
telegram_user_id: 123456789

# Данные SSH-подключения к серверу
server:
  host: "1.2.3.4"
  user: "ubuntu"
  key_path: "my-server-key.pem"   # или: password: "yourpassword"

# OpenRouter ключи — каждый со своим прокси
keys:
  - api_key: "sk-or-v1-ПЕРВЫЙ_КЛЮЧ"
    proxy: "http://user:[email protected]:3128"

  - api_key: "sk-or-v1-ВТОРОЙ_КЛЮЧ"
    proxy: "http://user:[email protected]:3128"

  # Добавляй сколько угодно:
  # - api_key: "sk-or-v1-ТРЕТИЙ_КЛЮЧ"
  #   proxy: "http://user:[email protected]:3128"

3 — Запусти

python freeclaw.py

Скрипт сам установит Node.js, OpenClaw, развернёт прокси и запустит бота. Займёт 2–3 минуты.

После деплоя отображается реальный остаток лимитов по каждому ключу:

  Остаток лимитов по ключам:
    ...940ac6bc  ██████████  49/50 req/day  ✓ активен
    ...f19a6123  █████████░  47/50 req/day  ✓ активен
    ...cfcc4c1d  ░░░░░░░░░░   0/50 req/day  ✗ дневной лимит

  Итого:  96/150 req/day доступно  (64%)
  ⚠ Ключи с дневным лимитом обновятся в 00:00 UTC

4 — Напиши боту

Открой Telegram, найди своего бота и начни общаться 🎉


Как это работает

Telegram  →  OpenClaw  →  Прокси (localhost)  →  OpenRouter  →  AI

Автоматический выбор модели — FreeClaw всегда пытается использовать Qwen 3.6 (1M контекст). Если модель перегружена или все ключи получили 429 на ней, прокси прозрачно переключается на следующую — ты не видишь ни одной ошибки:

Приоритет Модель Контекст
1 Qwen 3.6 Plus 1 000 000 токенов
2 GPT-OSS 120B 131 072 токена
3 MiniMax M2.5 196 608 токенов
4 NVIDIA Nemotron 120B 262 144 токена
... ещё 6 резервных —

Ротация ключей — запросы равномерно распределяются по всем ключам через разные IP. Счётчики синхронизируются из реальных заголовков OpenRouter (x-ratelimit-remaining-requests).

Умная обработка 429:

  • Per-minute 429 — ключ уходит в кулдаун на 65 секунд, следующий запрос идёт через другой ключ
  • Daily 429 — ключ отключается до 00:00 UTC, не расходует попытки
  • Все ключи 429 на одной модели — модель помечается перегруженной на 5 минут, прокси переходит к следующей в цепочке

Добавить ещё ключи

Просто добавь новые записи в config.yaml → раздел keys и запусти скрипт снова:

python freeclaw.py

Всё обновится автоматически — без перезапуска бота вручную.


Структура проекта

FreeClaw/
├── freeclaw.py          ← Запускаешь это: деплоит всё на сервер
├── openrouter_proxy.py  ← Деплоится на сервер автоматически
├── config.yaml          ← Твой конфиг
└── requirements.txt

Частые вопросы

Бот не отвечает после установки? Подожди 30–60 секунд после первого запуска — OpenClaw стартует. Затем напиши боту.

Нужно ли менять прокси после установки? Нет. Прокси хранятся на сервере и работают постоянно.

Можно без прокси? Да, но тогда все ключи считаются с одного IP и суммарный лимит будет как у одного ключа.

Ошибка при подключении к серверу? Скрипт автоматически делает 3 попытки подключения. Если все три не удались — проверь IP в config.yaml, права на .pem файл (chmod 600 key.pem) и доступность порта 22.

Какой хостинг выбрать? Любой с Ubuntu 20/22/24. От $4/мес. Рекомендуем Immers Cloud — при регистрации по реф. ссылке сразу +20% к первому пополнению. Также подойдут: Hetzner CX22, DigitalOcean Droplet, Timeweb Cloud.

About

One-command auto-deploy of a Telegram AI agent (OpenClaw + Qwen via OpenRouter) on a fresh VPS. Handles proxy-per-key rotation and real-time rate-limit monitoring.

Topics

Resources

Stars

6 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages