中文 | English
Real-Time Claw — an OpenClaw-inspired intelligent assistant for embedded devices.
Multi-RTOS support via OSAL. Build swarm intelligence with networked nodes.
rt-claw brings intelligence from the cloud to the edge through low-cost embedded nodes and swarm networking. Each node can sense the world, collaborate with others, and execute control tasks in real time.
- LLM Chat Engine — interactive conversation with Claude API over HTTP
- Tool Use — LLM-driven hardware control (GPIO, system info) via function calling
- OSAL — write once, run on FreeRTOS and RT-Thread with zero code changes
- Gateway — thread-safe message routing between services
- Networking — Ethernet + HTTP client on ESP32-C3 QEMU; WiFi on real hardware
- Swarm (planned) — node discovery, heartbeat, task distribution
+---------------------------------------------------+
| rt-claw Application |
| gateway | swarm | net | ai_engine | tool_use |
+---------------------------------------------------+
| claw_os.h (OSAL API) |
+-----------------+---------------------------------+
| FreeRTOS (IDF) | RT-Thread |
+-----------------+---------------------------------+
| ESP32-C3 | QEMU vexpress-a9 |
| WiFi / BLE | Ethernet / UART |
+-----------------+---------------------------------+
| Platform | RTOS | Build System | Status |
|---|---|---|---|
| ESP32-C3 | ESP-IDF + FreeRTOS | CMake (idf.py) | Networking + AI working on QEMU |
| QEMU vexpress-a9 | RT-Thread | SCons | Boot verified |
# Prerequisites: ESP-IDF v5.x, Espressif QEMU
source $HOME/esp/esp-idf/export.sh
cd platform/esp32c3
idf.py set-target esp32c3
idf.py build
idf.py qemu monitor # QEMU
idf.py -p /dev/ttyUSB0 flash monitor # real hardware# Prerequisites: arm-none-eabi-gcc, qemu-system-arm, scons
cd platform/qemu-a9-rtthread
scons -j$(nproc)
../../tools/qemu-run.shrt-claw/
├── osal/ # OS Abstraction Layer
│ ├── include/claw_os.h # Unified RTOS API
│ ├── freertos/ # FreeRTOS implementation
│ └── rtthread/ # RT-Thread implementation
├── src/ # Platform-independent core
│ ├── claw_init.* # Boot entry point
│ ├── claw_config.h # Project configuration
│ ├── core/gateway.* # Message routing
│ ├── services/ai/ # LLM chat engine (Claude API)
│ ├── services/net/ # Network service
│ ├── services/swarm/ # Swarm intelligence
│ └── tools/ # Tool Use framework (GPIO, system)
├── platform/
│ ├── esp32c3/ # ESP-IDF project (CMake)
│ └── qemu-a9-rtthread/ # RT-Thread BSP (SCons)
├── vendor/
│ ├── freertos/ # FreeRTOS-Kernel (submodule)
│ └── rt-thread/ # RT-Thread (submodule)
├── docs/
│ ├── en/ # English documentation
│ └── zh/ # Chinese documentation
├── scripts/ # Code style & dev tools
└── tools/ # Build & launch scripts
MIT