Skip to content

Web configuration

basic_demo starts a small HTTP server after Wi‑Fi is up, serves the config UI, and exposes JSON APIs. Implementation: application/basic_demo/main/config_http_server.c.

Your computer or phone must be on the same LAN as the board, or connected to the board-provided SoftAP hotspot (in basic_demo, default SSID is esp-claw-xxxx, where xxxx is derived from the device MAC address).

In the browser open: http://esp-claw.local/ or http://<device-ip>/

The page loads current settings automatically. The UI supports multi-language switching and displays Wi-Fi status, device IP, and other information.

The configuration page is divided into three tabs:

  • Configuration: System settings (Wi-Fi, LLM, IM, search, time zone, etc.)
  • Memory: Memory file management (long-term memory and profile memory)
  • File Manager: Filesystem management

The page provides an LLM Provider dropdown menu. Selecting a provider automatically fills in the corresponding Profile, Base URL, Backend Type, and Auth Type:

ProviderProfileBase URL
OpenAIopenaihttps://api.openai.com/v1
Qwen Compatibleqwen_compatiblehttps://dashscope.aliyuncs.com/compatible-mode/v1
Anthropicanthropichttps://api.anthropic.com/v1
CustomCustomCustom

After choosing a provider, you only need to fill in your API Key and Model. Other LLM configuration items match the tables in Configuration.

WeChat ships ClawBot as a plugin—enable it in WeChat first, then log in via the Web config page:

  1. Enable the WeChat ClawBot plugin

    WeChat Me → Settings → Plugins → ClawBot, and turn it on.

  2. Log in on the Web config page

    Open the Web config page. You can log in via two ways:

    • Scan QR login: Click 「Generate QR」 to create a QR code, then in WeChat Me → Settings → Plugins → ClawBot, use Scan to read the code.
    • Link login: Click 「Generate QR」 to create a QR code first, then click 「Open login link」 to open the login page in a new window and follow the prompts.
  3. Signed in

    After login, the Web page shows a confirmation.

  4. Save

    Click Save Changes to persist all settings.

Network, search, and time zone follow the same fields as Configuration.

The Memory manager page is used to view and manage the long-term memory, soul, identity, and user information in the memory system.

  • Long-term memory is a human-readable file generated by the system based on structured memory. Modifying this file does not directly change the structured memory, so it only provides a read-only view function.
  • Soul, Identity, and User Information are editable files used to record the personalized information of the device and the user.

After chatting with ESP-Claw, you can click the “Refresh” button or “Refresh All” button to refresh the memory files and view the latest memory content.

The Web UI includes a simple file manager so you can browse and read/write files directly, without going through the LLM. For the ESP-Claw runtime filesystem structure, see Filesystem layout.

By default, the file manager is read-only. Write operations are available only after enabling Admin mode (Dev Mode). After enabling Admin mode, you can manually add Skills, edit automation rules, modify Lua scripts, and more.

basic_demo is not designed for production. Its HTTP server assumes a trusted environment and returns almost all information to help with debugging.