Решение проблем

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

Собрали ошибки, на которых чаще всего застревают участники. Если твоей нет — напиши в чат поддержки.

---

Ошибка 401 — Invalid bearer token

HTTP 401: authentication_error: Invalid bearer tokenКопировать

Самая частая ошибка. Означает, что API-ключ невалидный или повреждён при копировании.

Причины и решения

1. Лишний пробел или перенос строки в ключе (90% случаев)

При копировании из терминала в конце ключа часто добавляется невидимый символ.

# Проверь ключ — скопируй в текстовый редактор и убедись:
# - Нет пробелов в начале и конце
# - Нет переноса строки
# - Ключ начинается с sk-ant-Копировать

Как исправить:

1. Скопируй ключ → вставь в Заметки (Notes) или любой текстовый редактор
2. Удали пробелы и переносы в начале и конце
3. Скопируй чистый ключ и вставь в конфиг

2. Неправильный тип ключа

• ✅ Нужен: Platform API key (начинается с sk-ant-api03-...)
• ❌ Не подходит: Workspace key, OAuth token, старый формат ключа

Где взять правильный ключ: console.anthropic.com/settings/keys

3. Ключ отозван или истёк

• Зайди в Console → API Keys → проверь, что ключ активен
• Если неуверен — создай новый ключ и замени

4. Конфликт переменных окружения

# Проверь, нет ли старого ключа в env:
echo $ANTHROPIC_API_KEY

# Если есть — убери:
unset ANTHROPIC_API_KEYКопировать

5. Выбрана модель, которой нет в твоём плане

Если в конфиге указана модель, к которой у тебя нет доступа (например, Opus на плане Pro) — Anthropic вернёт 401.

Как исправить:

1. Проверь свой план: console.anthropic.com
2. Убери модель, которой нет в плане, из конфига
3. Если не помнишь что менял — сбрось настройки и настрой заново

План	Доступные модели
Pro ($20)	Sonnet, Haiku
Max ($100)	Opus, Sonnet, Haiku
API	Любые (по балансу и tier)

6. Для Claude Code (OAuth)

Если используешь Claude Code с подпиской (Pro/Max) без API-ключа:

# Перелогинься:
claude /login

# Если не помогает — сбрось авторизацию:
rm -rf ~/.claude
claude /loginКопировать

💡 Быстрая проверка: вставь ключ в терминал и проверь длину — правильный ключ ~108 символов, без пробелов.

---

Ошибка 403 — Forbidden

Чаще всего связана с VPN. Особенно у тех, кто в России на Windows.

Что делать:

1. Проверь, что VPN включён и подключён к серверу в США или Европе
2. Смени сервер VPN на другую страну
3. Перезапусти VPN-клиент
4. Проверь IP — он не должен быть российским
5. Если ничего не помогает — попробуй другой VPN-провайдер

Также проверь:

• Ключ должен быть Platform API key, не Workspace
• На аккаунте должен быть положительный баланс

---

Rate limit / AI service overloaded

Модель перегружена или ты отправляешь слишком много запросов.

Что делать:

1. Подожди 1–2 минуты и попробуй снова
2. Проверь свой tier на console.anthropic.com — чем выше tier, тем больше лимит
3. Если используешь OpenClaw — увеличь интервал heartbeat в конфиге
4. Если ошибка постоянная — возможно, исчерпан дневной лимит подписки

💡 На Claude Pro ($20/мес) лимиты ниже, чем на MAX ($100/мес). Если упираешься часто — подумай о повышении плана.

---

Connection timeout при установке

Не получается скачать OpenClaw или зависимости.

Что делать:

1. Попробуй установить через GitHub напрямую:

git clone https://github.com/openclaw/openclaw.git
cd openclaw
npm installКопировать

2. Или скачай архив через браузер с GitHub
3. Проверь интернет-соединение (VPN может замедлять npm)

---

Heartbeat timeout

Агент потерял связь с gateway.

Что делать:

openclaw gateway restartКопировать

Если повторяется — проверь логи:

openclaw logs --followКопировать

---

Gateway не запускается — порт занят

Предыдущий процесс не завершился.

Что делать:

openclaw gateway --port 18789 --forceКопировать

Флаг --force завершит старый процесс и запустит новый.

---

Claude не видит файлы Конструктора

