ДокументацияOpenClaw

OpenClaw

OpenClaw — открытый персональный AI-ассистент. Он подключается к Zenvy как к кастомному OpenAI-compatible провайдеру.

Windows

На Windows рекомендуется WSL2. Нативная установка возможна, но стабильнее работает в Linux-окружении.

Что понадобится

API-ключ Zenvy вида sk-zenvy-... из раздела API-ключи.
Положительный баланс аккаунта.
Установленный OpenClaw (Node.js 22.19+ или 24).

Быстрый старт

Шаг 1. Установите OpenClaw

~/zenvy · zsh

npm install -g openclaw@latest

Проверьте установку:

~/zenvy · zsh

openclaw --version

При первом запуске можно пройти мастер настройки:

~/zenvy · zsh

openclaw onboard --install-daemon

Шаг 2. Настройте провайдера Zenvy

Откройте конфиг OpenClaw (~/.openclaw/openclaw.json) и добавьте Zenvy в провайдеры моделей:

~/zenvy · json

{
  "models": {
    "providers": {
      "zenvy": {
        "baseUrl": "https://api.zenvy.su/v1",
        "apiKey": "sk-zenvy-...",
        "api": "openai-completions",
        "models": [
          {
            "id": "claude-sonnet-4.6",
            "name": "Claude Sonnet via Zenvy"
          },
          {
            "id": "gpt-5.2",
            "name": "GPT via Zenvy"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "zenvy/claude-sonnet-4.6" }
    }
  }
}

В models[].id указывайте Zenvy ID из каталога моделей.

Шаг 3. Перезапустите OpenClaw

~/zenvy · zsh

openclaw gateway restart

Выбор модели

Для агентских сценариев берите модели с поддержкой tool calling (Claude, GPT, Gemini, DeepSeek).

В чате OpenClaw модель переключается командой:

~/zenvy · plain

/model zenvy/claude-sonnet-4.6

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

~/zenvy · zsh

curl https://api.zenvy.su/v1/chat/completions \
  -H "Authorization: Bearer sk-zenvy-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4.6",
    "messages": [{ "role": "user", "content": "Ответь одним словом: ok" }]
  }'

Устранение неполадок

Симптом	В чём проблема
`401 authentication_error`	В `apiKey` указан неверный ключ. Нужен ключ Zenvy `sk-zenvy-...`.
`402 billing_error`	На балансе Zenvy нет средств. Пополните баланс в личном кабинете.
`404 model_not_found`	`id` модели не совпадает с Zenvy ID. Проверьте список через `GET /v1/models`.
OpenClaw не видит провайдера	Конфиг содержит ошибку JSON или gateway не перезапущен. Выполните `openclaw gateway restart`.

Безопасность

Храните openclaw.json вне репозиториев.
Не коммитьте API-ключ в git.
Если ключ утёк, удалите его в кабинете Zenvy и создайте новый.