Учебный проект RDK X5 Magicbox: от нуля до демо

Этот каталог — практический учебник на русском языке для RDK X5 Magicbox (платформы Horizon/D-Robotics). Цель — провести читателя от распаковки, прошивки и подключения к сети до базовых периферийных устройств, демонстраций компьютерного зрения, голосовой цепочки с LLM и понимания того, как подключить OpenClaw к возможностям платы.

Распаковка и подготовка системы
Быстрый старт и базовая периферия
Демонстрации компьютерного зрения (бинокулярная глубина, жесты)
Локальная голосовая цепочка с LLM
Развёртывание OpenClaw на Magicbox и подключение
FAQ, известные проблемы и поиск неисправностей

1. Общее оглавление

2. Справочные реализации

В учебнике многократно упоминаются возможности официальных и открытых реализаций. В публичном каталоге не размещены полные репозитории зависимостей — читатель сам получает или устанавливает нужные компоненты по инструкциям из соответствующих глав.

hobot_stereonet
magicbox_gesture_interaction
magicbox_audio_io
magicbox_qwen_llm
openclaw
sherpa-onnx

Модель ASR для голосовой цепочки может требовать отдельной загрузки: одного лишь клонирования репозитория недостаточно, чтобы все крупные файлы оказались на месте. Основной путь установки OpenClaw в Linux — сначала openclaw@latest, затем openclaw onboard --install-daemon.

3. Официальные материалы (проверены)

Главная страница онлайн-документации: https://d-robotics.github.io/magicbox_doc/magicbox
Разделы:
- обзор продукта: https://d-robotics.github.io/magicbox_doc/magicbox
- быстрый старт: https://d-robotics.github.io/magicbox_doc/quickstart
- базовая периферия: https://d-robotics.github.io/magicbox_doc/basic-peripherals
- загрузка ресурсов: https://d-robotics.github.io/magicbox_doc/resource-download
- разработка алгоритмов: https://d-robotics.github.io/magicbox_doc/algorithm-development
- FAQ: https://d-robotics.github.io/magicbox_doc/faq
- известные проблемы: https://d-robotics.github.io/magicbox_doc/known_issues
- журнал изменений: https://d-robotics.github.io/magicbox_doc/changelog
- техническая поддержка: https://d-robotics.github.io/magicbox_doc/technical-support

4. Переработанный основной путь

Чтобы разумно встроить OpenClaw в учебник, текущий документ разделён на две линии возможностей:

Линия собственных возможностей Magicbox
- прошивка, сеть, базовая периферия, бинокулярное зрение, жесты, голос, LLM
Линия расширения платформы
- развёртывание OpenClaw Gateway на Magicbox
- подключение удалённых входов WebChat / Telegram / Feishu и др.
- точки стыковки с локальными ROS-действиями, подсветкой и голосовой цепочкой

Так не смешиваются «проверка возможностей от производителя» и «подключение через расширение платформы», и читателю проще понимать, где заканчивается заводская функция.

5. Что вы сможете сделать после прохождения

После прохождения и выполнения этого учебника вы должны уметь:

прошить Magicbox, подключить его к сети и войти по SSH;
проверить работу кнопок, подсветки, сервоприводов, бинокулярной камеры, жестов, голоса и LLM;
понимать ожидаемые результаты каждой демонстрации, типичные сбои и базовые способы отката;
понимать место стыковки OpenClaw Gateway с локальным ROS и сценарными действиями;
определять, какие файлы можно публиковать, а какие модели, кеши, журналы и временные файлы в репозиторий не попадают.

6. Локальные материалы

Исходный PDF учебника (китайская версия) в русское издание не входит
Локальная копия списка образов: assets/official_pages/rdk_x5_magicbox_images_index.html (остальные официальные страницы даны ссылками в главах)
Архив официальных изображений: assets/official_images/
Снимки реального устройства: assets/image-*.png

Keyboard shortcuts