Wi-Fi 配置

本章说明如何将烧录好固件的 AmebaClaw 开发板连接到 Wi-Fi 网络。提供以下几种方式：

  • 串口 AT 命令：通过串口发送 AT 命令完成配网。分两种接入方式：

    • 通过在线烧录页面内置控制台

    • 使用其他串口工具

  • SoftAP 配置：开发板作为 Wi-Fi 热点，通过 Web 后台完成配网。适合无法直接使用串口的场景，或需要重新配置网络时使用。

备注

AmebaClaw 仅支持 2.4 GHz Wi-Fi 频段，不支持 5 GHz。

串口 AT 命令配置

通过在线烧录页面控制台

在线烧录页面内置了串口控制台，烧录完成后可直接在同一页面发送 AT 命令完成配网，无需切换工具。

  1. 烧录完成后，滚动到在线烧录页面底部的 "控制台" 区域。

  2. 点击 "连接控制台" 按钮，在弹出的串口列表中选择对应的 COM 口并确认。

    小技巧

    建议选择与烧录时相同的 COM 口。

  3. 控制台状态变为 "已连接" 后，在输入框中输入以下命令，将 <SSID> 和 <PASSWORD> 替换为实际 Wi-Fi 名称和密码，然后按回车发送：

    AT+WLCONN=ssid,<SSID>,pw,<PASSWORD>

  4. 观察控制台日志。出现以下内容则表示连接成功：

    STA connected (DHCP), IP=<设备 IP>

  5. 在浏览器地址栏输入设备 IP（例如 http://192.168.1.100）即可访问 Web 后台。

    小技巧

    记下设备 IP，重新上电后仍可直接在浏览器输入该地址访问。

使用其他串口工具

如果使用 PuTTY、minicom、screen 或其他串口工具，步骤如下：

  1. 安装串口工具。常用选择：

    • Windows：PuTTY 或串口助手

    • Linux / macOS：minicom 或 screen

  2. 将开发板通过 USB 连接到电脑，确认对应的串口设备名称（Windows 为 COMx，Linux / macOS 为 /dev/ttyUSBx 或 /dev/tty.usbserial-xxx）。

  3. 打开串口工具，以 波特率 1500000、数据位 8、停止位 1、无奇偶校验进行连接。

  4. 在终端输入以下命令，将 <SSID> 和 <PASSWORD> 替换为实际值后按回车发送：

    AT+WLCONN=ssid,<SSID>,pw,<PASSWORD>

  5. 日志中出现以下内容则表示连接成功：

    STA connected (DHCP), IP=<设备 IP>

  6. 在浏览器地址栏输入设备 IP 即可访问 Web 后台。

警告

连接失败时，请依次排查：

  • SSID 大小写是否与路由器设置完全一致

  • Wi-Fi 密码是否正确

  • 路由器是否已开启 2.4 GHz 频段（AmebaClaw 仅支持 2.4 GHz，不支持 5 GHz）

  • 是否有其他程序占用了该串口

SoftAP 配置

当开发板无法连接到已知 Wi-Fi，或需要重新配置网络时，可使用 SoftAP 模式进行配网。

备注

固件烧录后首次启动时（无存储的 Wi-Fi 信息），开发板会自动进入 SoftAP 模式。 也可通过 AT 命令主动触发：发送 AT+CLAW=wifi,clear 可清除已保存的 Wi-Fi 配置并重启进入 SoftAP 模式。

配置步骤

  1. 开发板进入 SoftAP 模式后，用电脑或手机打开 Wi-Fi 列表，找到名为 AmebaClaw-XXXX 的热点（XXXX 为设备 MAC 地址后几位）并连接。

  2. 在浏览器地址栏输入 192.168.1.1，打开设备 Web 后台。

  3. 点击左侧导航栏中的 "网络配置"。

  4. 在 "Wi-Fi 名称" 输入框填写目标 Wi-Fi 的 SSID，在 "密码" 输入框填写密码，然后点击 "连接" 按钮。

  5. 等待连接完成。成功后，页面将显示设备已分配到的 IP 地址和访问链接。

  6. 将电脑或手机重新连接到目标局域网，点击页面上的链接，或在浏览器地址栏手动输入 IP 即可访问 Web 后台。

小技巧

AmebaClaw-XXXX 热点仅在配网期间有效，联网成功后设备将自动关闭热点并切换至目标 Wi-Fi。