[English]

AmebaClaw Web 后台用户手册

AmebaClaw 内置一个 Web 管理后台，通过浏览器即可完成网络配置、AI 大模型配置、消息机器人接入、文件管理等所有操作。

设备未配网时(配网模式)，将手机或电脑连接设备热点（AmebaClaw-XXXX，无需密码）后访问 http://192.168.1.1。设备联网后(正常模式)，确保手机或电脑与设备连接相同网络，在浏览器中打开设备 IP 即可访问后台（例如 http://<设备 IP 地址>/）。

备注

如果不知道设备被分配的 IP 地址，请到串口日志或路由器后台查看设备的 IP 地址。

警告

Web 后台可以访问所有你配置的密钥信息，请将设备连接到可信任 Wi-Fi 网络，不要连接陌生 Wi-Fi 或把后台端口暴露到公网，以免密钥泄漏。

系统状态

展示设备当前运行情况：

指标	说明
Wi-Fi 状态	已配置时显示 SSID 与 IP 地址
SoftAP 状态	热点是否开启及其 IP
工作模式	`normal` （正常模式）/ `provisioning` （配网模式）
固件版本	当前烧录的固件版本号
堆内存	当前空闲内存 / 历史最低水位线

操作：

刷新 — 手动拉取最新状态。
重启设备 — 点击后需二次确认，重启后自动等待网络重新连通并刷新页面。

实时对话

通过 WebSocket 与设备上运行的 AI 助手进行实时对话。

使用方式：

页面顶部连接状态显示"已连接"（绿色）后即可发送消息。
在底部输入框输入内容，按 Enter 发送；Shift + Enter 换行。
断线后会自动重连（最长间隔 8 秒）。

备注

AI 回复依赖"LLM 配置"中设置的接口，未配置时无法使用。

网络配置

为设备配置 Wi-Fi 连接。

字段说明：

Wi-Fi 名称（SSID） — 要连接的无线网络名称。
密码 — 开放网络请留空。密码可点击右侧眼睛图标切换显示/隐藏。

操作步骤：

填写 SSID 和密码，点击连接。
页面会每 2 秒轮询连接状态（最多等待约 2 分钟）。
连接成功后页面显示在目标 Wi-Fi 分配的 IP 地址，并提供跳转链接。

备注

若更换 Wi-Fi 网络，设备 IP 会改变，需用新 IP 重新访问后台。
SoftAP 热点与 Wi-Fi 联网可同时工作（MCC 模式），配网完成并重启设备后热点会关闭。

LLM 配置

配置 AI 大语言模型的接入参数。

快速选择服务商

点击对应按钮可自动填入该服务商的 API 地址和推荐模型：

按钮	服务商	推荐模型
Deepseek	DeepSeek	deepseek-v4-flash
阿里百炼	阿里云百炼	qwen-plus
OpenAI	OpenAI	gpt-5.5
Anthropic	Anthropic	claude-sonnet-4-6
自定义	任意兼容接口	手动填写

基础配置

API Key — 服务商提供的密钥，可点击眼睛图标查看明文。
Model ID — 模型名称，例如 deepseek-v4-flash。

高级设置（点击展开）

字段	默认值	说明
API 地址	随服务商预填	LLM API 接口地址
认证方式	Bearer Token	Anthropic 接口需选"Anthropic"
最大 Token 数	16384	单次回复最大 token 数
最大迭代次数	50	Agent 最大工具调用轮次
启用思考模式	关	开启后模型进行链式思维（部分模型支持）
启用流式输出	关	开启后回复逐字显示
上下文压缩触发 Token 数	110000	超过该 token 数自动压缩上下文
上下文窗口上限 Token 数	128000	模型支持的最大上下文长度

填写完成后点击 保存配置。

消息机器人配置

接入各 IM 平台的机器人，设备可通过这些渠道收发消息。每个平台为独立的折叠卡片，互不影响。

微信

通过扫码登录微信账号，使设备能接收和发送微信消息。

步骤：

填写 iLink URL（通常为 https://ilinkai.weixin.qq.com）。
点击 生成二维码，等待二维码显示。
用微信 App 扫描二维码完成授权。
状态变为 已登录 后配置生效。

WeChat Bot Token — 扫描二维码会自动填写，无法扫描二维码时也可手动填写。

自动填写或手动填写后点击 保存微信。

飞书

需要在飞书开放平台创建应用并获取凭证。

App ID — 飞书应用的唯一标识，留空则禁用飞书机器人。
App Secret — 飞书应用的密钥。

填写后点击 保存飞书，右侧徽章变为 已配置 表示保存成功。

Telegram

需要通过 @BotFather 创建机器人并获取 Token。

Bot Token — 格式为 123456789:AAF...，留空则禁用。

