Libre WebUI 통합

Libre WebUI를 Libre Claw 데몬에 연결하여 실행 타임라인, 인라인 도구 승인, 자동화, 프로바이더 사용량을 갖춘 브라우저 제어 서피스를 사용.

Libre Claw의 브라우저 제어 서피스.

Libre WebUI 는 Kroonen AI가 구축한 프라이버시 우선, 셀프 호스팅 AI 채팅 인터페이스입니다. 0.12 릴리스부터 일급 Libre Claw 에이전트 서피스를 제공합니다: 전용 사이드바 항목, /agents 라우트, 로컬 데몬을 프록시하는 관리자 전용 백엔드 라우트. 에이전트 런타임, 보안 모델, 메모리, 도구, 스케줄은 Libre Claw에 남고, Libre WebUI는 그 위에 브라우저를 추가합니다.

소스와 설정은 github.com/libre-webui/libre-webui, 통합 가이드 (31-LIBRE_CLAW_INTEGRATION.md) 31-LIBRE_CLAW_INTEGRATION.md.

데몬 시작

Libre WebUI는 localhost를 통해 Libre Claw 데몬과 통신합니다. 평소처럼 시작한 후, WebUI에서 에이전트 페이지를 엽니다.

Libre Claw 시작
libre-claw start
# daemon listens at:
http://127.0.0.1:8766

그런 다음 열기 Libre WebUI → Libre Claw 연결 대상 http://127.0.0.1:8766.

WebUI를 커스텀 데몬으로 지정

데몬이 다른 호스트 또는 포트에서 실행되면, Libre WebUI를 시작하기 전에 백엔드 환경 변수를 설정.

backend/.env
LIBRE_CLAW_BASE_URL=http://127.0.0.1:8766
LIBRE_CLAW_TIMEOUT_MS=30000

새 값이 적용되도록 WebUI 백엔드를 재시작.

에이전트 페이지에서 할 수 있는 것

Run timelines

채팅 또는 골 모드 실행을 시작하고, 프로바이더/모델 오버라이드를 전달하고, 증분 이벤트를 스트리밍하고, 도구 호출과 결과를 검사하고, 활성 실행을 취소.

Inline approvals

브라우저에서 도구 권한 요청을 해결: 한 번 허용, 거부, 또는 페이지를 떠나지 않고 도구를 항상 허용.

Automations

예약 보고서 및 Telegram 라우트를 생성, 업데이트, 지금 실행, 일시정지, 재개, 삭제.

Usage

같은 에이전트 페이지에서 프로바이더 사용량 기록과 폴백 라우트 상태를 검사.

Model routing

관리자 전용 프록시 라우트를 통해 활성 프로바이더와 모델을 전환하고, 폴백 슬롯을 리뷰.

Daemon status

Libre WebUI를 떠나지 않고 연결 상태, 헬스, 대시보드 URL을 확인.

어떻게 맞춰지는가

Libre WebUI는 브라우저, Libre Claw는 런타임입니다. WebUI의 백엔드는 /api/libre-claw 아래 관리자 전용 라우트를 호출하여 데몬을 프록시합니다 — 에이전트, 메모리, 보안 모델에 대한 것은 복제되지 않습니다. 승인, 내구성 있는 실행, JSONL 로그, 스케줄은 모두 Libre Claw에 남습니다.

관리자 전용

Libre Claw 프록시 라우트는 관리자 전용입니다. 새 Libre WebUI 설치에서 처음 생성된 계정이 관리자가 되므로, 에이전트 서피스는 앱의 나머지 부분과 같은 인증 뒤에 있습니다.