跳转到内容

Web 配置

basic_demo 在 Wi‑Fi 栈就绪后会启动一个轻量 HTTP 服务,托管配置页静态资源,并提供 JSON API。实现位于 application/basic_demo/main/config_http_server.c

电脑或手机需与开发板在 同一局域网,或连接至开发板提供的 SoftAP 热点basic_demo 中默认的 SSID 为 esp-claw-xxxxxxxx 为设备 MAC 地址)。

在浏览器访问: http://esp-claw.local/http://<设备IP>/

页面加载后会自动加载当前配置。页面支持多语言切换,以及显示 Wi-Fi 连接状态、设备 IP 等信息。

配置页分为三个 Tab:

  • Configuration:系统配置(Wi-Fi、LLM、IM、搜索、时区等)
  • Memory:记忆文件管理(长期记忆与画像记忆)
  • File Manager:文件系统管理

配置页提供 LLM Provider 下拉菜单,选择后会自动填写对应的 ProfileBase URLBackend TypeAuth Type

ProviderProfileBase URL
OpenAIopenaihttps://api.openai.com/v1
Qwen Compatibleqwen_compatiblehttps://dashscope.aliyuncs.com/compatible-mode/v1
Anthropicanthropichttps://api.anthropic.com/v1
Custom自定义自定义

选择供应商后,只需填写 API KeyModel 即可。其余 LLM 配置项与 配置说明 中的表一致。

目前,微信以插件的形式提供 ClawBot 功能,需先按照下述步骤在微信中启用,并在 Web 配置页面登录:

  1. 启用微信 ClawBot 插件

    微信「我」→「设置」→「插件」→「ClawBot」,启用此插件。

  2. 在 Web 配置页面登录

    打开 Web 配置页面,可通过以下两种方式登录:

    • 扫码登录:点击「Generate QR」生成二维码,使用微信「我」→「设置」→「插件」→「ClawBot」→「微信扫一扫」扫描二维码。
    • 链接登录:点击「Generate QR」生成二维码后,点击「Open login link」在新窗口打开登录链接,按提示完成登录。
  3. 登录成功

    登录成功后,Web 配置页面将有相应提示。

  4. 保存配置

    点击「Save Changes」按钮保存全部配置。

网络配置、搜索配置、时区配置等,与 配置说明 中的表一致。

记忆管理页面用于查看记忆系统中的长期记忆、管理「灵魂」、「身份」与「用户信息」。

  • 长期记忆是系统根据结构化记忆生成的人类可读文件。修改该文件无法直接改变结构化记忆,因此仅提供只读查看功能。
  • 灵魂身份用户信息是可编辑的文件,用于记录设备与用户的个性化信息。

在与 ESP-Claw 对话后,你可以点击「Refresh」按钮或「Refresh All」按钮,刷新记忆文件,查看最新的记忆内容。

Web 配置页面提供了简单的文件管理功能,可以在不通过 LLM 的情况下直接查阅和读写文件系统中的文件。 ESP-Claw 运行时的文件系统结构见 文件系统布局

默认情况下,文件管理为只读模式,仅当启用「管理员模式」(Dev Mode)后,才能进行写操作。 启用「管理员模式」后,可用于手动添加 Skill、修改自动化规则、修改 Lua 脚本等。

basic_demo 不是为生产环境准备的。basic_demo 的 HTTP Server 假定你在可信的环境中运行,并且会返回几乎所有信息以便「极客」们调试。