让 AI 助理触手可及

中文 | English

RT-Claw — 受 OpenClaw 启发，面向嵌入式设备的智能助手。 通过 OSAL 支持多 RTOS，以组网节点构建蜂群智能。 ESP32-S3 WiFi 支持参考了 MimiClaw。

仅需一美元的硬件成本，即可快速部署你的专属 AI 助理——无缝融入工作与生活，高效连接物理世界。

快速开始 · 使用指南 · 架构设计 · 移植与扩展 · 裁剪与优化 · 贡献指南

功能	描述	状态
LLM 对话引擎	通过 HTTP 调用 LLM API 进行交互式对话	已完成
Tool Use	LLM 驱动的函数调用，与硬件和服务交互；30+ 内置工具	已完成
技能系统	可组合的多工具工作流；AI 可创建、持久化并执行融合多个工具的技能	已完成
对话记忆	短期 RAM 环形缓冲 + 长期 NVS Flash 持久化存储；AI 可保存/删除/查询记忆	已完成
蜂群智能	节点发现、心跳检测、能力位图、跨节点远程工具调用	已完成
定时任务	定时触发任务执行与周期性自动化；AI 可创建/查看/删除任务	已完成
对话优先 Shell	UART 交互终端，支持插入模式编辑、Tab 补全、UTF-8；直接输入发送 AI 对话，/命令 执行系统操作	已完成
OSAL	一次编写，在 FreeRTOS 和 RT-Thread 上零修改运行	已完成
Gateway	服务间线程安全的消息路由	已完成
网络	以太网（QEMU）和 WiFi（真实硬件）；HTTP 客户端用于 API 调用	已完成
IM 集成	飞书（Lark）WebSocket 长连接；计划中：钉钉、QQ、Telegram	进行中
Web 刷写与串口	浏览器端固件刷写（esptool-js）+ 串口终端（ANSI 彩色渲染）	已完成
多模型 API	支持主流 LLM API：Claude、GPT、Gemini、DeepSeek、GLM（智谱）、MiniMax、Grok、Moonshot（Kimi）、百川、通义千问、豆包、Llama（Ollama）	计划中
Web 配置页面	内置轻量 Web 页面，支持在线配置 API Key、选择模型、调整参数	计划中
Claw 技能提供者	作为其他 Claw 的技能插件，赋予其感知和控制物理世界的能力	计划中

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

平台	运行目标	RTOS	构建系统	状态
ESP32-C3	QEMU、xiaozhi-xmini、generic devkit	ESP-IDF + FreeRTOS	Meson + CMake	已验证
ESP32-S3	QEMU、真实硬件	ESP-IDF + FreeRTOS	Meson + CMake	已验证
vexpress-a9	QEMU	RT-Thread	Meson + SCons	已验证

# 1. 一键安装 ESP-IDF + QEMU
./scripts/setup-esp-env.sh

# 2. 设置 API 密钥
export RTCLAW_AI_API_KEY='<你的 API 密钥>'

# 3. 编译并在 QEMU 上运行
make build-esp32c3-qemu
make run-esp32c3-qemu

没有硬件？没关系。 试试 CNB 云原生开发环境——所有工具链已预装，在浏览器中即可编译运行。

真实硬件（ESP32-S3/C3）、WiFi 配置、飞书机器人等详细步骤请参阅 快速开始指南。

加入 GTOC（格维开源社区）交流频道：

• Discord：RT-Claw
• QQ 群：加入
• Telegram：GTOC 频道
• Bilibili：绝对是泽文啦
• 微信：GTOC 微信公众号

受 OpenClaw、Nanobot 和 MimiClaw 启发。

MIT