Ameba-Claw AI Agent Framework

Ameba-Claw AI Agent Framework

Build smart apps through conversation — runs entirely on-chip

Development Resources

Recommended ICs

Overview

Ameba-Claw is Realtek's AI Agent framework for Ameba SoC. It runs a complete ReAct Agent loop — sense, reason, act — directly on Ameba-RTOS, with no Linux, no external server required. Connect to Wi-Fi, configure an LLM API key, and interact with the agent over Telegram, Feishu, WeChat, QQ, or a local serial terminal.

Extend the agent's capabilities at runtime by writing Lua skills — no recompilation needed. GPIO, I2C, SPI, UART, IR, RTC, PWM, and audio peripherals are all scriptable from the IM chat or serial console.

LLM Providers	OpenAI, Anthropic, Alibaba Qwen, DeepSeek, or any OpenAI-compatible endpoint
IM Platforms	Telegram, Feishu, WeChat (iLink), QQ, built-in local WebIM
Language	C (runs on Ameba-RTOS, no Linux)
License	Apache 2.0

How It Works

When a user sends a message via Telegram, Feishu, WeChat, or a serial terminal, the chip receives it over Wi-Fi and constructs an inference context comprising long-term memory, session history, current timestamp, available tool definitions, and Lua skills, then issues an LLM API request. The model performs multi-step reasoning in a ReAct loop, invoking tools (GPIO, web search, Lua skills, file operations, etc.) until the task is complete, then returns the result to the originating message source. Context assembly, memory management, and tool execution all run locally on the chip, which communicates directly with the LLM API endpoint.

1. Receive

IM message or serial input arrives at the chip over Wi-Fi.

2. Reason

Chip assembles context (memory, history, tools) and calls the LLM API.

3. Act

LLM calls tools — GPIO, Lua skills, web search, file ops — looping until done.

4. Reply

Result is sent back to the IM or terminal. All on-chip, all private.

Core Features

Chat-to-Action

Send a message and the agent calls tools, runs Lua skills, and replies — all on-chip, no cloud gateway.

Lua Skills

Write and deploy Lua scripts at runtime over IM or serial. GPIO, I2C, SPI, UART, IR, RTC, PWM, audio — all scriptable without recompiling.

Structured Memory

User profile, session history, and long-term memory stored in local Flash. Private by design — nothing uploaded to the cloud.

MCP Support

Connect to external MCP servers, or expose the device's own capabilities as an MCP server to other agents.

Task Scheduling

The LLM can autonomously schedule recurring or one-shot tasks. Schedules persist across reboots.

Event-Driven

Any event — IM message, GPIO trigger, timer expiry — can launch the Agent loop. React to the physical world in real time.

Multi-Platform IM

One framework, many frontends: Telegram, Feishu, WeChat (iLink), QQ, and a local browser-based WebIM.

No Linux Required

Runs directly on Ameba-RTOS in pure C. The full ReAct loop fits on a single Ameba SoC with no Linux layer.

Hardware Peripherals

Built-in Lua modules cover GPIO, I2C, SPI, UART, IR, RTC, PWM, LCDC, ADC, thermal, touch, audio, USB UVC, and USB MSC.

System Architecture

Development Resources

Icon	Resource Name	Link
	Documentation	Link
	Online Flash Tool	Link
	GitHub	Link
	Contact Us	Link

Recommended ICs

Features	Filter	RTL8721Dx	RTL8720E	RTL8710E	RTL8726E	RTL8713E	RTL8730E	RTL8721F	RTL872xD	RTL8735B
Application Processor	Cortex-M Cortex-A	Cortex-M	Cortex-M	Cortex-M	Cortex-M	Cortex-M	Cortex-A	Cortex-M	Cortex-M	Cortex-M
DSP	Select
ISP?	Select
Arm TrustZone	Select
Dual Band?	Select
Wi-Fi 6	Select
R-MESH?	Select
Ultra-low Power	Select
Ethernet	Select
BT Dual Mode	Select
HMI?	Select
Audio ADC?	Select
Audio DAC?	Select
SDIO Host	Select
SD/EMMC Host	Select
USB	Select
BT Dedicated Antenna?	Select
CAN?	Select