Теперь вся картина чёткая. Разбираю детально.

---

## Условия 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)
```