Libre Claw 통합

Libre WebUI에는 Kroonen AI의 로컬 에이전트 하네스인 Libre Claw의 네이티브 통합이 포함되어 있습니다. Libre Claw는 일반 완성 제공자 플러그인이 아니라 Libre WebUI 내부의 일급 에이전트 화면으로 제공됩니다.

강력한 에이전트 동작은 계속 Libre Claw 런타임이 담당합니다.

영속 실행과 JSONL 이벤트 로그
파일, 셸, git, 브라우저, HTTP, 웹 검색, MCP 및 일정 도구
부작용 실행 전 승인 요청
영속 메모리와 프로젝트/사용자 스킬
목표 모드
대체 모델 경로
사용량 보고서
데몬이 소유하는 자동화와 Telegram 전송
독립 실행형 로컬 대시보드

Libre WebUI는 HTTP를 통해 Libre Claw 데몬과 통신하고 일반적인 인증된 WebUI 셸 안에서 해당 기능을 제공합니다.

인터페이스에서는 이 화면을 에이전트라고 부릅니다. 사이드바 아이콘, /agents 경로 및 명령 팔레트 항목이 모두 이 이름을 사용합니다. 그 뒤의 런타임은 Libre Claw이므로 데몬, 명령 및 환경 변수는 이 가이드 전체에서 원래 이름을 유지합니다.

Libre Claw와 Work의 차이

Libre Claw는 선택적 외부 런타임입니다. Libre WebUI의 기본 제공 Work 모드에는 필요하지 않습니다.

	Work	Libre Claw
런타임	네이티브 Libre WebUI 모델/도구 루프와 Docker	별도 Libre Claw 데몬
주요 범위	작업별 영속적이고 격리된 코딩 워크스페이스 하나	더 넓은 에이전트 실행, 메모리, 승인, 일정, 브라우저, MCP 및 도구
영속성	SQLite 작업 기록과 작업 소유 Docker 명명 볼륨	Libre Claw 자체 실행 및 메모리 저장소
모델 라우팅	Ollama, Ollama Cloud 또는 설정된 Libre WebUI 완성/채팅 플러그인	Libre Claw 제공자, 모델 및 대체 설정
없어도 사용 가능한 기능	Work는 정상적으로 계속 작동	`/agents` Libre Claw 화면만 연결 해제

모델이 제한된 작업 범위 컨테이너 안에서 파일을 만들거나 수정해야 한다면 Work를 사용하세요. 데몬의 더 넓은 도구 모음, 승인 시스템, 메모리, 목표 또는 자동화가 필요하다면 Libre Claw를 사용하세요.

아키텍처

WebUI 백엔드는 Libre Claw를 위해 셸 명령이나 브라우저 도구를 직접 실행하지 않습니다. 인증된 관리자 요청을 로컬 데몬에 프록시하고 데몬의 실행 상태, 이벤트, 승인, 자동화, 사용량 및 설정을 표시합니다.

Libre Claw 시작

Libre Claw를 설치합니다.

git clone https://github.com/kroonen-ai/libre-claw.git
cd libre-claw
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e ".[dev]"

데몬을 시작합니다.

libre-claw start

기본 대시보드와 API는 다음 주소에서 사용할 수 있습니다.

http://127.0.0.1:8766/dashboard

그런 다음 Libre WebUI → Libre Claw를 여세요.

백엔드 환경

Libre WebUI는 기본적으로 로컬 데몬 URL을 사용합니다.

LIBRE_CLAW_BASE_URL=http://127.0.0.1:8766
LIBRE_CLAW_TIMEOUT_MS=30000

데몬이 다른 호스트, Tailscale IP 또는 역방향 프록시 뒤의 로컬 서비스에서 실행된다면 LIBRE_CLAW_BASE_URL을 설정하세요.

WebUI 경로

모든 Libre Claw 경로는 로컬 파일 경로를 노출하고 에이전트 작업을 시작할 수 있으므로 인증된 관리자 사용자만 이용할 수 있습니다.

