快速开始

本指南帮助你快速完成 Ameba-Claw 的初次部署，体验在 Ameba 开发板上运行 AI Agent 的完整流程。 如果使用官方提供的在线固件 ，从烧录到 Wi-Fi、AI 模型、聊天渠道的全部配置，都可以在浏览器的在线烧录页面中一站式完成，无需安装任何软件，也无需手动敲 AT 命令。

如果需要运行自行编译的固件 ，请参阅本文末尾的 使用自定义固件 。

准备工作

在开始之前，请确认你已准备好以下内容。

硬件

  • Realtek Ameba 开发板：RTL8721F

  • USB 数据线：用于连接开发板与电脑

  • Wi-Fi 网络 ：用于访问互联网

大模型 API Key

Ameba-Claw 支持任意 OpenAI 兼容接口或 Anthropic 兼容接口的大语言模型服务。以下是几家常用服务商的 API Key 申请入口：

申请完成后，记录以下两项信息，在向导的 AI 模型步骤填入：

  • API Key：服务商分配的鉴权密钥

  • Model ID：模型名称，例如 deepseek-v4-flash

消息机器人

Ameba-Claw 支持微信、Telegram、飞书、QQ 等聊天渠道，可在向导的聊天渠道步骤配置：

  • 微信：无需申请任何凭证，向导最后一步扫码即可绑定。

  • Telegram / 飞书 / QQ：需要先到对应开放平台申请 Bot Token 或 AppID & AppSecret。

也可以先跳过此步骤，仅使用 Web 后台内置的 WebIM 直接与大模型对话。

一站式部署

在线烧录页面集成了引导向导：烧录完成后会自动带你依次完成 Wi-Fi、AI 模型、Web 搜索和聊天渠道的全部配置。整个过程通过 USB / LOGUART 串口在浏览器内完成，无需安装软件，也无需手动敲 AT 命令或另开设备后台。

第一步：烧录固件

  1. 打开在线烧录页面

    在 Chrome 或 Edge 浏览器中打开 Ameba-Claw 在线烧录页面。

  2. 连接开发板

    将 USB 数据线插入开发板的 USB 口，另一端连接电脑。

  3. 选择固件和设备

    保持 "使用在线固件" 模式，在 "选择应用" 区域依次选择平台和应用固件，在 "选择设备" 区域选中开发板型号。

  4. 点击烧录

    点击 "开始烧录" 按钮，在弹出的串口列表中选择对应的 COM 口并确认。工具将自动完成固件烧录，约 1～2 分钟，期间请勿断开连接或关闭页面。

第二步：跟随向导完成配置

烧录完成后，页面会自动进入 "配置 Ameba Claw" 向导，依次完成以下步骤：

  1. 连接 —— 点击 "选择 LOGUART 串口"，选中开发板的 LOGUART 串口。向导会自动复位设备并与其握手；若自动复位后仍无响应，按提示手动复位设备即可。

  2. 网络 —— 填写 Wi-Fi 名称（SSID）和密码，点击 "连接"，即时生效。

  3. 配置 —— 此步骤仅暂存，尚未下发到设备：

    • AI 模型：填写 API Key、模型名称、API URL，并选择鉴权方式（Open AI 兼容 或 Anthropic 兼容）。

    • Web 搜索（可选）：填写 Tavily API Key，让 AI 具备实时联网搜索能力；不需要可留空。

    • 聊天渠道：选择微信、Telegram、飞书或 QQ；除微信外需填写对应的 Bot 凭证。

  4. 应用 —— 向导一次性下发前面暂存的全部配置，设备只重启一次即全部生效。

  5. 完成 —— 让所选聊天渠道上线：微信扫码登录，其他机器人显示 "已配置" 即可开始对话。

第三步：开始对话

配置完成后，你可以通过以下方式与 Agent 对话。

方式一：聊天渠道

打开你在向导中绑定的聊天渠道（微信 / Telegram / 飞书 / QQ），向机器人发送消息即可开始对话。

方式二：WebIM

WebIM 是设备 Web 后台内置的实时对话界面。在与开发板处于同一 Wi-Fi 网络的设备上，于浏览器地址栏输入开发板的 IP 地址访问 Web 后台，点击左侧导航栏的实时对话，即可直接与大模型对话。完整功能说明请参阅 AmebaClaw Web 后台用户手册。 开发板的 IP 地址可在向导的网络步骤或串口日志中查看。建议记下该地址，后续可直接在浏览器访问 Web 后台。

首次对话建议

可以先试试以下这些句子，感受 Agent 的基本能力：

  • 介绍一下你自己

  • 现在几点了

  • 你能做什么

  • 帮我列一下今天的待办清单

Agent 支持多轮对话并具备长期记忆能力。你告诉它的信息（如你的名字、偏好语言）会被记录在 vfs:/USER.md 中，下次对话时依然有效。

使用自定义固件

在线固件为官方预编译版本、内容固定。若你修改了源码并自行编译，则不通过在线页面烧录，而是使用 ImageTool 或其他烧录工具，按下表的 Flash 布局将自己编译的固件写入开发板。

RTL8721F Flash 布局

分区

起始地址

大小

结束地址

用途

IMG_BOOT

0x08000000

0x40000

0x0803FFFF

Bootloader

IMG_APP_OTA1

0x08040000

0x340000

0x0837FFFF

应用固件（app.bin 烧此分区）

烧录完成后，Wi-Fi、AI 模型、聊天渠道等配置方式与在线固件相同：可通过设备 Web 后台（参阅 AmebaClaw Web 后台用户手册）或串口 AT 命令（参阅 AT 命令参考）完成。

下一步

恭喜你完成了 Ameba-Claw 的初次部署！以下资源可以帮助你进一步探索：

  • AmebaClaw Web 后台用户手册 —— 探索 Web 后台功能，包括网络配置、更多消息机器人集成、记忆管理、文件管理等

  • Skill 系统 —— 使用 Lua 为 Agent 编写自定义 Skill，无需重新编译固件

  • Lua 模块参考 —— Skill 脚本 Lua 模块参考

  • AT 命令参考 —— 完整 AT 命令参考，适合串口调试与自动化脚本