一颗指甲大的 Wi-Fi 芯片你跟它说一句话它自己写出程序跑了起来它看得懂摄像头里的现场自己决定怎么应对它把灯点亮、把电机转起来它还记得住你的习惯越用越懂你。一个会自己写代码、自己动手的完整AIAgent——Ameba-Claw。本文包含以下部分Ameba-Claw 是什么四个Demo实践Ameba-Claw 的硬件配置本地记忆可编辑持久化初次部署 Ameba-Claw 配置步骤Ameba-Claw 是什么如果说 OpenClaw等开源项目让人们看到了 AI 在 PC 与服务器端通过对话调度工具、处理复杂任务的能力那么 Ameba-Claw就是将这套“自然语言即编程”的理念从数字世界带入真实的物理IoT世界。Ameba-Claw 是一套为微型芯片打造的端侧智能体框架感知、决策、执行、记忆的整套Agent闭环都在芯片本地跑通。它可以在设备运行时生成新的功能并不断扩展能力不再是只执行预设固件。当这种能力进入 IoT 场景时会发生什么你对搭载 Ameba-Claw 的设备说一句“准备看电影。”Agent 会即刻理解这句日常聊天在端侧自主推演并通过 MCP 与多个设备协同工作自动调暗氛围灯、降下幕布并顺手将空调设为适宜的 24度。场景只是开始。面对视觉处理、网络通信与 UI 渲染它能力又如何实 践以下四个实践均未预置业务代码现场生成并运行。同一块硬件可以在不同场景下切换身份——监控终端、自动化控制器、交互式信息看板均可重新定义。Demo 1 · 视觉实践USB摄像头LCD动态监控Realtek 芯片强大的 USB Host 能力直驱标准 USB UVC 摄像头无需额外视觉处理单元。 它可以拍照、本地存储并调用多模态模型理解图像能直接回答“图里发生了什么”。比如你想做一个能够自动识别画面变化的监控终端。设备每 5 秒抓拍与上一帧对比在屏幕上标出新增、移动与未变化物体并给出变化提示。瑞昱Ameba-Claw 实践USB摄像头LCD监控这一演示完整串起了“USB Host驱动 UVC 摄像头 → 按需调用多模态模型 → LCDC 实时渲染显示”的端到端链路。原本需要专用视觉模组才能完成的监控任务现在一颗Wi-Fi芯片加上标准摄像头就够了。换个场景你还能直接问它门口是人还是动物设备面板上哪个指示灯亮了柜门有没有关严Demo 2 · 零烧录自组网局域网语音对讲机Ameba-Claw 原生接入了微信、QQ、Telegram、WebIM多端消息统一进入 Agent 循环处理。你在微信里发“做一个对讲机启动接收...”两台完全没有写过业务代码的开发板在运行中生成代码自动通过 UDP 广播实现局域网自组网驱动 DMIC 捕获麦克风音频驱动 I2S 通过扬声器输出音频。几秒后对讲机通了。瑞昱Ameba-Claw实践局域网对讲机无论是视频监控还是局域网对讲机核心都在于 Ameba-Claw 能够将自然语言转化为 Lua 脚本并运行。Demo 3 · 零代码软硬件交互LVGL HMI 图形控制面板当你说需要一个带界面的硬件中控Ameba-Claw 自动调用芯片的 LCDC 与 LVGL 图形库。不仅在屏幕上画出“LED Studio”控制面板还能通过UI控件直接控制底层硬件——手指拖动屏幕上的滑块灯光实时灵敏变色。瑞昱Ameba-Claw实践LVGL HMI 图形控制面板从UI渲染到SPI硬件控制全程由 Agent 在运行时完成零代码实现软硬件交互。Demo 4 · 全UI应用自适应渲染2048游戏除了控制类应用Ameba-Claw 也可以承载完整的图形化应用逻辑。它自主读取屏幕分辨率在端侧反算出精确的留白和棋盘边距确保在不同分辨率屏幕上正常显示 UI 界面包括方块滑动、数字合并、过渡动画以及完整的游戏逻辑。瑞昱Ameba-Claw实践2048游戏UI渲染硬件底座RTL8721FAmeba-Claw 方案的优势得益于 RTL8721F 在硬件层面的配置。端侧 Agent 需要什么足够的内存承载上下文足够的存储记录长期记忆丰富的外设去连接传感器和执行器以及稳定的无线连接。全场景网络标配双频 Wi-Fi 62.4G/5G5GHz 频段保障复杂环境中的实时响应。同时支持以太网与 BLE 5.0三路网络按需并行提升连接稳定性。运行内存高速DQ16 PSRAM承载更大的系统提示词、记忆摘要与多轮对话历史。加速复杂 GUI 图形显示。存储扩展支持NOR 或者 NAND Flash、SD卡为长期记忆、图片与日志提供充足空间。显示输出内置LCDC 硬件控制器 MJPEG 解码 PPE 图形引擎UI 和监控画面直接显示不额外占用算力。外部扩展USB 2.0 HS 主从双模式直连 UVC 摄像头、U 盘等标准外设即插即用。这些不是锦上添花的配置而是 Agent 能够在端侧发挥作用的必要条件。本地记忆可编辑、持久化为了让行为可持续演进Ameba-Claw将长期配置与关键信息保存在本地FlashSOUL.md定义设备的人格与行为红线如“你是一个冷柜维护专家”USER.md记录偏好与特殊权限MEMORY.md自动沉淀设备专属的、结构化的长期记忆摘要SKILL.md支持标准的 Skill 格式规范通过 YAML 头按需加载不同的 Skill开发者可直接编辑这些文件它们会作为Agent的长期上下文参与推理并为Skill提供可持久化的配置与约束。数据不上云支持数据硬件加密和安全运行环境隐私可控。三分钟上手开箱即跑Ameba-Claw 完全开源代码、文档与在线烧录工具均已就位开箱即跑。准备工作在开始之前请确认你已准备好以下内容。硬件Realtek Ameba 开发板RTL8721FUSB 数据线用于连接开发板与电脑请确认数据线支持数据传输而非仅充电Wi-Fi 网络2.4 GHz 频段能够访问互联网大模型 API KeyAmeba-Claw 支持任意 OpenAI 兼容接口或 Anthropic 兼容接口的大语言模型服务。以下是几家常用服务商的 API Key 申请入口DeepSeek 开放平台阿里云百炼OpenAI PlatformAnthropic Console申请完成后记录以下两项信息在 LLM 配置时使用API Key服务商分配的鉴权密钥Model ID模型名称例如deepseek-v4-flash消息机器人(可选)微信如需通过微信机器人与 Agent 对话只需在 Web 后台扫码绑定即可。如果使用飞书、QQ 或 Telegram需要到对应开放平台申请 AppIDAppSecret 或 Token。小技巧如果你只是想快速体验可以先跳过此步骤。Web 后台内置的 WebIM 可以直接与大模型对话。第一步烧录固件与配网Ameba-Claw 固件通过在线烧录页面烧写到开发板无需安装任何软件Wi-Fi 配网通过串口发送 AT 命令完成。打开在线烧录页面在 Chrome 或 Edge 浏览器中打开 Ameba-Claw 在线烧录页面。连接开发板将 USB 数据线插入开发板的 USB 口另一端连接电脑。选择固件和设备在选择应用区域依次选择平台和应用固件在选择设备区域选中开发板型号。点击烧录点击开始烧录按钮在弹出的串口列表中选择对应的 COM 口并确认。工具将自动完成固件烧录约 12 分钟期间请勿断开连接或关闭页面。连接控制台烧录完成后滚动到页面底部的控制台区域点击连接控制台按钮选择对应的 COM 口并确认。发送 Wi-Fi 配置命令控制台连接成功后在输入框中输入以下命令将SSID和PASSWORD替换为实际 Wi-Fi 名称和密码然后按回车发送ATWLCONNssid,SSID,pw,PASSWORD确认联网成功控制台日志中出现以下内容即代表连接成功STA connected (DHCP), IP设备 IP在浏览器地址栏输入该 IP 即可访问 Web 后台。小技巧记下开发板的 IP 地址后续可直接在浏览器地址栏输入访问 Web 后台。第二步配置 LLM在浏览器地址栏输入开发板的 IP 地址即可访问 Web 后台。打开 Web 后台在与开发板处于同一 Wi-Fi 网络的设备上访问http://设备 IP。进入 LLM 配置在左侧导航栏中点击LLM 配置。选择服务商快速填入页面顶部提供了常见服务商的预设模板。点击对应服务商的图标如DeepSeek、OpenAI系统会自动填入对应的 API 地址和推荐模型名称。填写 API Key在API Key输入框中粘贴你的密钥。保存配置第三步开始对话配置完成后你可以通过以下方式与 Agent 对话。方式一WebIM推荐初次体验WebIM 是 Web 后台内置的实时对话界面无需任何额外配置。在 Web 后台左侧导航栏点击实时对话在底部输入框中输入消息按回车或点击发送方式二微信机器人微信无需申请 Token通过扫码即可绑定是最简单的 IM 接入方式在 Web 后台点击IMBOT 配置→微信→生成二维码页面显示二维码用微信扫码完成绑定绑定成功后向机器人发送消息即可开始对话首次对话建议可以先试试以下这些句子感受 Agent 的基本能力介绍一下你自己现在几点了你能做什么帮我列一下今天的待办清单小技巧Agent 支持多轮对话并具备长期记忆能力。你告诉它的信息如你的名字、偏好语言会被记录在vfs:/USER.md中下次对话时依然有效。恭喜你完成了 Ameba-Claw 的初次部署资源获取开源源码直达 GitHub 仓库GitHub - Ameba-AIoT/ameba-claw · GitHub开发指南与在线烧录复制以下地址至浏览器查阅使用指南aiot.realmcu.com/zh/latest/ameba_claw/index.html在线烧录aiot.realmcu.com/zh/resource/web_flash_tool.html-End-