Web 配置
basic_demo 在 Wi‑Fi 栈就绪后会启动一个轻量 HTTP 服务,托管配置页静态资源,并提供 JSON API。实现位于 application/basic_demo/main/config_http_server.c。
电脑或手机需与开发板在 同一局域网,或连接至开发板提供的 SoftAP 热点(basic_demo 中默认的 SSID 为 esp-claw-xxxx,xxxx 为设备 MAC 地址)。
在浏览器访问:
http://esp-claw.local/
或
http://<设备IP>/
页面加载后会自动加载当前配置。页面支持多语言切换,以及显示 Wi-Fi 连接状态、设备 IP 等信息。
配置页分为三个 Tab:
- Configuration:系统配置(Wi-Fi、LLM、IM、搜索、时区等)
- Memory:记忆文件管理(长期记忆与画像记忆)
- File Manager:文件系统管理
LLM 供应商选择
Section titled “LLM 供应商选择”配置页提供 LLM Provider 下拉菜单,选择后会自动填写对应的 Profile、Base URL、Backend Type 和 Auth Type:
| Provider | Profile | Base URL |
|---|---|---|
| OpenAI | openai | https://api.openai.com/v1 |
| Qwen Compatible | qwen_compatible | https://dashscope.aliyuncs.com/compatible-mode/v1 |
| Anthropic | anthropic | https://api.anthropic.com/v1 |
| Custom | 自定义 | 自定义 |
选择供应商后,只需填写 API Key 和 Model 即可。其余 LLM 配置项与 配置说明 中的表一致。
启用微信 ClawBot 接口
Section titled “启用微信 ClawBot 接口”目前,微信以插件的形式提供 ClawBot 功能,需先按照下述步骤在微信中启用,并在 Web 配置页面登录:
-
启用微信 ClawBot 插件
微信「我」→「设置」→「插件」→「ClawBot」,启用此插件。
-
在 Web 配置页面登录
打开 Web 配置页面,可通过以下两种方式登录:
- 扫码登录:点击「Generate QR」生成二维码,使用微信「我」→「设置」→「插件」→「ClawBot」→「微信扫一扫」扫描二维码。
- 链接登录:点击「Generate QR」生成二维码后,点击「Open login link」在新窗口打开登录链接,按提示完成登录。
-
登录成功
登录成功后,Web 配置页面将有相应提示。
-
保存配置
点击「Save Changes」按钮保存全部配置。
网络配置、搜索配置、时区配置等,与 配置说明 中的表一致。
记忆管理页面用于查看记忆系统中的长期记忆、管理「灵魂」、「身份」与「用户信息」。
- 长期记忆是系统根据结构化记忆生成的人类可读文件。修改该文件无法直接改变结构化记忆,因此仅提供只读查看功能。
- 灵魂、身份与用户信息是可编辑的文件,用于记录设备与用户的个性化信息。
在与 ESP-Claw 对话后,你可以点击「Refresh」按钮或「Refresh All」按钮,刷新记忆文件,查看最新的记忆内容。
Web 配置页面提供了简单的文件管理功能,可以在不通过 LLM 的情况下直接查阅和读写文件系统中的文件。 ESP-Claw 运行时的文件系统结构见 文件系统布局。
默认情况下,文件管理为只读模式,仅当启用「管理员模式」(Dev Mode)后,才能进行写操作。 启用「管理员模式」后,可用于手动添加 Skill、修改自动化规则、修改 Lua 脚本等。
basic_demo 不是为生产环境准备的。basic_demo 的 HTTP Server 假定你在可信的环境中运行,并且会返回几乎所有信息以便「极客」们调试。