OpenClaw

Подключите OpenClaw к Mixen — оплата с баланса в рублях, агент-демон с каталогом из 100+ моделей через наш Anthropic-совместимый протокол.

OpenClaw — опенсорсный агент (MIT), который живёт на вашей машине демоном: ходит в проект через локальный gateway, отчитывается в Telegram, Discord или Slack, а управляется через openclaw CLI и веб-дашборд. Модели берёт у hosted- и локальных провайдеров — Mixen подключается как кастомный провайдер.

Установка

# macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash

# Windows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iex

Либо через npm (требуется Node 22.22.3+, 24.15+ или 25.9+):

npm install -g openclaw@latest --allow-scripts=openclaw

Первичный запуск с демоном:

openclaw onboard --install-daemon

Конфигурация

Основной конфиг — ~/.openclaw/openclaw.json (путь по умолчанию; переопределяется переменной OPENCLAW_CONFIG_PATH). Добавьте провайдера Mixen:

{
  models: {
    mode: "merge",
    providers: {
      mixen: {
        baseUrl: "https://api.mixen.ai",
        apiKey: "${MIXEN_API_KEY}",
        api: "anthropic-messages",
        models: [
          { id: "anthropic/claude-sonnet-5", name: "Claude Sonnet 5", reasoning: true },
          { id: "z-ai/glm-5.3-flash", name: "GLM 5.3 Flash", reasoning: true },
          { id: "z-ai/glm-5.3", name: "GLM 5.3", reasoning: true }
        ]
      }
    }
  },
  agents: {
    defaults: { model: { primary: "mixen/anthropic/claude-sonnet-5" } }
  }
}

Ключевые моменты:

api: "anthropic-messages" — протокол Anthropic Messages. Base URL — без /v1: клиент сам дописывает путь запроса. Альтернатива — "openai-completions" с baseUrl: "https://api.mixen.ai/v1", но вариант с Anthropic-протоколом даёт prompt caching из коробки. Если api не указан вовсе, провайдер с baseUrl считается openai-completions — поэтому поле лучше задавать явно.
models[] — модели, которые появятся у агента; id — ID Mixen, уходит в API как есть. Необязательные поля записи: reasoning (по умолчанию false), input (по умолчанию ["text"]; добавьте "image" для vision-моделей), maxTokens (по умолчанию 8192), contextWindow.
agents.defaults.model.primary — модель по умолчанию, формат <провайдер>/<id модели>; слэши внутри ID Mixen — это нормально.
${MIXEN_API_KEY} — подстановка переменной окружения, чтобы ключ не лежал в конфиге. Переменные OpenClaw разрешает в порядке: окружение процесса → ./.env → ~/.openclaw/.env → блок env в openclaw.json.
mode: "merge" — добавляет провайдера, не затирая встроенный каталог.

Ключ mxn-… выпускается в кабинете и кладётся в ~/.openclaw/.env:

MIXEN_API_KEY="ваш-api-ключ"

Запуск и управление

openclaw                  # терминальная сессия с агентом
openclaw gateway status   # состояние демона
openclaw dashboard        # веб-дашборд

Хелперы по конфигурации: openclaw configure и openclaw models auth login.

Проверка подключения

Ключ и баланс проверяются минимальным генерирующим запросом:

curl https://api.mixen.ai/v1/chat/completions \
  -H "Authorization: Bearer ваш-api-ключ" \
  -H "Content-Type: application/json" \
  -d '{"model":"z-ai/glm-5.3-flash","messages":[{"role":"user","content":"ping"}],"max_tokens":5}'

200 — ключ и баланс рабочие; 401 — ключ скопирован не целиком или это не API-ключ Mixen; 402 — на балансе нет средств. GET /v1/models ключ не проверяет — он отвечает и без него.

Выбор модели под задачу

Агент пересылает весь накопленный контекст на каждом ходу — цена входа определяет счёт. Цены — за 1M токенов, вход/выход; полные таблицы с кэш-колонками — в каталоге.

Задача	Модель	Вход / выход
Рутина: разбор доков, простые вопросы, черновики	GLM 5.3 Flash (`z-ai/glm-5.3-flash`)	8,4 / 27,9 ₽
Длинные задачи в знакомом контексте	GLM 5.3 (`z-ai/glm-5.3`)	156 / 490,2 ₽
Сложные многошаговые задачи	Claude Sonnet 5 (`anthropic/claude-sonnet-5`)	213,9 / 1069,5 ₽

Кэш и экономия агентных сессий

Демон с длинной историей — идеальный клиент для промпт-кэша: системный промпт, правила и прочитанные файлы повторяются от хода к ходу.

повторный контекст в течение 5 минут считается по ~10% цены входа (у claude-sonnet-5 — 21.4 ₽ за 1M вместо 213.9 ₽, у glm-5.3-flash — 1.7 ₽), и каждое попадание продлевает окно ещё на 5 минут;
пауза дольше 5 минут (например, ночной простой демона) обнуляет кэш — первый ход заплатит полную цену входа, дальше скидка снова накапливается;
не меняйте правила и системный промпт посреди активной задачи — это сбрасывает кэш;
лимит — 60 RPM на ключ.

Типичные проблемы

401 / Invalid API Key — ключ не виден процессу: проверьте ~/.openclaw/.env и порядок разрешения переменных (окружение процесса выигрывает у файлов).
Модели Mixen не в списке — у кастомного провайдера пикер показывает только то, что перечислено в его models[]; добавьте запись с нужным id.
Запросы уходят другому провайдеру — проверьте agents.defaults.model.primary: префикс должен быть mixen/….
Медленный эндпоинт / таймауты — у провайдера есть настройка timeoutSeconds в models.providers.<id>.