RDK X5 Magicbox Tutorial Project (From 0 to Demo)

This directory contains a set of Chinese practice tutorials for RDK X5 Magicbox. The goal is to enable users to start from unpacking, flashing, and networking, then gradually implement basic peripherals, visual demos, voice, and LLM connections, and further understand how to integrate OpenClaw into the board capabilities.

1. Unpacking and system preparation
2. Quick start and basic peripherals
3. Visual Demo (binocular depth, gestures)
4. Local voice + LLM native integration
5. Deployment and integration of OpenClaw on Magicbox
6. FAQ/known issues/troubleshooting

1. Tutorial Outline

• README_01_Environment Preparation and Flashing.md
• README_02_Wired Network Port Connection and Login.md
• README_03_Quick Start and Basic Peripherals.md
• README_03_Quick Start and Basic Peripherals Supplementary Materials.md
• README_04_Algorithm Demo_Bilateral Vision and Gesture.md
• README_05_Algorithm Demo_Voice and LLM.md
• README_06_OpenClaw Deployment and Access.md
• README_07_Error Diagnosis and Release Recommendations.md
• README_08_SSH Command Execution and Whole Paste Instructions.md
• README_09_Feishi Control Entry.md
• README_10_Windows Host OpenClaw Voice Bridge and Home Assistant.md

2. Reference implementations to be understood

This tutorial will refer to the capabilities of the following official or open-source implementations multiple times. The complete dependency repositories will not be included in the public directory; readers need to obtain or install the corresponding components according to the chapter instructions.

• hobot_stereonet
• magicbox_gesture_interaction
• magicbox_audio_io
• magicbox_qwen_llm
• openclaw
• sherpa-onnx

The ASR models involved in the voice link may need to be prepared separately. It cannot be assumed that all large files are ready after cloning the repository. The main installation process for OpenClaw on Linux is to first install openclaw@latest, and then execute openclaw onboard --install-daemon.

3. Official Documentation Entry (verified)

• Online documentation homepage: https://d-robotics.github.io/magicbox_doc/magicbox
• Chapters:
  • Product overview: https://d-robotics.github.io/magicbox_doc/magicbox
  • Quick start guide: https://d-robotics.github.io/magicbox_doc/quickstart
  • Basic peripherals: https://d-robotics.github.io/magicbox_doc/basic-peripherals
  • Resource download: https://d-robotics.github.io/magicbox_doc/resource-download
  • Algorithm development: https://d-robotics.github.io/magicbox_doc/algorithm-development
  • FAQ: https://d-robotics.github.io/magicbox_doc/faq
  • Known issues: https://d-robotics.github.io/magicbox_doc/known_issues
  • Update logs: https://d-robotics.github.io/magicbox_doc/changelog
  • Technical support: https://d-robotics.github.io/magicbox_doc/technical-support

4. Reconstructed main line

To properly integrate OpenClaw into the tutorial, the current document is divided into two ability lines:

1. Magicbox 原生能力线
   • Flashing, networking, basic peripherals, dual eyes, gestures, voice, LLM
2. 平台扩展能力线
   • Deploy OpenClaw Gateway on Magicbox
   • Connect to remote entry points such as WebChat / Telegram / Feishu
   • Reserve bridge points for local ROS actions, lighting, and voice connections

This ensures that OpenClaw and the native ROS demo on the board are not mixed up, and readers can more clearly distinguish between “original capability verification” and “platform extension integration”.

5. What should be achieved after learning

After reading and completing this topic, the reader should be able to:

• Complete the flashing, networking, and SSH login of Magicbox;
• Pass the basic verification for buttons, lights, servos, dual eyes, gestures, voice, and LLM;
• Identify the expected phenomena, common failure scenarios, and basic rollback methods for each Demo;
• Understand the bridging role between OpenClaw Gateway and local ROS and script actions;
• Determine which files can be publicly submitted, and which models, caches, logs, and temporary outputs should not be included in the repository.

6. Local Data

• Local PDF: d_robotics_rdk_x5_magicbox_zh_v1.0.pdf
• Official page archives: assets/official_pages/
• Official image archives: assets/official_images/
• Real-life screenshots: assets/image-*.png