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

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

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

---

Ошибка 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 (выключить)

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

---

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

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

Что делать:

Добавь в SOUL.md:

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

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