Making AI Assistants Cheap Again

中文 | English

RT-Claw is an OpenClaw-inspired intelligent assistant for embedded devices. Multi-RTOS support via OSAL. Build swarm intelligence with networked nodes. ESP32-S3 WiFi support adapted from MimiClaw.

Deploy your own AI assistant on hardware that costs just one dollar — seamlessly integrated into your daily workflow, efficiently bridging the digital and physical worlds.

Getting Started · Usage · Architecture · Porting · Tuning · Contributing

Feature	Description	Status
LLM Chat Engine	Interactive conversation with LLM API over HTTP	Done
Tool Use	LLM-driven function calling to interact with hardware and services; 30+ built-in tools	Done
Skills	Composable multi-tool workflows; AI can create, persist, and execute skills that orchestrate multiple tools	Done
Conversation Memory	Short-term RAM ring buffer + long-term NVS Flash persistent storage; AI can save/delete/list memories	Done
Swarm Intelligence	Node discovery, heartbeat, capability bitmap, remote tool invocation across nodes	Done
Scheduled Tasks	Timer-driven task execution and periodic automation; AI can create/list/remove tasks	Done
Chat-first Shell	UART REPL with insert-mode editing, tab completion, UTF-8; direct input goes to AI, /commands for system	Done
OSAL	Write once, run on FreeRTOS and RT-Thread with zero code changes	Done
Gateway	Thread-safe message routing between services	Done
Networking	Ethernet (QEMU) and WiFi (real hardware); HTTP client for API calls	Done
IM Integrations	Feishu (Lark) via WebSocket long connection; planned: DingTalk, QQ, Telegram	In Progress
Web Flash & Serial	Browser-based firmware flash (esptool-js) and serial terminal with ANSI color rendering	Done
Multi-Model API	Support mainstream LLM APIs: Claude, GPT, Gemini, DeepSeek, GLM, MiniMax, Grok, Moonshot, Baichuan, Qwen, Doubao, Llama (Ollama)	Planned
Web Config Portal	Lightweight built-in web page for configuring API keys, selecting models, and tuning parameters at runtime	Planned
Claw Skill Provider	Serve as a skill for other Claws, giving them the ability to sense and control the physical world	Planned

+--------------------------------------------------------------+
|                     rt-claw Application                      |
|    gateway | net | swarm | ai_engine | shell | sched | im    |
+--------------------------------------------------------------+
|                      skills (AI Skills)                      |
|             (one skill composes multiple tools)              |
+--------------------------------------------------------------+
|                       tools (Tool Use)                       |
| gpio | system | lcd | audio | http | scheduler | memory      |
+--------------------------------------------------------------+
|                    drivers (Hardware BSP)                    |
| WiFi | ES8311 | SSD1306 | serial | LCD framebuffer           |
+--------------------------------------------------------------+
|                  osal/claw_os.h (OSAL API)                   |
+-------------------+------------------------------------------+
| FreeRTOS (IDF)    |                RT-Thread                 |
+-------------------+------------------------------------------+
| ESP32-C3 / S3     |             QEMU vexpress-a9             |
+-------------------+------------------------------------------+

Platform	Target	RTOS	Build	Status
ESP32-C3	QEMU, xiaozhi-xmini, generic devkit	ESP-IDF + FreeRTOS	Meson + CMake	Verified
ESP32-S3	QEMU, real hardware	ESP-IDF + FreeRTOS	Meson + CMake	Verified
vexpress-a9	QEMU	RT-Thread	Meson + SCons	Verified

# 1. Install ESP-IDF + QEMU (one-line setup)
./scripts/setup-esp-env.sh

# 2. Set your API key
export RTCLAW_AI_API_KEY='<your-api-key>'

# 3. Build and run on QEMU
make build-esp32c3-qemu
make run-esp32c3-qemu

No hardware? No problem. Try the CNB Cloud IDE — all toolchains pre-installed, build and run in your browser.

For real hardware (ESP32-S3/C3), WiFi setup, Feishu bot, and more — see the Getting Started Guide.

Join the GTOC (Gevico Open-Source Community) channels:

• Discord: RT-Claw
• QQ Group: Join
• Telegram: GTOC Channel
• Bilibili: Zevorn
• WeChat: GTOC

Inspired by OpenClaw, Nanobot, and MimiClaw.

MIT