快速开始
本指南帮助你快速完成 Ameba-Claw 的初次部署，体验在 Ameba 开发板上运行 AI Agent 的完整流程。
准备工作
在开始之前，请确认你已准备好以下内容。
硬件
Realtek Ameba 开发板：RTL8721F
USB 数据线：用于连接开发板与电脑（请确认数据线支持数据传输，而非仅充电）
Wi-Fi 网络：2.4 GHz 频段，能够访问互联网
大模型 API Key
Ameba-Claw 支持任意 OpenAI 兼容接口或 Anthropic 兼容接口的大语言模型服务。以下是几家常用服务商的 API Key 申请入口：
申请完成后，记录以下两项信息，在 LLM 配置时使用：
API Key：服务商分配的鉴权密钥
Model ID：模型名称，例如
deepseek-v4-flash
消息机器人(可选)
微信：如需通过微信机器人与 Agent 对话，只需在 Web 后台扫码绑定即可。
如果使用飞书、QQ 或 Telegram，需要到对应开放平台申请 AppID&AppSecret 或 Token。
小技巧
如果你只是想快速体验，可以先跳过此步骤。Web 后台内置的 WebIM 可以直接与大模型对话。
第一步：烧录固件与配网
Ameba-Claw 固件通过在线烧录页面烧写到开发板，无需安装任何软件；Wi-Fi 配网通过串口发送 AT 命令完成。
烧录与配网步骤
打开在线烧录页面
在 Chrome 或 Edge 浏览器中打开 Ameba-Claw 在线烧录页面。
连接开发板
将 USB 数据线插入开发板的 USB 口，另一端连接电脑。
选择固件和设备
在 "选择应用" 区域依次选择平台和应用固件，在 "选择设备" 区域选中开发板型号。
点击烧录
点击 "开始烧录" 按钮，在弹出的串口列表中选择对应的 COM 口并确认。工具将自动完成固件烧录，约 1～2 分钟，期间请勿断开连接或关闭页面。
连接控制台
烧录完成后，滚动到页面底部的 "控制台" 区域，点击 "连接控制台" 按钮，选择对应的 COM 口并确认。
发送 Wi-Fi 配置命令
控制台连接成功后，在输入框中输入以下命令（将
<SSID>和<PASSWORD>替换为实际 Wi-Fi 名称和密码），然后按回车发送：AT+WLCONN=ssid,<SSID>,pw,<PASSWORD>
确认联网成功
控制台日志中出现以下内容即代表连接成功：
STA connected (DHCP), IP=<设备 IP>
在浏览器地址栏输入该 IP 即可访问 Web 后台。
小技巧
记下开发板的 IP 地址，后续可直接在浏览器地址栏输入访问 Web 后台。
第二步：配置 LLM
在浏览器地址栏输入开发板的 IP 地址即可访问 Web 后台。
备注
Web 后台的完整功能说明请参阅 AmebaClaw 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 的初次部署！以下资源可以帮助你进一步探索：
