🚀 Интеграция OpenClaw / Clawdbot с пользовательскими моделями CodingPlanX

Это руководство проведет вас через установку Clawdbot (OpenClaw) и настройку пользовательского прокси API, что позволит гибко вызывать такие модели, как GPT-4o, Claude 3.5 и Gemini.

---

🛠️ Шаг 1: Подготовка среды и инициализация

Перед началом убедитесь, что в вашей системе установлен Node.js.

1. Глобальная установка Clawdbot

Откройте терминал (CMD или PowerShell) и выполните следующую команду:

npm i -g clawdbot

2. Запуск мастера инициализации

Запустите мастер установки для завершения базовой настройки. Следуйте подсказкам на экране:

clawdbot onboard

[!IMPORTANT] Примечание для пользователей Windows: В нативной среде Windows, если система сообщает, что openclaw не распознается как внутренняя или внешняя команда, пожалуйста, убедитесь, что вы используете команду clawdbot.

---

⚙️ Шаг 2: Изменение основного файла конфигурации clawdbot.json

На этом шаге мы изменим основной конфигурационный файл, чтобы задать адрес прокси API и сопоставления моделей.

Путь к файлу: C:\Users\your-username\.clawdbot\clawdbot.json (Примечание: В оригинальном руководстве использовалось 'Administrator'. Замените это на ваше реальное имя пользователя в системе)

Измените разделы agents, auth и models в файле на основе следующего примера:

{
  "agents": {
    "defaults": {
      "workspace": "C:\\Users\\your-username\\clawd",
      "models": {
        "api-proxy-gpt/gpt-4o": { "alias": "GPT-4o" },
        "api-proxy-claude/claude-sonnet-4-5-20250929": { "alias": "Claude Sonnet 4.5" },
        "api-proxy-google/gemini-3-pro-preview": { "alias": "Gemini 3 Pro" }
      },
      "model": {
        "primary": "api-proxy-claude/claude-sonnet-4-5-20250929"
      }
    }
  },
  "auth": {
    "profiles": {
      "api-proxy-gpt:default": { "provider": "api-proxy-gpt", "mode": "api_key" },
      "api-proxy-claude:default": { "provider": "api-proxy-claude", "mode": "api_key" },
      "api-proxy-google:default": { "provider": "api-proxy-google", "mode": "api_key" }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "api-proxy-gpt": {
        "baseUrl": "https://api.codingplanx.ai/v1",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-4o", "name": "GPT-4o", "contextWindow": 128000, "maxTokens": 8192 }
        ]
      },
      "api-proxy-claude": {
        "baseUrl": "https://api.codingplanx.ai",
        "api": "anthropic-messages",
        "models": [
          { "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5", "contextWindow": 200000, "maxTokens": 8192 }
        ]
      },
      "api-proxy-google": {
        "baseUrl": "https://api.codingplanx.ai/v1beta",
        "api": "google-generative-ai",
        "models": [
          { "id": "gemini-3-pro-preview", "name": "Gemini 3 Pro", "contextWindow": 2000000, "maxTokens": 8192 }
        ]
      }
    }
  }
}

---

🔑 Шаг 3: Настройка файла аутентификации auth-profiles.json

На этом шаге вам нужно ввести реальные API-ключи, полученные от прокси-платформы.

Путь к файлу: C:\Users\your-username\.clawdbot\agents\main\agent\auth-profiles.json

Обновите поля key вашими собственными учетными данными API:

{
  "version": 1,
  "profiles": {
    "api-proxy-gpt:default": {
      "type": "api_key",
      "provider": "api-proxy-gpt",
      "key": "sk-your-real-gpt-key"
    },
    "api-proxy-claude:default": {
      "type": "api_key",
      "provider": "api-proxy-claude",
      "key": "sk-your-real-claude-key"
    },
    "api-proxy-google:default": {
      "type": "api_key",
      "provider": "api-proxy-google",
      "key": "sk-your-real-google-key"
    }
  },
  "lastGood": {
    "api-proxy-gpt": "api-proxy-gpt:default",
    "api-proxy-claude": "api-proxy-claude:default",
    "api-proxy-google": "api-proxy-google:default"
  }
}

---

🚦 Шаг 4: Проверка и запуск сервиса

После настройки проверьте и запустите сервис, выполнив следующие шаги.

1. Проверка работоспособности

Проверьте, правильно ли работают синтаксис вашей конфигурации и сетевое подключение:

clawdbot doctor

2. Запуск сервиса шлюза (Gateway)

Запустите сервис шлюза, чтобы включить ИИ-прокси:

clawdbot gateway

3. Доступ к веб-консоли

1. Откройте браузер и перейдите по адресу: http://127.0.0.1:18789/
2. Учетные данные для входа: Используйте Токен, выведенный в конце шага clawdbot onboard, для входа в систему.
3. Теперь вы готовы настроить и использовать вашего ИИ-агента!

---

💡 Совет: Если вы когда-нибудь смените провайдера прокси, просто обновите baseUrl в clawdbot.json и key в auth-profiles.json.