Integrasi Libre Claw
Libre WebUI menyertakan integrasi Libre Claw, kerangka agen lokal Kroonen AI. Libre Claw menjadi antarmuka agen utama, bukan plugin completion umum.
Libre Claw memiliki perilaku agen kuat:
- proses persisten dan log JSONL
- alat berkas, shell, Git, peramban, HTTP, pencarian, MCP, jadwal
- permintaan persetujuan sebelum efek samping
- memori dan keterampilan persisten
- mode tujuan
- rute model cadangan
- laporan penggunaan
- otomasi dan Telegram
- dasbor lokal
Libre WebUI berkomunikasi lewat HTTP dan menampilkan fitur dalam shell terautentikasi.
Di antarmuka namanya Agents; ikon, /agents, dan palet memakai nama itu. Runtime tetap bernama Libre Claw.
Libre Claw dan Work Berbeda
Libre Claw opsional dan tidak diperlukan Work.
| Work | Libre Claw | |
|---|---|---|
| Runtime | Siklus Libre WebUI + Docker | Layanan Libre Claw terpisah |
| Cakupan | Ruang kode terisolasi per tugas | Alat, memori, persetujuan, jadwal luas |
| Persistensi | SQLite + volume Docker | Penyimpanan Libre Claw |
| Model | Ollama/Cloud/plugin | Konfigurasi Libre Claw |
| Tanpanya | Work tetap berjalan | /agents terputus |
Gunakan Work untuk berkas dalam kontainer; Libre Claw untuk alat, memori, tujuan, dan otomasi luas.
Arsitektur
Backend tidak menjalankan shell/peramban Libre Claw langsung; ia meneruskan permintaan admin dan menampilkan status, peristiwa, persetujuan, otomasi, penggunaan, konfigurasi.
Menjalankan 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
http://127.0.0.1:8766/dashboard
Buka Libre WebUI → Libre Claw.
Lingkungan Backend
LIBRE_CLAW_BASE_URL=http://127.0.0.1:8766
LIBRE_CLAW_TIMEOUT_MS=30000
Tetapkan LIBRE_CLAW_BASE_URL jika layanan berada di host lain.
Rute WebUI
Semua rute memerlukan admin karena dapat membuka jalur lokal dan memicu pekerjaan:
| Rute | Fitur |
|---|---|
GET /api/libre-claw/status | Status |
GET /api/libre-claw/config/model | Model |
PATCH /api/libre-claw/config/model | Ubah model |
GET /api/libre-claw/config/fallback | Rute cadangan |
PATCH /api/libre-claw/config/fallback | Ubah cadangan |
PATCH /api/libre-claw/config/theme | Tema |
GET /api/libre-claw/runs | Daftar proses |
POST /api/libre-claw/runs | Mulai proses |
GET /api/libre-claw/runs/:id | Metadata |
GET /api/libre-claw/runs/:id/events | Peristiwa |
POST /api/libre-claw/runs/:id/cancel | Batal |
POST /api/libre-claw/runs/:id/permissions/:toolCallId | Izin |
GET /api/libre-claw/usage | Penggunaan |
GET /api/libre-claw/automations | Otomasi |
POST /api/libre-claw/automations | Buat |
PATCH /api/libre-claw/automations/:id | Ubah |
POST /api/libre-claw/automations/:id/run | Jalankan |
POST /api/libre-claw/automations/:id/pause | Jeda |
POST /api/libre-claw/automations/:id/resume | Lanjut |
DELETE /api/libre-claw/automations/:id | Hapus |
Memulai Proses
- Chat — giliran agen biasa.
- Tujuan — berjalan sampai tujuan selesai atau batas tercapai.
Penimpaan model diteruskan; jika kosong memakai bawaan Libre Claw.
Persetujuan
allow_oncedenyalways_allow_tool
Libre Claw memiliki model izin; WebUI hanya merekam pilihan.
Otomasi
Libre WebUI mengelola laporan, Telegram, jeda/lanjut, jalankan sekarang, dan hapus. Ini bukan cron host; riwayat tetap di Libre Claw.
Memori, Keterampilan, Soul, dan Alat
Semua dikonfigurasi di Libre Claw:
/memory status
/skills list
/soul status
/tools list
/workspace status
/telegram
/petdex status
Pemecahan Masalah
WebUI Menampilkan "Libre Claw daemon is not connected"
libre-claw start
LIBRE_CLAW_BASE_URL=http://127.0.0.1:8766
Tombol Izin Tidak Bekerja
Proses mungkin selesai atau izin diselesaikan di dasbor/Telegram. Segarkan halaman.
Alat Ditolak
Periksa konfigurasi dan peristiwa Libre Claw.
Otomasi Tidak Berjalan
libre-claw status
libre-claw start
Layanan harus aktif.