An open API service indexing awesome lists of open source software.

https://github.com/zevorn/rt-claw

Making AI Assistants Cheap Again!
https://github.com/zevorn/rt-claw

ai assistant cheap clawdbot ironclaw openclaw picoclaw

Last synced: 2 months ago
JSON representation

Making AI Assistants Cheap Again!

Awesome Lists containing this project

README

          


RT-Claw


Making AI Assistants Cheap Again


Discord
QQ Group
Telegram
Bilibili
MIT License

中文 | English

**RT-Claw** is an [OpenClaw](https://github.com/openclaw/openclaw)-inspired intelligent assistant for embedded devices.
Multi-OS support via OSAL (FreeRTOS, RT-Thread, Linux). Build swarm intelligence with networked nodes.
ESP32-S3 WiFi support adapted from [MimiClaw](https://github.com/memovai/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.


RT-Claw Demo — AI drawing on LCD via Tool Use

[Getting Started](docs/en/getting-started.md) · [Usage](docs/en/usage.md) · [Architecture](docs/en/architecture.md) · [Porting](docs/en/porting.md) · [Tuning](docs/en/tuning.md) · [Contributing](docs/en/contributing.md)

## Features

| 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 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 |

## Architecture

```
+----------------------------------------------------------------+
| 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(standalone) | RT-Thread | Linux |
+----------------+----------------------+--------------+---------+
| ESP32-C3 / S3 | QEMU Zynq-A9 (GEM) | vexpress-a9 | Native |
+----------------+----------------------+--------------+---------+
```

## Supported Platforms

| 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 |
| Linux | Native (x86_64, aarch64) | Linux (pthreads) | Meson | Verified |

## Quick Start

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

# 2. Set your API key
export RTCLAW_AI_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](https://cnb.cool/gevico.online/rtclaw/rt-claw) — 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](docs/en/getting-started.md)**.

## Community

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

- **Discord**: [RT-Claw](https://discord.gg/gcxwYXQr)
- **QQ Group**: [Join](https://qm.qq.com/q/heSPPC9De8)
- **Telegram**: [GTOC Channel](https://t.me/gevico_channel)
- **Bilibili**: [Zevorn](https://space.bilibili.com/483048140)
- **WeChat**: [GTOC](https://mp.weixin.qq.com/s/PhTZKjk4FO0iVveBB9OvSQ)

## Acknowledgments

Inspired by [OpenClaw](https://github.com/openclaw/openclaw), [Nanobot](https://github.com/HKUDS/nanobot), and [MimiClaw](https://github.com/memovai/mimiclaw).

## License

MIT