10000ge10000/luci-app-openclaw

luci-app-openclaw – OpenWrt 用 OpenClaw AI 网关的 Web UI

是什么

• 一个 LuCI（OpenWrt 路由器使用的 Web UI）插件，可让你在路由器上直接安装、配置和运行 OpenClaw AI 网关。
• OpenClaw 本身是一个轻量级 AI 网关，可托管 LLM 模型并通过聊天渠道（如 WeChat）暴露。此插件为管理该服务提供图形化前端。

为何重要

• 无需额外服务器，即可将家用路由器转变为本地 AI 推理节点。
• 支持使用 musl C 库的 x86_64 和 ARM64 路由器，并自动下载和验证预构建的 Node.js 22 运行时。
• 内置对腾讯 WeChat 渠道的支持，可轻松通过熟悉的聊天应用与 AI 交互。

主要功能（README 中描述）

• 一键环境设置 – 在 LuCI 中点击“安装运行时”按钮，即可自动下载、验证 Node.js 和 OpenClaw，并启动服务。
• 模型管理 – 三层模型选择器：
  1. 推荐模型（各提供商的硬编码预设）。
  2. 实时列表（从 OpenClaw 获取 openclaw models list）。
  3. 手动输入（支持任意模型 ID）。
• WeChat 渠道向导 – 安装 @tencent-weixin/openclaw-weixin 插件，创建所需系统用户，检查 Python3，引导二维码登录流程。
• 可配置安装路径 – 通过标准 UCI 变量 openclaw.main.install_path 设置（默认为 /mnt/data/openclaw）。
• 健壮的 CI – GitHub Actions 构建 Node.js musl 二进制文件，将插件打包为 .run 自解压安装程序和 OpenWrt .ipk，并自动发布版本。
• 全面的健康检查 – 安装前验证存储空间、覆盖层可写性、与 WeChat 端点的 TLS 连接，以及 OpenClaw 目录权限。

安装方式

1. 自解压 .run – 下载最新发布版，运行脚本；无需 OpenWrt SDK。
2. OpenWrt 包 .ipk – 下载 .ipk 文件，使用 opkg 安装。
3. 编译进自定义固件 – 将仓库添加为 feeds.conf.default 中的 feed，运行 scripts/feeds，在 make menuconfig 中选择 LuCI → Applications → luci-app-openclaw，然后编译。

首次使用

1. 打开 LuCI → 服务 → OpenClaw → 点击 安装运行时。
2. 服务启动后，进入 Web 控制台 添加 AI 模型及其 API 密钥。
3. 使用 配置向导 启用一个消息通道（如 WeChat）。
4. 从选定通道发送一条消息进行测试；网关应使用所选 LLM 进行回复。

系统要求

要求	详情
CPU	x86_64 或 aarch64 (ARM64)
C 库	musl（预构建 Node.js 二进制文件所需）
依赖项	luci-compat, luci-base, curl, openssl-util, tar, script-utils
存储空间	≥ 2 GB 可用
内存	推荐 ≥ 1 GB

开发与贡献

• 源码结构遵循典型的 OpenWrt 包结构（Makefile、luasrc/、root/ 等）。
• 测试文件位于 tests/ 目录，可通过 sh tests/run_all.sh 运行。
• 欢迎通过 Issues 和 Pull Requests 提交贡献。

许可证 – GPL-3.0。

---

以上所有信息均直接来自仓库的 README；未推断任何额外功能。