Открыл Claude Code, но он не находит скиллы и агентов.

Что делать:

1. Убедись, что открыл папку с Конструктором, а не отдельный файл
2. В VS Code: File → Open Folder → выбери корневую папку конструктора
3. В приложении Claude: перетащи папку в окно и дай полный доступ к файлам

---

Bot Privacy в BotFather — бот не видит сообщения

Бот подключён, но не отвечает в группах.

Что делать:

1. Открой @BotFather в Telegram
2. /mybots → выбери бота → Bot Settings → Group Privacy
3. Turn off (выключить)

После этого бот начнёт видеть сообщения в группах.

---

openclaw doctor —fix перезаписал конфиг

После запуска openclaw doctor --fix бот перестал работать — пропал токен, модель или другие настройки.

Что произошло:

Doctor проверяет конфиг и может его перезаписать — удалить ваши настройки (botToken, model, allowFrom) и заменить их своей структурой.

Как проверить:

cat ~/.openclaw/openclaw.jsonКопировать

Если в файле нет вашего botToken или agents.defaults.model — doctor их удалил.

Как исправить:

nano ~/.openclaw/openclaw.jsonКопировать

Верните пропавшие поля. Минимум нужны:

"agents": {
  "defaults": {
    "model": "anthropic/claude-opus-4-6"
  }
},
"channels": {
  "telegram": {
    "enabled": true,
    "botToken": "ВАШ_ТОКЕН_ОТ_BOTFATHER",
    "dmPolicy": "allowlist",
    "allowFrom": ["ВАШ_TELEGRAM_USER_ID"]
  }
}Копировать

Сохраните и перезапустите:

systemctl --user restart openclaw-gateway.serviceКопировать

Как избежать:

Запускайте doctor --fix до заполнения конфига, а не после. Правильный порядок: openclaw setup → openclaw doctor --fix → заполняете конфиг → перезапуск.

---

Бот не отвечает — dmPolicy

Gateway запущен, но бот молчит в Telegram.

Частая причина: dmPolicy имеет неправильное значение.

Допустимые значения dmPolicy:

• "allowlist" — отвечает только тем, чей ID указан в allowFrom (рекомендуем)
• "pairing" — требует ручного одобрения при первом сообщении
• "open" — отвечает всем
• "disabled" — не отвечает в личке

Любое другое значение (например "deny") роняет gateway. Бот просто перестаёт работать.

Как исправить:

nano ~/.openclaw/openclaw.jsonКопировать

Найдите dmPolicy и поставьте "allowlist". Убедитесь что allowFrom содержит ваш ID:

"dmPolicy": "allowlist",
"allowFrom": ["52074536"],Копировать

Перезапустите:

systemctl --user restart openclaw-gateway.serviceКопировать

---

Агент плохо пишет по-русски

Ответы на английском или кривой русский.

Что делать:

Добавь в SOUL.md:

Всегда отвечай на русском языке. Используй простой разговорный русский.Копировать

Или выбери модель с хорошим русским — подробнее в гайде по моделям.

---

Нет связи между агентами — pairing required / operator.write

Координатор не может отправить задачу другим агентам. В логах:

missing scope: operator.write
missing scope: operator.pairing
pairing required

Причина: При установке устройство получило только scope operator.read, а для межагентной связи нужны operator.write и operator.pairing.

Решение: Выполни на сервере:

export OPENCLAW_GATEWAY_TOKEN="ваш_токен"
openclaw onboard --mode local --accept-risk --non-interactive
openclaw gateway restart

Токен gateway можно найти так:

cat ~/.openclaw/openclaw.json | grep -A2 '"auth"'

После onboard устройство получит все scopes и связь заработает.

---

Rate limit при межагентной связи (бесплатные модели)

Координатор пытается делегировать задачу, но получает 429 rate limit и начинает делать всё сам.

Причина: Бесплатные модели (Qwen, Gemma) на OpenRouter имеют жёсткие лимиты. Межагентная связь = 2+ запроса (координатор + целевой агент), лимит исчерпывается мгновенно.

Решение:

• Вариант 1: Пополни баланс OpenRouter хотя бы на $5 — rate limit снимается
• Вариант 2: Пиши каждому агенту напрямую в его бот, минуя координатора — 1 запрос = 1 агент