Ενσωμάτωση Libre Claw

Το Libre WebUI περιλαμβάνει native ενσωμάτωση με το Libre Claw, το τοπικό agent harness της Kroonen AI. Εμφανίζεται ως πλήρης επιφάνεια agent και όχι ως γενικό completion plugin.

Το Libre Claw παραμένει το runtime που κατέχει την ισχυρή συμπεριφορά agent:

durable runs και logs JSONL
εργαλεία αρχείων, shell, git, browser, HTTP, web search, MCP και scheduling
εγκρίσεις πριν από side effects
μόνιμη μνήμη και δεξιότητες έργου/χρήστη
goal mode
fallback model routes
αναφορές χρήσης
αυτοματισμούς daemon και παράδοση Telegram
αυτόνομο τοπικό dashboard

Το Libre WebUI μιλά HTTP με τον daemon και εκθέτει τις λειτουργίες στο πιστοποιημένο UI. Η επιφάνεια ονομάζεται Agents στο sidebar, στο route /agents και στο command palette. Daemon, εντολή και environment variables κρατούν το όνομα Libre Claw.

Libre Claw και Work διαφέρουν

Το Libre Claw είναι προαιρετικό εξωτερικό runtime και δεν απαιτείται για το ενσωματωμένο Work.

	Work	Libre Claw
Runtime	Native loop μοντέλου/εργαλείων Libre WebUI και Docker	Ξεχωριστός daemon Libre Claw
Κύριο scope	Ένας μόνιμος απομονωμένος χώρος coding ανά εργασία	Ευρύτερα agent runs, μνήμη, εγκρίσεις, schedules, browser, MCP και εργαλεία
Αποθήκευση	Ιστορικό SQLite και Docker volume εργασίας	Δικά του stores εκτελέσεων/μνήμης
Model routing	Ollama, Ollama Cloud ή ρυθμισμένο plugin	Ρυθμίσεις παρόχου, μοντέλου και fallback Libre Claw
Χωρίς αυτό	Το Work συνεχίζει	Αποσυνδέεται μόνο η επιφάνεια `/agents`

Χρησιμοποιήστε Work για αρχεία σε περιορισμένο container εργασίας. Χρησιμοποιήστε Libre Claw για ευρύτερα εργαλεία, εγκρίσεις, μνήμη, στόχους ή αυτοματισμούς daemon.

Αρχιτεκτονική

Το backend WebUI δεν εκτελεί απευθείας shell ή browser εργαλεία για το Libre Claw. Προωθεί πιστοποιημένα admin requests και εμφανίζει κατάσταση, events, εγκρίσεις, αυτοματισμούς, χρήση και config του daemon.

Εκκίνηση 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

Προεπιλεγμένο dashboard/API:

http://127.0.0.1:8766/dashboard

Μετά ανοίξτε Libre WebUI → Libre Claw.

Περιβάλλον backend

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

Αλλάξτε LIBRE_CLAW_BASE_URL αν ο daemon τρέχει σε άλλο host, Tailscale IP ή πίσω από reverse proxy.

Routes WebUI

Όλα απαιτούν πιστοποιημένο admin επειδή μπορεί να αποκαλύπτουν τοπικά paths και να ξεκινούν agent work:

Route WebUI	Λειτουργία
`GET /api/libre-claw/status`	Υγεία daemon, base URL, dashboard URL
`GET /api/libre-claw/config/model`	Τρέχων πάροχος/μοντέλο
`PATCH /api/libre-claw/config/model`	Ενημέρωση παρόχου/μοντέλου
`GET /api/libre-claw/config/fallback`	Τρέχον fallback
`PATCH /api/libre-claw/config/fallback`	Ενημέρωση fallback
`PATCH /api/libre-claw/config/theme`	Θέμα dashboard/TUI
`GET /api/libre-claw/runs`	Λίστα durable runs
`POST /api/libre-claw/runs`	Έναρξη chat ή goal run
`GET /api/libre-claw/runs/:id`	Metadata και artifacts
`GET /api/libre-claw/runs/:id/events`	Αυξητικά events
`POST /api/libre-claw/runs/:id/cancel`	Ακύρωση run
`POST /api/libre-claw/runs/:id/permissions/:toolCallId`	Έγκριση/απόρριψη εργαλείου
`GET /api/libre-claw/usage`	Σύνοψη και records χρήσης
`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`	Διαγραφή

Έναρξη runs

Chat runs — κανονικοί γύροι agent.
Goal runs — περιορισμένος autopilot μέχρι ο judge να ολοκληρώσει τον στόχο ή να φτάσει το όριο.

Προαιρετικά overrides παρόχου/μοντέλου προωθούνται στο Libre Claw· αλλιώς χρησιμοποιεί προεπιλογές.

Εγκρίσεις

Όταν ζητείται άδεια, το WebUI εμφανίζει το tool call και επιλογές:

allow_once
deny
always_allow_tool

Το Libre Claw κατέχει το permission model και τους ελέγχους· το WebUI καταγράφει μόνο την επιλογή μέσω API daemon.

Αυτοματισμοί

Το WebUI δημιουργεί και διαχειρίζεται αυτοματισμούς Libre Claw για αναφορές και Telegram, με pause/resume, run now και delete. Είναι αυτοματισμοί daemon, όχι cron jobs host· το ιστορικό μένει στο Libre Claw.

Μνήμη, δεξιότητες, Soul και εργαλεία

Μνήμη, skills, soul files, MCP, browser, SearXNG, Petdex και Telegram ρυθμίζονται στο Libre Claw. Χρήσιμες εντολές:

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

Αντιμετώπιση προβλημάτων

Το WebUI δείχνει "Libre Claw daemon is not connected"

libre-claw start

ή:

LIBRE_CLAW_BASE_URL=http://127.0.0.1:8766

Τα κουμπιά άδειας δεν λειτουργούν

Το run ίσως ολοκληρώθηκε ή η άδεια επιλύθηκε από dashboard ή Telegram. Ανανεώστε και ελέγξτε timeline.

Ένα εργαλείο απορρίφθηκε

Ο permission manager Libre Claw είναι authoritative. Ελέγξτε config και events.

Οι αυτοματισμοί δεν τρέχουν

libre-claw status
libre-claw start

Ο daemon πρέπει να τρέχει για schedules και Telegram.

Libre Claw και Work διαφέρουν​

Αρχιτεκτονική​

Εκκίνηση Libre Claw​

Περιβάλλον backend​

Routes WebUI​

Έναρξη runs​

Εγκρίσεις​

Αυτοματισμοί​

Μνήμη, δεξιότητες, Soul και εργαλεία​

Αντιμετώπιση προβλημάτων​

Το WebUI δείχνει "Libre Claw daemon is not connected"​

Τα κουμπιά άδειας δεν λειτουργούν​

Ένα εργαλείο απορρίφθηκε​

Οι αυτοματισμοί δεν τρέχουν​

Σχετική τεκμηρίωση​