WebUI 경로	Libre Claw 기능
`GET /api/libre-claw/status`	데몬 상태, 기본 URL, 대시보드 URL
`GET /api/libre-claw/config/model`	현재 제공자/모델
`PATCH /api/libre-claw/config/model`	제공자/모델 업데이트
`GET /api/libre-claw/config/fallback`	현재 대체 경로
`PATCH /api/libre-claw/config/fallback`	대체 경로 업데이트
`PATCH /api/libre-claw/config/theme`	대시보드/TUI 테마 업데이트
`GET /api/libre-claw/runs`	영속 실행 목록
`POST /api/libre-claw/runs`	채팅 또는 목표 모드 실행 시작
`GET /api/libre-claw/runs/:id`	실행 메타데이터와 Artifacts
`GET /api/libre-claw/runs/:id/events`	증분 실행 이벤트
`POST /api/libre-claw/runs/:id/cancel`	실행 취소
`POST /api/libre-claw/runs/:id/permissions/:toolCallId`	도구 호출 승인 또는 거부
`GET /api/libre-claw/usage`	사용량 요약과 기록
`GET /api/libre-claw/automations`	예약 자동화 목록
`POST /api/libre-claw/automations`	자동화 생성
`PATCH /api/libre-claw/automations/:id`	자동화 업데이트
`POST /api/libre-claw/automations/:id/run`	자동화 지금 실행
`POST /api/libre-claw/automations/:id/pause`	자동화 일시 중지
`POST /api/libre-claw/automations/:id/resume`	자동화 다시 시작
`DELETE /api/libre-claw/automations/:id`	자동화 삭제

실행 시작

WebUI 페이지에서 다음을 시작할 수 있습니다.

채팅 실행 — 일반 Libre Claw 에이전트 턴입니다.
목표 실행 — Libre Claw의 판정자가 목표 완료로 표시하거나 설정된 제한에 도달할 때까지 계속되는 제한된 자동 조종 모드입니다.

선택적 제공자/모델 오버라이드는 해당 실행의 Libre Claw로 전달됩니다. 생략하면 Libre Claw가 설정된 기본 제공자와 모델을 사용합니다.

승인

Libre Claw가 권한을 요청하면 WebUI가 대기 중인 도구 호출을 보여 주고 관리자가 다음 중 하나를 선택할 수 있게 합니다.

allow_once
deny
always_allow_tool

권한 모델과 안전 검사는 계속 Libre Claw가 담당합니다. WebUI는 데몬 API를 통해 관리자의 선택만 기록합니다.

자동화

Libre WebUI에서 Libre Claw 데몬 자동화를 만들고 관리할 수 있습니다.

보고서 자동화
Telegram으로 전달되는 자동화
일시 중지/다시 시작
지금 실행
삭제

이는 호스트 cron 작업이 아니라 Libre Claw 자동화입니다. 보고서와 실행 기록은 Libre Claw 실행 저장소에 유지됩니다.

메모리, 스킬, Soul 및 도구

메모리, 스킬, soul 파일, MCP 도구, 브라우저 도구, SearXNG, Petdex 및 Telegram은 Libre Claw 자체에서 설정합니다. WebUI는 Libre Claw의 내부 설정 시스템을 복제하지 않고 데몬이 제공하는 기능을 표시하고 제어합니다.

유용한 Libre Claw 명령:

/memory status
/skills list
/soul status
/tools list
/workspace status
/telegram
/petdex status

문제 해결

WebUI에 "Libre Claw 데몬이 연결되지 않음"이 표시됨

데몬을 시작합니다.

libre-claw start

또는 백엔드 URL을 설정합니다.

LIBRE_CLAW_BASE_URL=http://127.0.0.1:8766

권한 버튼이 작동하지 않음

실행이 이미 끝났거나 Libre Claw 대시보드 또는 Telegram 브리지 같은 다른 화면에서 권한 요청을 처리했을 수 있습니다. WebUI 페이지를 새로 고치고 실행 타임라인을 확인하세요.

도구가 거부됨

Libre Claw의 권한 관리자가 최종 결정권을 가집니다. WebUI에 승인 요청이 표시되기 전에 호출이 거부된다면 Libre Claw 자체 설정과 실행 이벤트를 확인하세요.

자동화가 실행되지 않음

Libre Claw 데몬 상태와 자동화 설정을 확인하세요.

libre-claw status
libre-claw start

예약 자동화와 Telegram 전송에는 데몬이 실행 중이어야 합니다.

Libre Claw와 Work의 차이​

아키텍처​

Libre Claw 시작​

백엔드 환경​

WebUI 경로​

실행 시작​

승인​

자동화​

메모리, 스킬, Soul 및 도구​

문제 해결​

WebUI에 "Libre Claw 데몬이 연결되지 않음"이 표시됨​

권한 버튼이 작동하지 않음​

도구가 거부됨​

자동화가 실행되지 않음​

관련 문서​