Merge pull request #124 from zevorn/codex/agent-skills-support
Making AI Assistants Cheap Again
中文 | English
RT-Claw is an OpenClaw-inspired intelligent assistant for embedded devices. Multi-OS support via OSAL (FreeRTOS, RT-Thread, Zephyr and Linux). 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, RT-Thread, Zephyr and Linux 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) WebSocket + Telegram HTTP long polling; planned: DingTalk, QQ | Done |
| Web Flash & Serial | Browser-based firmware flash (esptool-js) and serial terminal with ANSI color rendering | Done |
| Multi-Model API | Claude native API + OpenAI-compatible format (GPT, DeepSeek, GLM, MiniMax, Grok, Moonshot, Baichuan, Qwen, Doubao, Llama/Ollama); auto-detect by model name | Done |
| 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) |FreeRTOS(std) | RT-Thread | Zephyr | Linux |
+--------------+--------------+------------+----------+----------+
| ESP32-C3/S3 | Zynq-A9 QEMU |vexpress-a9 | QEMU A9 | Native |
+--------------+--------------+------------+----------+----------+
| Platform | Target | OS | Build | Status |
|---|---|---|---|---|
| ESP32-C3 | QEMU, xiaozhi-xmini, generic devkit | FreeRTOS (ESP-IDF) | Meson + CMake | Verified |
| ESP32-S3 | QEMU, real hardware | FreeRTOS (ESP-IDF) | Meson + CMake | Verified |
| Zynq-A9 | QEMU | FreeRTOS (standalone) | Meson (full firmware) | Verified |
| vexpress-a9 | QEMU | RT-Thread | Meson + SCons | Verified |
| Zephyr Cortex-A9 | QEMU (qemu_cortex_a9) | Zephyr v4.4.0 | CMake + Ninja | Verified |
| Zephyr Cortex-M3 | QEMU (qemu_cortex_m3) | Zephyr v4.4.0 | CMake + Ninja | Verified |
| Linux | Native (x86_64, aarch64) | Linux (pthreads) | Meson | 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
About
35/F,Tencent Building,Kejizhongyi Avenue,Nanshan District,Shenzhen
