[2026-05-12] taiga sync: family/.DS_Store family/_index.md family/how-to/htpc-access.md family/how-to/htpc-gaming-plans.md family/how-to/htpc-magic4pc.md family/how-to/htpc-migration-plan.md family/how-to/htpc-system.md family/how-to/htpc-webos-luna.md family/how-to/htpc.md family/how-to/magic4pc-webos.md

2026-05-12 11:02:16 -07:00
commit d25629e140
32 changed files with 3821 additions and 0 deletions
@@ -0,0 +1,130 @@
+Теперь вся картина чёткая. Разбираю детально.
+
+---
+
+## Условия OpenRouter — честно
+
+### Бесплатный тир (без карты)
+
+Бесплатный лимит — **50 запросов в день и 20 RPM**. Но если пополнить баланс хотя бы на $10 — лимит вырастает до **1000 запросов в день**, при этом 20 RPM остаётся. [OpenRouter](https://openrouter.ai/docs/faq)
+
+Важный нюанс: **failed запросы тоже считаются** в дневной лимит. То есть если агент словил 429 и ретраит — каждая попытка ест квоту. [OpenRouter](https://openrouter.zendesk.com/hc/en-us/articles/39501163636379-OpenRouter-Rate-Limits-What-You-Need-to-Know)
+
+Итого реально:
+
+| Состояние | req/day | req/min |
+|---|---|---|
+| Без оплаты | 50 | 20 |
+| Пополнил $10+ | 1000 | 20 |
+| Платные модели | без лимита | без лимита |
+
+**$10 разово** — это не подписка, не списывается автоматически. Просто разовое пополнение кредитов, которые тратятся только на платные модели. Зато бесплатные модели сразу получают 1000 req/day. Очень разумный трейдофф.
+
+---
+
+### Что сейчас доступно бесплатно (апрель 2026)
+
+На OpenRouter 28 бесплатных моделей. Топ для наших задач: [Costgoat](https://costgoat.com/pricing/openrouter-free-models)
+
+**Для агентных задач (есть tool calling):**
+- `qwen/qwen3-coder:free` — 262K контекст, лучшая бесплатная модель для кода
+- `qwen/qwen3-next-80b-a3b-instruct:free` — 262K, MoE, инструкции
+- `nvidia/nemotron-3-super-120b-a12b:free` — 262K, гибридная архитектура
+- `openai/gpt-oss-120b:free` — 131K, первая open-weight модель OpenAI
+- `openai/gpt-oss-20b:free` — 131K, быстрее
+- `meta-llama/llama-3.3-70b-instruct:free` — 66K, проверенная
+- `minimax/minimax-m2.5:free` — 197K
+
+**Авто-роутер (выбирает лучшую доступную):**
+- `openrouter/free` — 200K контекст, сам выбирает модель
+
+**Приватность:** некоторые бесплатные модели логируют промпты для обучения — нужно проверять карточку каждой модели. [Teamday](https://www.teamday.ai/blog/best-free-ai-models-openrouter-2026) Для Asana/Gmail задач это важно — использовать только модели без логирования или фильтровать данные до отправки (что мы уже делаем в asana-scout).
+
+---
+
+## Настройка в нашем стеке
+
+**Шаг 1 — Регистрация и ключ**
+
+Зайти на [openrouter.ai](https://openrouter.ai) → Sign Up → Keys → Create Key. Карта не нужна.
+
+Опционально пополнить на $10 для 1000 req/day на бесплатных моделях.
+
+**Шаг 2 — Добавить в `.env`**
+
+```bash
+# ~/ai-stack/.env
+OPENROUTER_API_KEY=sk-or-v1-xxxxx
+```
+
+**Шаг 3 — `docker-compose.yml`**
+
+```yaml
+services:
+  openclaw:
+    environment:
+      - OPENROUTER_API_KEY=${OPENROUTER_API_KEY}
+```
+
+**Шаг 4 — `openclaw.json`**
+
+```json
+{
+  "providers": {
+    "openrouter": {
+      "type": "openai-compatible",
+      "baseUrl": "https://openrouter.ai/api/v1",
+      "apiKey": "${OPENROUTER_API_KEY}",
+      "headers": {
+        "HTTP-Referer": "https://your-site.com",
+        "X-Title": "MyOpenClaw"
+      }
+    }
+  },
+  "agents": {
+    "list": [
+      {
+        "id": "main",
+        "model": "claude-opus-4-5"
+      },
+      {
+        "id": "asana-scout",
+        "model": "openrouter/qwen/qwen3-next-80b-a3b-instruct:free"
+      },
+      {
+        "id": "knowledge",
+        "model": "openrouter/meta-llama/llama-3.3-70b-instruct:free"
+      },
+      {
+        "id": "spawn-worker",
+        "model": "openrouter/openai/gpt-oss-120b:free"
+      }
+    ]
+  }
+}
+```
+
+Два хедера `HTTP-Referer` и `X-Title` — OpenRouter просит их указывать для идентификации приложения, иначе запросы могут депрайоритизироваться.
+
+**Шаг 5 — Перезапуск**
+
+```bash
+docker compose down && docker compose up -d
+docker exec openclaw openclaw status
+```
+
+---
+
+## Практический совет по лимитам для агентов
+
+20 RPM звучит много, но агентная цепочка может сделать 5-10 вызовов за один пользовательский запрос. При параллельных spawn-worker агентах лимит бьётся быстро.
+
+Добавь в `AGENTS.md` главного агента:
+
+```markdown
+## OpenRouter Rate Limit Awareness
+- Free tier: 20 req/min, 1000 req/day
+- Spawn workers sequentially, not in parallel, when using free OpenRouter models
+- If 429 received: wait 10s before retry, max 3 retries
+- Fallback model: openrouter/free (auto-selects available free model)
+```