10000ge10000/luci-app-openclaw
OpenClaw AI 网关的 OpenWrt LuCI 管理插件。
luci-app-openclaw – OpenWrt용 OpenClaw AI 게이트웨이 웹 UI
무엇인가요
- OpenWrt 라우터에서 사용하는 웹 UI인 LuCI 플러그인으로, OpenClaw AI 게이트웨이를 라우터 내부에서 직접 설치, 구성, 실행할 수 있게 해줍니다.
- OpenClaw 자체는 LLM 모델을 호스팅하고, 채팅 채널(예: WeChat)을 통해 노출할 수 있는 경량 AI 게이트웨이입니다. 이 플러그인은 해당 서비스를 관리하기 위한 그래픽 사용자 인터페이스를 제공합니다.
왜 중요한가요
- 별도의 서버 없이도 가정용 라우터를 온프레미스 AI 추론 노드로 전환할 수 있습니다.
- x86_64 및 ARM64 라우터(모든 musl C 라이브러리 사용)를 지원하며, 사전 빌드된 Node.js 22 런타임을 자동으로 다운로드하고 검증합니다.
- Tencent WeChat 채널을 내장 지원하여 익숙한 메시징 앱을 통해 AI와 쉽게 상호작용할 수 있습니다.
주요 기능 (README에 기술된 내용)
- 한 번의 클릭 환경 설정 – LuCI에서 "런타임 설치" 버튼을 누르면 Node.js와 OpenClaw를 다운로드하고 검증한 후 서비스를 시작합니다.
- 모델 관리 – 3단계 모델 선택기:
- 추천 모델 (각 제공자용 하드코딩된 프리셋).
- 실시간 목록 (OpenClaw의
openclaw models list에서 가져옴). - 수동 입력 (모든 모델 ID를 수동으로 입력 가능).
- WeChat 채널 워즈드 –
@tencent-weixin/openclaw-weixin플러그인을 설치하고, 필요한 시스템 사용자를 생성하며, Python3 존재 여부를 확인하고 QR 코드 로그인 흐름을 안내합니다. - 설치 경로 설정 가능 – 표준 UCI 변수
openclaw.main.install_path를 통해 설정 가능 (기본값:/mnt/data/openclaw). - 강력한 CI – GitHub Actions가 Node.js musl 바이너리를 빌드하고, 플러그인을
.run자가 추출 설치 파일과 OpenWrt.ipk패키지로 패키징하며, 자동으로 릴리스를 게시합니다. - 광범위한 정합성 검사 – 설치 전에 저장 공간, 오버레이 쓰기 가능 여부, WeChat 엔드포인트로의 TLS 연결, OpenClaw 디렉터리 권한을 검증합니다.
설치 옵션
- 자기 추출
.run– 최신 릴리스를 다운로드하고 스크립트를 실행하면 됩니다. OpenWrt SDK가 필요 없습니다. - OpenWrt 패키지
.ipk–.ipk파일을 다운로드하여opkg로 설치합니다. - 사용자 정의 펌웨어에 컴파일 – 리포지토리를
feeds.conf.default에 피드로 추가하고scripts/feeds를 실행한 후,make menuconfig에서 LuCI → Applications → luci-app-openclaw를 선택하여 컴파일합니다.
초기 사용 방법
- LuCI → 서비스 → OpenClaw → 런타임 설치를 클릭합니다.
- 서비스가 시작된 후, 웹 콘솔로 이동하여 AI 모델과 API 키를 추가합니다.
- 설정 워즈드를 사용해 메시징 채널(예: WeChat)을 활성화합니다.
- 선택한 채널에서 메시지를 보내 테스트합니다. 선택한 LLM을 사용해 응답이 올 것입니다.
시스템 요구 사항
| 요구 사항 | 세부 사항 |
|---|---|
| CPU | x86_64 또는 aarch64 (ARM64) |
| C 라이브러리 | musl (사전 빌드된 Node.js 바이너리에 필수) |
| 종속성 | luci-compat, luci-base, curl, openssl-util, tar, script-utils |
| 저장 공간 | ≥ 2 GB 여유 공간 |
| RAM | 추천 ≥ 1 GB |
개발 및 기여
- 소스 구조는 일반적인 OpenWrt 패키지 구조(
Makefile,luasrc/,root/등)를 따릅니다. - 테스트는
tests/디렉터리에 있으며,sh tests/run_all.sh로 실행할 수 있습니다. - Issues와 Pull Requests를 통해 기여를 환영합니다.
라이선스 – GPL-3.0.
위 정보는 리포지토리의 README에서 직접 가져온 것이며, 추가 기능은 추측되지 않았습니다.
관련
- 프로젝트
- 프로젝트
- 프로젝트