Groki Bot MCP
Шлюз для настольного робота на M5Stack CoreS3: голос, слово пробуждения и MCP-сервер, через который агент заставляет его говорить
- 212 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Звук с микрофона робота отправляется на внешний голосовой сервис, Gemini Live или Grok, а без модели слова пробуждения передается весь
- Дополнительные голосовые инструменты, в том числе управление Mac и `ask_claude`, дают голосу доступ к компьютеру, они включаются отдельными настройками
Установка
- Работает в
Ручная установка
git clone https://github.com/JosssphZhou/groki-bot.git && cd groki-bot/gateway && uv sync --all-extrasУстановка шлюза из репозитория, затем `cp .env.example .env` и настройка `.env`. Сначала нужно прошить робота через веб-прошивальщик в Chrome или Edge.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Звук с микрофона робота отправляется на внешний голосовой сервис, Gemini Live или Grok, а без модели слова пробуждения передается весь
- Дополнительные голосовые инструменты, в том числе управление Mac и `ask_claude`, дают голосу доступ к компьютеру, они включаются отдельными настройками
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Groki Bot — настольный робот на M5Stack CoreS3 с основанием Stack-chan, у которого в одном репозитории лежат прошивка, шлюз для компьютера и связка с агентами Grok Bot. Для агента важен шлюз: небольшая Python-служба `stackchan-mcp`, которая работает на вашем компьютере и дает роботу голосовой интеллект. Шлюз ведет голосовой разговор через Gemini Live по умолчанию или через вход Grok, а слово пробуждения «Hi Grok» распознает локально, поэтому звук уходит на выбранный голосовой сервис только после обращения. На Mac с камерой робот поворачивает голову за лицом. Как MCP-сервер шлюз открывает Claude Code, Claude Desktop и другим клиентам инструменты `speak` и `get_status`: агент может заставить робота произнести текст и узнать его состояние. Дополнительно включаются голосовое управление Mac, голосовой инструмент `ask_claude`, который передает сложные вопросы в CLI Claude, и передача задач агентам в приложении Grok Bot.
Для кого. Владельцам робота M5Stack CoreS3 с Stack-chan, которые хотят голосовое общение и возможность поручать роботу озвучивать ответы агента.
Подходит, если
- Робот собран, и нужно, чтобы он слушал слово пробуждения и отвечал голосом через Gemini Live
- Агент закончил долгую задачу, и результат надо озвучить через робота командой `speak`
- Нужны слежение головой за лицом и камера Mac: основная работа идет на компьютере рядом с роботом
- Сложные вопросы надо передавать голосом через робота в Claude CLI, а задачи агенту Grok Bot
Не подходит, если
- Робота нет: шлюз без платы M5Stack CoreS3 с Stack-chan бесполезен
- Нужны инструменты движения головы, подсветки и камеры через MCP: с этой прошивкой `move_head`, `set_led` и `take_photo` возвращают ошибку
- Компьютер и робот в разных сетях: нужен общий Wi-Fi или локальная сеть
- Только Windows: в README проверка проведена на Apple Silicon, Linux должен работать для голоса, управление Mac только для macOS
Пример запроса к агенту
Когда закончишь миграцию базы, скажи через робота голосом, что все готово и сколько таблиц изменено.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
GEMINI_API_KEYобязательная, секрет- Ключ Google AI Studio для голосового режима Gemini Live, он включен по умолчанию. Для входа Grok не нужен.
STACKCHAN_TOKENсекрет- Случайный секрет для устройства, например из `openssl rand -hex 16`. Рекомендуется, пустое значение допустимо только в доверенной сети.
STACKCHAN_VOICE_BACKEND- Голосовой бэкенд: по умолчанию Gemini, значение `gbot` включает вход Grok.
Ограничения
Со штатной прошивкой Groki Bot через MCP работают только `speak` и `get_status`: она сообщает `features.mcp=false`, поэтому `move_head`, `set_led`, `set_avatar` и `take_photo` возвращают ошибку. Нужны робот, общая сеть, `uv`, Git и библиотека Opus, а также ключ Google AI Studio для Gemini Live.
Вход Grok идет через внутренние интерфейсы приложения Grok Bot версии 0.71.2 и может сломаться после обновления. Лицензия прошивки BSL-1.0, у шлюза MIT.
Как отключить. Выполните `claude mcp remove groki` и остановите шлюз: если он запущен как служба, снимите задачу launchd или юнит systemd. Адрес сервера XiaoZhi в настройках робота можно вернуть на прежний через страницу настроек по Bluetooth.
Частые вопросы
Как подключить шлюз Groki Bot к Claude Code?
Из каталога `gateway` выполните `claude mcp add groki -- uv run --all-extras --directory "$(pwd)" stackchan-mcp`. Шлюз работает, пока открыт Claude Code. Для Claude Desktop в `claude_desktop_config.json` добавляют блок с командой `uv` и абсолютным путем к `gateway`.
Какие инструменты MCP работают с этой прошивкой?
`speak` для озвучивания текста и `get_status` для состояния робота. Остальные инструменты вроде `move_head`, `set_led`, `set_avatar` и `take_photo` с ней возвращают ошибку и работают только с прошивкой, поддерживающей инструменты устройства XiaoZhi.
Нужен ли ключ?
Для голосового режима по умолчанию нужен `GEMINI_API_KEY` из Google AI Studio. Вход Grok использует приложение Grok Bot на этом же Mac и отдельного ключа xAI не требует. `STACKCHAN_TOKEN` рекомендуется задать случайным значением.
Что отправляется в облако?
После слова пробуждения звук с микрофона уходит на выбранный голосовой сервис, Gemini Live или Grok. Без модели слова пробуждения на сервис уходит все, что слышит микрофон, пока робот подключен. Кадры камеры остаются на Mac и не сохраняются.
Чем Groki Bot отличается от mcp-server-for-xiaozhi?
mcp-server-for-xiaozhi передает инструменты Home Assistant голосовому агенту Xiaozhi. Groki Bot дает свой шлюз с голосом, словом пробуждения и слежением за лицом для конкретного робота, а Claude получает через MCP команды `speak` и `get_status`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыПодключает Claude Code, Cursor, Codex или OpenCode к Telegram, Slack и Discord: коллеги пишут боту, отвечает кодовый агент
CLI связывает события Claude Code и Cursor с настольным роботом: движения, выражения на экране и звонок после задачи
quackd подключает роботов к Claude Code и Claude Desktop по MCP: девять инструментов и исполнитель с белым списком
CLI для умного дома SwitchBot: устройства и сцены из терминала, MCP-сервер для Claude Code, Codex и Gemini CLI.
Интеграция Home Assistant, которая ставит GigaChat, YandexGPT или другую LLM за голосового ассистента умного дома
MCP-сервер в одном бинарнике на Go: больше 75 локальных инструментов для файлов, оболочки, браузера и календаря
Коротко о README
README коротко представляет робота и пять возможностей: родной голос на macOS, слово пробуждения, слежение за лицом, пятнадцать выражений глаз и прошивку одним нажатием из Chrome или Edge с обновлением по воздуху. Быстрый старт идет в четыре шага, затем список документов: оборудование, сборка, архитектура и устранение неполадок.