XuanShu APIXuanShu API

XuanShu API

Настройка OpenClaw

Подключите OpenClaw к XuanShu API через канал Anthropic (Claude) или OpenAI (Codex): установка одной командой, ручная установка, конфигурация, минимальный тест, откат и диагностика.

1. Подготовьте API Key

  1. Если аккаунта ещё нет, зарегистрируйтесь на /register.
  2. Создайте на /keys отдельный ключ только для OpenClaw; при необходимости задайте квоту, срок действия и ограничения доступа.
  3. Сразу сохраните полный ключ в надёжном месте: позже консоль может показывать только скрытое значение. Не помещайте его в репозиторий, снимок экрана или переписку.

2. Установка одной командой (рекомендуется)

После запуска скрипт попросит выбрать канал и вставить API Key, затем запишет ~/.openclaw/config.yml. Требуется sudo, и скрипт только записывает конфигурацию — саму OpenClaw он не устанавливает. Исходный код доступен по /install/openclaw.sh.

curl -fsSL https://www.xuanshuapi.com/install/openclaw.sh | sudo bash
Установка OpenClaw (скрипт её не устанавливает)Скрипт только записывает конфигурацию; выполните это до его запуска

3. Установите OpenClaw

  1. Установите через npm: 
    npm install -g openclaw
openclaw --version
  2. Имя npm-пакета — openclaw; пакета @openclaw/cli не существует.
  3. Выведенная версия означает успешную установку.

4. Выберите канал и запишите конфигурацию

Модели обновляются, актуальный список смотрите на /available-channels. Существующая конфигурация будет перезаписана — сделайте резервную копию заранее.

export ANTHROPIC_API_KEY="<YOUR_API_KEY>"
openclaw onboard --auth-choice custom-api-key \
  --custom-base-url https://www.xuanshuapi.com \
  --custom-api-key-env ANTHROPIC_API_KEY \
  --custom-compatibility anthropic \
  --custom-model claude-opus-4-6

5. Выполните минимальный тест

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

openclaw

6. Критерии успеха

OpenClaw запускается нормально и возвращает ответ модели; на /usage виден успешный запрос выбранной модели; отсутствуют 404, 401/403 и 429. Переходите к реальному проекту только после всех трёх проверок.

7. Откатите конфигурацию

Сохраните резервную копию файла конфигурации и очистите связанные переменные окружения в текущем терминале, затем откройте новый login shell.

mv ~/.openclaw/config.yml ~/.openclaw/config.yml.xuanshu-backup
unset ANTHROPIC_API_KEY ANTHROPIC_BASE_URL \
  OPENAI_API_KEY OPENAI_BASE_URL
exec "$SHELL" -l

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

Сначала запишите код статуса, время запроса, ID модели и запись на /usage. Перед передачей логов скройте полный ключ.

СимптомПроверкаРешение
404--custom-base-url канала Anthropic должен быть строго https://www.xuanshuapi.com (без /v1); канал Codex должен включать /v1.Исправьте --custom-base-url для нужного канала, повторите onboard и попробуйте снова.
401 / 403Убедитесь, что ключ в переменной окружения — это полный, неусечённый ключ и он не истёк и не отозван.Скопируйте или создайте новый ключ на /keys и снова экспортируйте переменную окружения.
Модель недоступнаС тем же ключом проверьте точный ID модели и текущую видимость на /available-channels.Повторите onboard с обновлённым --custom-model; если модель временно недоступна, выберите доступную модель того же протокола.
429Проверьте баланс, лимиты ключа и число параллельных запросов на /usage.Уменьшите параллелизм и дождитесь восстановления окна лимита; используйте ограниченный backoff только для 429.
Конфигурация не применяетсяУбедитесь, что запись попала в ~/.openclaw/config.yml и OpenClaw был перезапущен.Перезапустите OpenClaw; уже открытые сессии не перечитывают файл автоматически после записи скриптом.
Команда не найденаopenclaw не установлен, или глобальный каталог npm не в PATH.Сначала выполните npm install -g openclaw, затем откройте терминал заново.