Embodied Claude — воркфлоу
Проект для Claude Code с набором MCP-серверов и хуков: долгая память, потребности, социальный контекст, камера, голос и датчики
- 377 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- С дополнительными модулями агент получает доступ к камере, микрофону и публикациям, ответам и удалению постов в X.
- Хуки работают на каждом запросе и сигнале сердцебиения и могут запускать действия без отдельной просьбы пользователя.
Установка
- Работает в
Ручная установка
git clone https://github.com/lifemate-ai/embodied-claude.git
cd embodied-claude
./scripts/setup.sh --profile core --non-interactiveДля Linux, macOS и WSL2. На Windows вместо скрипта запускают `scripts\setup.cmd` с теми же флагами.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- С дополнительными модулями агент получает доступ к камере, микрофону и публикациям, ответам и удалению постов в X.
- Хуки работают на каждом запросе и сигнале сердцебиения и могут запускать действия без отдельной просьбы пользователя.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Embodied Claude превращает папку проекта Claude Code в постоянного компаньона, который помнит прошлые сессии. Базовый профиль ставит четыре MCP-сервера: долговременную память, систему потребностей, социальный контекст с людьми, отношениями и границами и ядро individual-kernel. Камера, ключи API и другое оборудование для него не нужны. Хуки в `.claude/` на каждом запросе, сигнале сердцебиения и результате инструмента собирают одно состояние агента и мира. Это состояние влияет на выбор воспоминаний, внимание, планирование и допуск действий. Авторы называют это архитектурой-кандидатом феноменального сознания и прямо пишут, что сознания она не доказывает. Дополнительные возможности подключаются флагами `scripts/setup.sh`: USB-камера или Tapo с поворотом и звуком, расшифровка через Whisper, речь через VOICEVOX, ElevenLabs или Atlas Cloud, поиск и публикации в X, температура и время хоста. Выбранные серверы попадают в `.mcp.json`, остальные в него не пишутся.
Для кого. Исследователям и энтузиастам, которые экспериментируют с постоянными ИИ-компаньонами на базе Claude Code с памятью, камерой и голосом.
Подходит, если
- Хочется, чтобы Claude помнил разговоры и договоренности между сессиями без ручных заметок.
- Есть домашняя камера Tapo, и агенту нужно видеть комнату и слышать звук.
- Агент должен отвечать голосом через локальный движок VOICEVOX.
- Интересно проверить, как общее состояние агента влияет на планирование и выбор действий.
Не подходит, если
- Нужна память для рабочего проекта с кодом, без компаньона и социальных сценариев.
- Агенту нельзя давать доступ к камере, микрофону или публикациям в X.
- Требуется готовое приложение без настройки окружения Python.
Пример запроса к агенту
Запомни, что мое проверочное слово lantern.Ограничения
Нужны Git, uv и Claude Code, uv сам ставит Python 3.13. Пока настройка не создала `.mcp.json`, хуки запрещают любую запись в сессии из корня репозитория. Скрипт настройки не ставит ffmpeg, VOICEVOX, драйверы и приложения производителей. Обычный `uv sync` удаляет ранее поставленные дополнительные пакеты, поэтому синхронизируют с нужными `--extra`. USB-камера в WSL2 требует проброса устройства, датчики температуры там обычно недоступны.
Как отключить. Закройте сессию и удалите папку репозитория вместе с `.mcp.json` и данными памяти. Отдельные серверы убирают, удалив их блоки из `.mcp.json`.
Частые вопросы
Как проверить, что Embodied Claude заработал?
Запустите `claude` в папке репозитория и выполните `/mcp`: должны быть подключены четыре базовых сервера. Затем попросите запомнить слово и в следующем ходе спросите его.
Нужна ли камера или ключи API?
Нет, базовый профиль работает без оборудования и ключей. Камера, голос и X добавляются флагами `scripts/setup.sh`.
Что делать, если сервер не подключился?
Запустите `./scripts/doctor.sh --live`. Он отделяет блокирующие ошибки от предупреждений об оборудовании и печатает исправление для каждой.
Где хранятся ключи и настройки?
В `.mcp.json` в корне проекта. Git этот файл игнорирует, на POSIX он пишется с правами `0600`. Чужой конфиг без флага `--force` не перезаписывается.
Работает ли проект под Windows?
Да, ядро и хуки поддержаны на Windows, Linux, macOS с Apple Silicon и WSL2. Для Windows используется `scripts\setup.cmd`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ВоркфлоуРабочая папка для Claude Code: хуки с локальной Ollama определяют тип проекта, подбирают скиллы и напоминают вести документацию
Плагин для Claude Code: агент помнит вас между сессиями, носит имя и характер и отвечает в мессенджерах.
MCP-сервер дает агенту память между сессиями, проектами и машинами: решения, тупики, предпочтения и накопленные навыки
Среда для Claude Code, которая держит контекст между сессиями через хуки, леджеры и передачи, оркеструет агентов и экономит токены
ClawMem дает Claude Code, OpenClaw и Hermes локальную память: поиск по заметкам, хуки сессии и MCP-сервер на 33 инструмента
Плагин Supermemory для Claude Code: долговременная память между сессиями с автоматическим поиском по подсказке, сохранением диалога и индексом кодовой базы
Коротко о README
README ведет от быстрого старта без оборудования к таблице дополнительных возможностей и поддержке платформ. Дальше идут схема работы хуков, карта пакетов репозитория и правила безопасного хранения настроек.