AmebaClaw Web Console User Manual

AmebaClaw includes a built-in web management console. All operations — including network configuration, AI model configuration, messaging bot integration, and file management — can be performed through a browser.

When the device is not yet connected to a network (provisioning mode), connect your phone or computer to the device hotspot (AmebaClaw-XXXX, no password required), then open http://192.168.1.1.

When the device is connected to a network (normal mode), make sure your phone or computer is on the same network as the device, then open the device’s IP address in a browser (e.g., http://<device-IP-address>/).

Note

If you do not know the IP address assigned to the device, check the serial log or your router’s admin page.

Warning

The web console has access to all API keys you have configured. Connect the device only to trusted Wi-Fi networks. Do not connect to unknown Wi-Fi networks or expose the console port to the public internet, as this may lead to key leakage.

System Status

Displays the device’s current operating state:

Metric

Description

Wi-Fi Status

Shows SSID and IP address when configured

SoftAP Status

Whether the hotspot is active and its IP

Operating Mode

normal (normal mode) / provisioning (provisioning mode)

Firmware Version

Version number of the currently flashed firmware

Heap Memory

Current free memory / historical low-water mark

Operations:

  • Refresh — Manually fetch the latest status.

  • Restart Device — Requires confirmation; after restarting, automatically waits for the network to reconnect and refreshes the page.

Real-Time Chat

Communicate with the AI assistant running on the device in real time via WebSocket.

How to use:

  1. Once the connection status at the top of the page shows “Connected” (green), you can send messages.

  2. Type in the input box at the bottom. Press Enter to send; Shift + Enter for a new line.

  3. If the connection drops, the page automatically reconnects (maximum interval: 8 seconds).

Note

AI replies depend on the interface configured in LLM Configuration. The feature will not work if no LLM is configured.

Network Configuration

Configure the device’s Wi-Fi connection.

Field descriptions:

  • Wi-Fi Name (SSID) — The name of the wireless network to connect to.

  • Password — Leave blank for open networks. Click the eye icon on the right to toggle password visibility.

Steps:

  1. Enter the SSID and password, then click Connect.

  2. The page polls the connection status every 2 seconds (up to approximately 2 minutes).

  3. When the connection succeeds, the page displays the IP address assigned on the target Wi-Fi network and provides a link to navigate there.

Note

  • If you switch to a different Wi-Fi network, the device IP will change and you will need to access the console using the new IP.

  • The SoftAP hotspot and Wi-Fi connection can operate simultaneously (MCC mode). After provisioning completes and the device restarts, the hotspot will be disabled.

LLM Configuration

Configure the AI large language model access parameters.

Quick Select Provider

Click the corresponding button to auto-fill that provider’s API endpoint and recommended model:

Button

Provider

Recommended Model

Deepseek

DeepSeek

deepseek-v4-flash

Alibaba Qwen

Alibaba Cloud Model Studio

qwen-plus

OpenAI

OpenAI

gpt-5.5

Anthropic

Anthropic

claude-sonnet-4-6

Custom

Any compatible API endpoint

Enter manually

Basic Configuration

  • API Key — The key provided by the service provider. Click the eye icon to view in plaintext.

  • Model ID — The model name, e.g. deepseek-v4-flash.

Advanced Settings (click to expand)

Field

Default

Description

API Endpoint

Pre-filled per provider

LLM API endpoint URL

Auth Method

Bearer Token

Select “Anthropic” for the Anthropic API endpoint

Max Tokens

16384

Maximum tokens per reply

Max Iterations

50

Maximum tool-call rounds for the Agent

Enable Thinking Mode

Off

When enabled, the model performs chain-of-thought reasoning (supported by select models)

Enable Streaming Output

Off

When enabled, replies appear word by word

Context Compression Trigger Tokens

110000

Context is automatically compressed when this token count is exceeded

Context Window Limit Tokens

128000

Maximum context length supported by the model

Click Save Configuration when done.

Messaging Bot Configuration

Connect messaging bots to various IM platforms so the device can send and receive messages through those channels. Each platform is an independent collapsible card and does not affect the others.

WeChat

Log in to a WeChat account via QR code so the device can receive and send WeChat messages.

Steps:

  1. Enter the iLink URL (typically https://ilinkai.weixin.qq.com).

  2. Click Generate QR Code and wait for the code to appear.

  3. Scan the QR code with the WeChat app to authorize.

  4. Once the status shows Logged In, the configuration is active.

  • WeChat Bot Token — Filled in automatically after scanning. Can also be entered manually if scanning is not possible.

Click Save WeChat after the token is filled in (automatically or manually).

Feishu

Create an application on the Feishu Open Platform and obtain credentials.

  • App ID — The unique identifier for the Feishu application. Leave blank to disable the Feishu bot.

  • App Secret — The Feishu application secret.

Click Save Feishu after filling in the fields. The badge on the right changes to Configured to confirm the save was successful.

Telegram

Create a bot via @BotFather and obtain a token.

  • Bot Token — Format: 123456789:AAF.... Leave blank to disable.

Click Save Telegram after filling in the field.

QQ Bot

Register an application on the QQ Open Platform and obtain credentials.

  • AppID — The QQ bot application ID. Leave blank to disable.

  • AppSecret — The QQ bot secret.

Click Save QQ after filling in the fields.

Note

Saving with all fields blank disables the bot for that platform.

Search Configuration

Configure web search capability for the AI assistant using the Tavily Search API.

  • Tavily API Key — Obtain by registering an account at Tavily. Leave blank to disable search.

  • Results Per Search — Number of results returned per search query (1–5, default 3).

Click Save Configuration after filling in the fields.

Task Management

View and control scheduled tasks (Capabilities) running on the device.

Table column descriptions:

  • Task Name — The unique identifier for the task.

  • Schedule / Interval — Cron expression or trigger interval.

  • Status — Green Running / Gray Stopped.

  • Actions — Click the button to enable or disable the task.

Click Refresh to update the list.

Lua Module Management

Control which driver modules are available for Lua scripts on the device.

Driver Module List

Module

Function

Disableable

audio

Microphone (DMIC) audio input

✓

uart

UART serial communication

✓

i2c

I²C bus

✓

spi

SPI bus

✓

rtc

Real-time clock

✓

timer

Timer

✓

file

File system access

✓

wifi

Wi-Fi management

✓

gpio

GPIO pin control

✓

sys

System utilities

Locked (core)

event

Event bus

Locked (core)

cap

Capability calls

Locked (core)

Steps:

  1. Toggle the switch next to each module (modules labeled “Locked” cannot be modified).

  2. Click Save Configuration.

  3. Restart the device as prompted for changes to take effect.

Note

Disabling a module will cause Lua scripts that depend on it to stop working.

File Management

Browse, upload, download, and edit files on the device file system.

Storage Areas

Switch between storage areas using the dropdown at the top:

  • vfs: — User storage area; read/write access.

  • rolfs: — Read-only storage area; can only be browsed and downloaded.

File Operations

Operation

Method

Enter directory

Click the directory name

Go up

Click the ↑ Parent button

Upload file

Click Upload and select a local file

New folder

Click New Folder, enter a name, and confirm

Download file

Click the Download button on a file row

Download directory

Click the Download button on a directory row (automatically packaged as ZIP)

Edit file

Click the Edit button on a file row, modify, and save (read-only areas are view-only)

Delete file/directory

Click the Delete button (disabled in read-only areas)

Note

  • The online editor supports text files up to 32 KB. For larger files, download them, edit locally, then re-upload.

  • Deleting a directory recursively removes all its contents. Confirm before proceeding.

  • Incorrectly deleting or modifying essential files may cause system instability. Proceed with caution.

Memory Management

Manage the AI assistant’s identity definitions and long-term memory.

Memory Files

The device stores 4 Markdown configuration files that directly influence the AI’s behavior and persona:

File

Purpose

AGENTS.md

Agent base identity definition (tool-call capabilities, scope of responsibilities, etc.)

SOUL.md

System persona definition (communication style, values, etc.)

USER.md

Cross-session user profile (user preferences, historical information, etc.)

IDENTITY.md

Persona identifier (name, self-perception, etc.)

Each file has its own text editor. Click the corresponding Save button after editing to apply changes immediately (no restart required).

Long-Term Memory

The table displays structured memory entries accumulated by the AI during conversations:

  • Content — The specific content of the memory.

  • Tag — The classification tag for the memory.

  • Source — The origin of the memory.

  • Timestamp — When the memory was created.

Operations:

  • Edit — Click the edit button on a memory entry to modify its content and tag, then save.

  • Delete — Click the delete button and confirm to remove a memory entry.

  • Refresh — Reload all memory files and entries.

Session Management

Click Session Management in the sidebar to access the unified cross-channel session management page.

Sessions are grouped by channel (e.g. telegram:12345678, wechat:u_abc). Each group shows all session aliases under that channel; the currently active session is highlighted in blue.

Available operations:

  • View History — Click the “View History” button on a session row to open a modal showing the full conversation history for that session (user messages and AI replies displayed in turn).

  • Delete — Click the “Delete” button and confirm to permanently remove a session and its history.

Note

To create, switch, or rename sessions during a conversation, use slash commands (e.g. /new, /resume) in the respective messaging channel. The web console session management page currently supports viewing and deleting only. See Session Management for details.

Additional Notes

  • All configuration changes take effect immediately after saving (except Lua modules), no restart required.

  • If the console is inaccessible, first check the device network status via serial port or by connecting to the SoftAP hotspot.