> ## Documentation Index
> Fetch the complete documentation index at: https://docs.routify.ru/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenClaw

## Что такое OpenClaw?

[OpenClaw](https://openclaw.ai/) — персональный AI-ассистент, который работает локально на вашем компьютере (Mac, Windows, Linux). Он умеет автоматизировать задачи, управлять файлами, работать с почтой и календарём, а также поддерживает расширения и плагины.

OpenClaw совместим с OpenAI API, поэтому вы можете направить его на Routify и использовать любые модели из каталога через единый шлюз.

## Настройка

### Шаг 1: получите API-ключ Routify

1. Зарегистрируйтесь или войдите на [routify.ru](https://routify.ru/auth)
2. Создайте новый API-ключ
3. Скопируйте ключ (начинается с `sk-...`)

### Шаг 2: добавьте провайдер в конфигурацию OpenClaw

Откройте файл `~/.openclaw/openclaw.json` и добавьте Routify как кастомный провайдер:

```json5 theme={null}
{
  env: { ROUTIFY_API_KEY: "sk-..." },
  models: {
    mode: "merge",
    providers: {
      routify: {
        baseUrl: "https://api.routify.ru/v1",
        apiKey: "${ROUTIFY_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "openai/gpt-5.4",
            name: "GPT-5.4",
            reasoning: false,
            input: ["text"],
            contextWindow: 1000000,
            maxTokens: 32000
          },
          {
            id: "anthropic/claude-sonnet-4-6",
            name: "Claude Sonnet 4.6",
            reasoning: false,
            input: ["text"],
            contextWindow: 200000,
            maxTokens: 16000
          },
          {
            id: "google/gemini-2.5-pro",
            name: "Gemini 2.5 Pro",
            reasoning: true,
            input: ["text"],
            contextWindow: 1000000,
            maxTokens: 65536
          }
        ]
      }
    }
  },
  agents: {
    defaults: {
      model: { primary: "routify/openai/gpt-5.4" }
    }
  }
}
```

<Note>
  Ключ API хранится в поле `env` и подставляется через `${ROUTIFY_API_KEY}`. Не вставляйте ключ напрямую в `apiKey`.
</Note>

### Шаг 3: выберите модель по умолчанию

В секции `agents.defaults.model.primary` укажите модель в формате `routify/<model-id>`:

```json5 theme={null}
agents: {
  defaults: {
    model: { primary: "routify/openai/gpt-5.4" }
  }
}
```

Популярные модели для OpenClaw:

| Модель            | ID                            | Описание                  |
| ----------------- | ----------------------------- | ------------------------- |
| GPT-5.4           | `openai/gpt-5.4`              | Флагманская модель OpenAI |
| GPT-5.4 Mini      | `openai/gpt-5.4-mini`         | Быстрая и экономичная     |
| Claude Sonnet 4.6 | `anthropic/claude-sonnet-4-6` | Сильная модель Anthropic  |
| Gemini 2.5 Pro    | `google/gemini-2.5-pro`       | Модель Google с reasoning |

Полный список моделей — на [routify.ru/models](https://routify.ru/models).

### Шаг 4: запустите OpenClaw

```bash theme={null}
openclaw
```

OpenClaw будет отправлять запросы через Routify.

## Добавление моделей

Чтобы добавить новую модель, добавьте объект в массив `models` вашего провайдера `routify`:

```json5 theme={null}
{
  id: "deepseek/deepseek-r1",
  name: "DeepSeek R1",
  reasoning: true,
  input: ["text"],
  contextWindow: 131072,
  maxTokens: 32000
}
```

Основные поля:

| Поле            | Описание                                                                 |
| --------------- | ------------------------------------------------------------------------ |
| `id`            | ID модели из каталога Routify                                            |
| `name`          | Отображаемое название                                                    |
| `reasoning`     | `true` для моделей с reasoning (o-серия, DeepSeek R1, Gemini с thinking) |
| `input`         | Типы входных данных: `["text"]` или `["text", "image"]`                  |
| `contextWindow` | Размер контекстного окна                                                 |
| `maxTokens`     | Максимум выходных токенов                                                |

## Надёжность и failover

Routify автоматически маршрутизирует запросы между провайдерами. Если провайдер недоступен, запрос переключается на другой без изменений в конфигурации OpenClaw.

## Частые ошибки

### Ошибки аутентификации (401/403)

**Решение:**

1. Проверьте валидность ключа на [routify.ru/settings](https://routify.ru/settings)
2. Убедитесь, что на балансе есть средства
3. Проверьте, что ключ не отозван

### Модель не найдена (404)

**Решение:**

1. Проверьте ID модели в [каталоге Routify](https://routify.ru/models)
2. Убедитесь, что используете формат `<provider>/<model>` (например, `openai/gpt-5.4`)
3. Проверьте, что модель добавлена в массив `models` провайдера в конфигурации OpenClaw

## Ресурсы

* [OpenClaw](https://openclaw.ai/)
* [Документация OpenClaw](https://docs.openclaw.ai/)
* [Модели Routify](https://routify.ru/models)
* [Routify API](https://api.routify.ru)