Настройка Mistral API для памяти агентов

🧠 Что это

Mistral API — бесплатный сервис для генерации embeddings, который мы используем как «память» для агентов Хомяка. Каждый агент сохраняет важные диалоги, факты о тебе и твоём проекте, а потом находит их через семантический поиск. Работает на бесплатном плане Mistral — для одного человека хватает с большим запасом.

Mistral нужен только для долговременной памяти агентов. Без него агенты тоже работают (краткосрочная память сессии остаётся), но не помнят факты между перезапусками. Если хочешь, чтобы координатор завтра помнил твою аудиторию, тон голоса и предыдущие посты — Mistral нужен.

Что нужно

Email для регистрации на console.mistral.ai
Установленные 5 агентов (см. гайд по установке)
5 минут времени

Карту привязывать не нужно — для embeddings достаточно бесплатного плана.

Шаг 1 — Регистрация на console.mistral.ai

Открой https://console.mistral.ai
Нажми Sign Up (или Sign In если уже есть аккаунт)
Зарегистрируйся через email или Google
Подтверди email — приходит ссылка в почту, кликаешь, попадаешь в консоль

Из России можно зайти без VPN — Mistral это французская компания, не блокируется.

Шаг 2 — Создание API-ключа

В консоли слева в меню найди раздел API Keys (или прямая ссылка console.mistral.ai/api-keys)
Нажми Create new key
Дай имя ключу — например hamster-agents-memory
Можно оставить без даты истечения (Never expires)
Нажми Create
Скопируй ключ сразу — он показывается только один раз. Формат: ... (длинная строка из букв и цифр)
Сохрани его в заметку рядом с другими токенами

⚠️ Если потерял ключ — не беда. Просто удали старый в консоли и создай новый. Mistral не показывает ключ повторно — это нормально для всех API-сервисов.

Шаг 3 — Проверка ключа

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

curl https://api.mistral.ai/v1/models \
  -H "Authorization: Bearer ТВОЙ_КЛЮЧ"

Должен вернуться JSON со списком доступных моделей. Если получаешь 401 Unauthorized — ключ скопирован неправильно или истёк, создай новый.

Шаг 4 — Подключение к агентам

Открой OpenClaw config на сервере, где установлены 5 агентов:

nano ~/.openclaw/openclaw.json

Найди секцию memory или embeddings (если её нет — добавь после блока agents):

"memory": {
  "provider": "mistral",
  "api_key": "ТВОЙ_КЛЮЧ_MISTRAL",
  "model": "mistral-embed"
}

Сохрани файл (Ctrl+O → Enter → Ctrl+X) и перезапусти OpenClaw:

openclaw gateway restart

Готово. Теперь все агенты пишут факты в долговременную память через Mistral embeddings.

Как это работает на практике

Сценарий 1: ты говоришь маркетологу: «Моя аудитория — частные инвесторы 30-45 лет, доход от 200к, увлекаются криптой». Маркетолог сохраняет этот факт в память через Mistral. Через неделю копирайтер пишет пост — он видит этот факт автоматически и адаптирует тон под нужную аудиторию.

Сценарий 2: ты несколько раз правишь стиль постов: «короче», «без воды», «больше эмоций». Координатор замечает паттерн и сохраняет в память «пользователь предпочитает короткие эмоциональные посты». Со временем агенты начинают писать сразу в твоём стиле, без правок.

Сценарий 3: ты добавил в фабрику дизайнера. Он смотрит память маркетолога и копирайтера → видит ЦА и тон голоса → делает обложки в нужной палитре без дополнительных вопросов.

Лимиты бесплатного плана Mistral

На бесплатном плане ты получаешь:

1 миллион токенов в день на embeddings (это сотни тысяч сохранённых фактов)
Без ограничений по количеству ключей
Без карты — Mistral не требует привязки платёжного метода для бесплатного плана

Для одного человека / одного блога этого хватает на годы вперёд. Лимит начинает поджимать только если ты обрабатываешь сотни больших документов в день.

Если Mistral не подошёл

Есть альтернативы, тоже поддерживаемые OpenClaw:

OpenAI embeddings — платные ($0.02 за миллион токенов), но если у тебя уже есть OpenAI ключ — можно использовать. Изменить в config "provider": "openai" и указать OPENAI_API_KEY.
Локальные embeddings через Ollama — полностью бесплатно и без интернета, но требует мощный сервер с GPU. Для большинства это overkill.

Mistral — золотая середина: бесплатно, без сервера, без VPN, без карты.

Проблемы?

Проблема	Решение
«Invalid API key» при тесте curl	Скопировал не весь ключ или скопировал лишний пробел. Сгенерируй новый и аккуратно вставь
Агенты не помнят факты между сессиями	Перезапусти gateway: `openclaw gateway restart`. Если не помогло — проверь логи: `journalctl -u openclaw-gateway -n 50`
«Rate limit exceeded»	На бесплатном плане лимит 1M токенов/день. Подожди час или переключись на OpenAI embeddings
Mistral console не открывается	Попробуй другой браузер или режим инкогнито. Если из РФ — Mistral не блокируется, проблем не должно быть
Не нашёл секцию memory в config	Открой гайд по установке 5 агентов — там описано где находится `openclaw.json` и как его править

По нестандартным вопросам — пиши в чат клуба.