FreeClaw
Health Uyari
- No license — Repository has no license file
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 6 GitHub stars
Code Gecti
- Code scan — Scanned 4 files during light audit, no dangerous patterns found
Permissions Gecti
- Permissions — No dangerous permissions requested
Bu listing icin henuz AI raporu yok.
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.
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.
Автор
Канал в Telegram: @privatekey_ai — Claude Code, ИИ-агенты и новые нейросети на практике.
Вопросы и предложения — в чате канала.
Yorumlar (0)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi