Web 控制台

edge_agent 在 Wi‑Fi 栈就绪后会启动 Web 控制台，提供聊天、查看状态与修改配置功能。 Web 控制台的实现位于 http_server。

打开 Web 控制台

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

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

系统状态

系统状态页面可以查看 ESP-Claw 的基本状态，包括网络信息、IP 地址、Wi-Fi 模式、SoftAP SSID 和 IP 等。

在线聊天

在线聊天功能可在不配置额外 IM 通道时与 ESP-Claw 互动。在线聊天同样支持使用各项功能，以及通过消息触发 Event Router 能力。例如，你可以使用 /new 新建 Session 并切换。

在线聊天暂不支持接收图片等附件。

系统设置

基础设置

基础设置包括 Wi-Fi 设置和时区设置。

Wi-Fi 设置可以配置 SSID 和密码。重启生效
- 目前，除 ESP32-C5 外，其他芯片仅支持 2.4 GHz 频段的 Wi-Fi。
- 密码留空表示当前 Wi-Fi 无密码。
SoftAP 设置可以调整 SoftAP SSID、密码及启停。重启生效
- ESP-Claw 默认会启用 SoftAP，以便配网或调整配置。
- SSID 留空表示采用基于 MAC 地址的默认 SSID（esp-claw-XXXXXX）。
- 密码留空表示开放热点。如设置密码，长度至少 8 个字符。
- 可以配置 SoftAP 在成功连接至 Wi-Fi 后自动关闭。出于安全考量，建议启用此功能。
高级设置中，时区设置可以调整设备时区。重启生效
- 需为 POSIX TZ string 格式，推荐从此表格中查阅。
- 例如：北京/香港/新加坡等地的时区为 CST-8。
- 时区设置关系到 Schedule 定时任务的运行、LLM 获取到的时间等。
- 初次设置时，系统会自动尝试通过浏览器推断当前时区。但此方法推断的时区可能不准确、并不能推断出夏令时等信息。

LLM 设置重启生效

LLM 设置可以调整 LLM 的配置，包括供应商、API Key、模型等。为方便使用，ESP-Claw 内置了一些常用的 LLM 供应商配置，选择这些供应商仅需输入 API Key 和模型名称。

ESP-Claw 同样支持自定义 LLM 供应商。目前，ESP-Claw 支持 OpenAI 兼容 API 和 Anthropic 兼容 API 两种后端类型。你需要另行提供 Base URL，必要时按照 LLM 供应商的要求配置 Max Tokens 字段名称等。

ESP-Claw 推荐使用 gpt-5.4、qwen3.6-plus、deepseek-v4-pro、claude-sonnet-4-6 同等水平或更佳的模型，以充分发挥 ESP-Claw 的潜力。如需使用其他模型，请注意调整 LLM 高级选项中的「支持视觉输入」等配置，使之与模型支持的功能相匹配。

自定义 LLM 供应商时，Base URL 的路径需要保留到版本号，即：

保留 /chat/completions （OpenAI 格式）或 /messages （Anthropic 格式）前的部分；
不应以 / 结尾。

例如：

https://api.openai.com/v1/chat/completions
vvvvvvvv Base URL vvvvvvv
https://api.openai.com/v1

https://api.anthropic.com/v1/messages
vvvvvvvvvv Base URL vvvvvvvv
https://api.anthropic.com/v1

https://api.deepseek.com/chat/completions
vvvvvvv Base URL vvvvvvv
https://api.deepseek.com

IM 设置重启生效

IM 设置页面可接入或调整不同的即时通讯平台，包括微信、QQ、飞书、Telegram 等。

微信

如需启用微信，请点击「生成二维码」按钮，使用微信「扫一扫」功能扫描二维码完成配置。配置后，保存并重启即可生效。

高级设置中的微信 Base URL 和 CDN Base URL 一般不需要修改。默认值为

https://ilinkai.weixin.qq.com # WeChat Base URL
https://novac2c.cdn.weixin.qq.com/c2c # WeChat CDN Base URL

QQ

如需启用 QQ，请在 QQ开放平台创建 QQ 机器人，随后将 App ID 和 App Secret 填入对应字段。配置后，保存并重启即可生效。

飞书

如需启用飞书，请在飞书开放平台-创建飞书智能体应用创建飞书智能体应用，随后将 App ID 和 App Secret 填入对应字段。配置后，保存并重启即可生效。

注：暂不支持 Lark 飞书国际版。

如需启用 Telegram，请与 Telegram APP 内的 @botfather 对话，创建机器人并获取 Bot Token。随后将 Bot Token 填入对应字段。配置后，保存并重启即可生效。

网络和搜索设置

ESP-Claw 可以接入 Brave 或 Tavily 的搜索 API，并在运行中检索在线资源；也支持发起网络请求（GET/POST/…），实时请求在线资源。

搜索 API Key：可选，配置后支持通过搜索 API 检索在线资源。

Brave Search API Key：Brave Search API Key，详见 Brave API 文档。
Tavily API Key：Tavily API Key，详见 Tavily API 文档。

HTTP 请求：需配置 HTTP 白名单，支持通配符*，单独*表示允许全部域名/IP。

记忆管理

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

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

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

Memory 参考文档了解长期记忆、「灵魂」、「身份」与「用户信息」的详细信息

Capabilities 管理

Capabilities 管理页面用于管理 ESP-Claw 的各项 Capability 是否启用。如禁用，对应的 Capability 将不被加载。默认情况下，所有 Capability 均被启用。你可以通过勾选或取消勾选对应的 Capability 来启用或禁用该 Capability。

为了精简上下文长度，不是所有 Capability 都默认对 LLM 可见。某些 Capability 提供了 Skill，当 LLM 选择激活对应的 Skill 时，该 Capability 将自动向 LLM 提供其提供的工具。

Lua 模块管理重启生效

Lua 模块管理可用于管理由 IDF 底层模块转译的 Lua 模块是否启用，其与 Skill 提供的 Lua 模块不同。

Lua 模块参考文档了解 Lua 模块的详细信息

文件管理

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

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