Wi-Fi Configuration

This chapter explains how to connect your AmebaClaw board to a Wi-Fi network after flashing the firmware. The following methods are available:

Serial AT command: Send an AT command over the serial console. Two ways to

connect the serial port:
- Using the built-in console on the online flash page
- Using a third-party serial tool
SoftAP setup: The board acts as a Wi-Fi hotspot; configure the target network

through its built-in web console. Useful when a serial connection is not available, or when reconfiguring the network.

Note

AmebaClaw supports the 2.4 GHz Wi-Fi band only. 5 GHz networks are not supported.

Serial AT Command

Via the Online Flash Page Console

The online flash page has a built-in serial console. After flashing, you can send AT commands directly from the same page without switching tools.

After flashing, scroll down to the “Console” section at the bottom of the online

flash page.
Click the “Connect” button, then select the corresponding COM port from the serial

port dialog and confirm.

Tip

Select the same COM port used for flashing.
Once the console status shows “Connected”, type the following command in the input

box — replacing <SSID> and <PASSWORD> with your actual network name and password — and press Enter:
```
AT+WLCONN=ssid,<SSID>,pw,<PASSWORD>
```
Watch the console output. The following message indicates a successful connection:
```
STA connected (DHCP), IP=<device IP>
```
Enter the device IP in your browser address bar (e.g. http://192.168.1.100) to

open the web console.

Tip

Note down the IP address — you can reach the web console at any time by entering it in your browser, even after a reboot.

Via a Third-Party Serial Tool

If you prefer PuTTY, minicom, screen, or another serial tool:

Install a serial tool. Common choices:
- Windows: PuTTY or a serial assistant
- Linux / macOS: minicom or screen
Connect the board to your PC via USB and identify the serial port (COMx on

Windows, /dev/ttyUSBx or /dev/tty.usbserial-xxx on Linux / macOS).
Open the serial tool and connect with baud rate 1500000, 8 data bits, 1 stop bit,

no parity.
Send the following command, replacing <SSID> and <PASSWORD> with actual values:
```
AT+WLCONN=ssid,<SSID>,pw,<PASSWORD>
```
When the output contains the following, Wi-Fi is connected:
```
STA connected (DHCP), IP=<device IP>
```
Enter the device IP in your browser address bar to open the web console.

Warning

If the connection fails, check:

SSID capitalization matches the router settings exactly
Wi-Fi password is correct
Router has 2.4 GHz enabled (AmebaClaw does not support 5 GHz)
No other program is holding the serial port

SoftAP Setup

When the board cannot connect to a known network, or when you need to reconfigure the network, use SoftAP mode.

Note

On first boot after flashing (no Wi-Fi credentials stored), the board enters SoftAP mode automatically. You can also trigger it explicitly with the AT command AT+CLAW=wifi,clear (clears stored credentials and reboots into SoftAP mode).

Setup Steps

After the board enters SoftAP mode, open the Wi-Fi list on your PC or phone and

connect to the hotspot named AmebaClaw-XXXX (where XXXX is the last few digits of the device MAC address).
Open a browser and navigate to 192.168.1.1 to reach the device web console.
Click “Network Config” in the left navigation bar.
Enter the target Wi-Fi SSID in the “Wi-Fi Name” field and the password in the

“Password” field, then click “Connect”.
Wait for the connection to complete. Once successful, the page displays the device’s

IP address and a link to the web console.
Reconnect your PC or phone to the target network, then click the link on the page

or manually enter the IP in your browser address bar to open the web console.

Tip

The AmebaClaw-XXXX hotspot is only active during setup. Once connected to the target network, the board automatically closes the hotspot.