填写后点击 保存 Telegram。

QQ 机器人

需要在 QQ 开放平台注册应用并获取凭证。

AppID — QQ 机器人的应用 ID，留空则禁用。
AppSecret — QQ 机器人的密钥。

填写后点击 保存 QQ。

备注

所有字段留空保存即为停用该平台机器人。

搜索配置

为 AI 助手配置联网搜索能力，使用 Tavily 搜索 API。

Tavily API Key — 在 Tavily 注册账号后获取，留空则禁用搜索功能。
每次返回结果数 — 单次搜索返回的结果条数（1~5，默认 3）。

填写后点击 保存配置。

任务管理

查看并控制设备上运行的定时任务（Capability）。

表格列说明：

任务名 — 任务的唯一标识名称。
调度/间隔 — Cron 表达式或触发间隔。
状态 — 绿色 运行中 / 灰色 未启动。
操作 — 点击按钮可启用或停用任务。

点击刷新可更新列表状态。

Lua 模块管理

控制设备上可供 Lua 脚本调用的驱动模块开关。

驱动模块列表

模块	功能	是否可关闭
audio	麦克风（DMIC）音频输入	✓
uart	UART 串口通信	✓
i2c	I²C 总线	✓
spi	SPI 总线	✓
rtc	实时时钟	✓
timer	定时器	✓
file	文件系统访问	✓
wifi	Wi-Fi 管理	✓
gpio	GPIO 引脚控制	✓
sys	系统工具	锁定（核心）
event	事件总线	锁定（核心）
cap	Capability 调用	锁定（核心）

操作步骤：

切换各模块右侧的开关（灰色标"锁定"的模块不可修改）。
点击 保存配置。
按提示 重启设备 后配置生效。

备注

关闭模块后，依赖该模块的 Lua 脚本将无法正常运行。

文件管理

浏览、上传、下载、编辑设备文件系统中的文件。

存储区域

通过顶部下拉菜单切换存储区域：

vfs: — 用户存储区，可读写。
rolfs: — 只读存储区，只能浏览和下载。

文件操作

操作	方法
进入目录	点击目录名
返回上级	点击 ↑ 上级按钮
上传文件	点击上传按钮，选择本地文件
新建文件夹	点击新建文件夹，输入名称确认
下载文件	点击文件行的下载按钮
下载目录	点击目录行的下载按钮（自动打包为 ZIP）
编辑文件	点击文件行的编辑按钮，修改后保存（只读区域仅可查看）
删除文件/目录	点击删除按钮（只读区域按钮不可用）

备注

在线编辑器最大支持 32 KB 的文本文件，超过此大小请下载后本地编辑再上传。
删除目录会递归删除其内所有内容，操作前请确认。
不正确地删除或修改必要文件可能导致系统异常，请谨慎操作。

记忆管理

管理 AI 助手的身份定义与长期记忆。

记忆文件

设备保存 4 个 Markdown 配置文件，直接影响 AI 的行为和人格：

文件	作用
AGENTS.md	Agent 基础身份定义（工具调用能力、职责范围等）
SOUL.md	系统人格定义（沟通风格、价值观等）
USER.md	跨会话用户档案（用户偏好、历史信息等）
IDENTITY.md	人格标识（名字、自我认知等）

每个文件有独立的文本编辑框，修改后点击对应的保存按钮即生效（无需重启）。

长期记忆

表格展示 AI 在对话过程中积累的结构化记忆条目：

内容 — 记忆的具体内容。
标签 — 记忆的分类标签。
来源 — 记忆的产生来源。
时间 — 记忆创建时间。

操作：

编辑 — 点击某条记忆的编辑按钮，可修改内容和标签后保存。
删除 — 点击删除按钮并确认后移除该条记忆。
刷新 — 重新加载所有记忆文件和条目。

会话管理

在侧边栏点击 会话管理 可进入跨渠道的会话统一管理页面。

页面按渠道（如 telegram:12345678、wechat:u_abc）分组展示所有会话，每组显示该渠道下的全部会话别名，当前活跃会话以蓝色标注。

可用操作：

查看历史 — 点击某条会话的"查看历史"按钮，在弹窗中浏览该会话的完整对话记录（用户消息与 AI 回复逐条展示）。
删除 — 点击"删除"按钮并确认，可删除该会话及其历史记录。

备注

若要在对话中新建、切换或重命名会话，请在对应渠道使用斜杠命令（如 /new、/resume）。Web 后台会话管理页当前仅支持查看和删除操作。详见会话管理。

其他说明

所有配置修改保存后立即生效（Lua 模块除外），无需重启。
若后台无法访问，请先通过串口或连接 SoftAP 热点检查设备网络状态。