src/process/resources/skills/aionui-webui-setup/references/aionui-webui.md
AionUi 支持 WebUI 模式，允许通过浏览器访问应用。这对于远程使用 OpenClaw 非常有用。AionUi 提供三种远程连接方式，满足不同场景的需求。
重要：WebUI 配置应通过 AionUi 设置界面完成，无需使用命令行。本指南将引导你如何在设置界面中完成配置。
| 连接方式 | 使用场景 | 描述 | 难度 |
|---|---|---|---|
| 1. 局域网连接 | 同一 WiFi/LAN 的设备访问 | 手机和电脑在同一 WiFi，启用"允许远程访问" | ⭐ 简单 |
| 2. 远程软件 (Tailscale) | 跨网络访问（如办公室到家庭） | 使用 VPN 软件如 Tailscale，无需公网 IP 或服务器 | ⭐ 非常简单 |
| 3. 服务器部署 | 多用户访问、24/7 运行 | 部署在云服务器，通过公网 IP 直接访问 | ⭐⭐ 中等 |
http://localhost:25808http://<LAN_IP>:25808（需要启用"允许远程访问"）admin方式 1：通过设置按钮（推荐）
方式 2：通过快捷键
方式 3：通过路由（WebUI 模式）
http://<服务器地址>:25808/#/settings/webuiWebUI 启动后，设置界面会显示：
访问地址：
http://localhost:25808（仅本机访问）http://<局域网IP>:25808（如果启用了远程访问）登录信息：
admin（可点击复制）二维码登录（如果启用了远程访问）：
http://<局域网IP>:25808）打开 WebUI 设置界面：
启用 WebUI：
记录访问信息：
http://localhost:25808）100.x.x.x）http://<Tailscale_IP>:25808http://<Tailscale_IP>:25808（使用 Step 3 中的地址）# 查看 Tailscale 状态
tailscale status
# 查看 Tailscale IP
tailscale ip
# 查看所有设备
tailscale status --json
按照 AionUi 安装指南在服务器上安装 AionUi 应用。
打开 WebUI 设置界面：
配置 WebUI：
记录访问信息：
http://<服务器IP>:25808）# Ubuntu/Debian (ufw)
sudo ufw allow 25808/tcp
sudo ufw reload
# CentOS/RHEL (firewalld)
sudo firewall-cmd --permanent --add-port=25808/tcp
sudo firewall-cmd --reload
# 或使用 iptables
sudo iptables -A INPUT -p tcp --dport 25808 -j ACCEPT
如果需要 AionUi 开机自启，可以配置 systemd 服务。但建议通过 AionUi 设置界面管理 WebUI，而不是通过命令行。
获取服务器公网 IP：
curl ifconfig.me
# 或
curl ipinfo.io/ip
访问地址：http://<公网IP>:25808
如果配置了域名，可以使用：http://<域名>:25808
按照 AionUi 安装指南在 macOS 服务器上安装 AionUi 应用。
# 允许端口 25808
sudo /usr/libexec/ApplicationFirewall/socketfilterfw --add /Applications/AionUi.app/Contents/MacOS/AionUi
sudo /usr/libexec/ApplicationFirewall/socketfilterfw --unblockapp /Applications/AionUi.app/Contents/MacOS/AionUi
admin（可点击复制）检查端口是否被占用：
检查防火墙设置：
sudo ufw status 或 sudo firewall-cmd --list-all确认已启用"允许远程访问"：
检查防火墙设置（见上方）
确认设备在同一局域网（局域网连接方式）
检查 IP 地址是否正确：
检查云服务器安全组规则（服务器部署方式）
Q: Tailscale 显示未连接？
Q: 无法通过 Tailscale IP 访问？
tailscale status如果需要使用非默认端口（25808），可以通过配置文件设置：
| 平台 | 配置文件位置 |
|---|---|
| Windows | %APPDATA%/AionUi/webui.config.json |
| macOS | ~/Library/Application Support/AionUi/webui.config.json |
| Linux | ~/.config/AionUi/webui.config.json |
{
"port": 8080,
"allowRemote": true
}
注意：修改配置文件后，需要在设置界面中重启 WebUI 服务才能生效。
启动 WebUI 后，可以通过浏览器访问 AionUi，然后：
# 检查端口
lsof -i :25808
# 检查进程
ps aux | grep AionUi
# 获取 IP 地址
ifconfig | grep "inet " | grep -v 127.0.0.1
# 测试连接
curl http://localhost:25808