ข้ามไปยังเนื้อหาหลัก

การเชื่อมต่อ Libre Claw

Libre WebUI มีการเชื่อมต่อแบบ native สำหรับ Libre Claw ซึ่งเป็น agent harness ในเครื่องของ Kroonen AI Libre Claw ปรากฏเป็นพื้นที่ตัวแทนระดับแรกใน Libre WebUI ไม่ใช่ปลั๊กอินผู้ให้บริการ completion ทั่วไป

Libre Claw ยังคงเป็น runtime ที่ควบคุมพฤติกรรมตัวแทนที่มีความสามารถสูง:

  • การรันถาวรและ log เหตุการณ์ JSONL
  • เครื่องมือไฟล์, shell, git, เบราว์เซอร์, HTTP, ค้นหาเว็บ, MCP และกำหนดเวลา
  • คำขออนุมัติก่อนเกิดผลข้างเคียง
  • หน่วยความจำถาวรและทักษะระดับโครงการ/ผู้ใช้
  • โหมดเป้าหมาย
  • เส้นทางโมเดลสำรอง
  • รายงานการใช้งาน
  • การทำงานอัตโนมัติที่ daemon เป็นเจ้าของและการส่งผ่าน Telegram
  • แดชบอร์ดในเครื่องแบบแยกต่างหาก

Libre WebUI สื่อสารกับ daemon ของ Libre Claw ผ่าน HTTP และแสดงฟีเจอร์เหล่านี้ภายใน WebUI ที่ยืนยันตัวตนตามปกติ

ในอินเทอร์เฟซ พื้นที่นี้เรียกว่า Agents ทั้งไอคอนในแถบด้านข้าง เส้นทาง /agents และรายการในชุดคำสั่งใช้ชื่อนี้ Libre Claw เป็น runtime เบื้องหลัง ดังนั้น daemon, คำสั่ง และตัวแปรสภาพแวดล้อมจะยังใช้ชื่อเดิมตลอดคู่มือนี้

Libre Claw และ Work แตกต่างกัน​

Libre Claw ยังคงเป็น runtime ภายนอกที่เลือกใช้ได้ และไม่จำเป็นสำหรับโหมด Work ในตัวของ Libre WebUI

WorkLibre Claw
Runtimeวงจรโมเดล/เครื่องมือแบบ native ของ Libre WebUI พร้อม Dockerdaemon Libre Claw แยกต่างหาก
ขอบเขตหลักพื้นที่เขียนโค้ดถาวรที่แยกออกจากกันหนึ่งแห่งต่อหนึ่งงานการรันตัวแทน หน่วยความจำ การอนุมัติ กำหนดเวลา เบราว์เซอร์ MCP และเครื่องมือที่กว้างกว่า
การจัดเก็บประวัติงาน SQLite พร้อม Docker named volume ที่งานเป็นเจ้าของที่เก็บการรันและหน่วยความจำของ Libre Claw
การกำหนดเส้นทางโมเดลOllama, Ollama Cloud หรือปลั๊กอิน completion/chat ของ Libre WebUI ที่กำหนดไว้การตั้งค่าผู้ให้บริการ โมเดล และเส้นทางสำรองของ Libre Claw
ความพร้อมเมื่อไม่มีระบบนี้Work ทำงานต่อได้ตามปกติเฉพาะพื้นที่ Libre Claw ที่ /agents เท่านั้นที่ตัดการเชื่อมต่อ

ใช้ Work เมื่อโมเดลควรสร้างหรือแก้ไฟล์ภายในคอนเทนเนอร์ที่จำกัดขอบเขตตามงาน ใช้ Libre Claw เมื่อต้องการชุดเครื่องมือ ระบบอนุมัติ หน่วยความจำ เป้าหมาย หรือการทำงานอัตโนมัติที่กว้างกว่าของ daemon

สถาปัตยกรรม​

backend ของ WebUI จะไม่รันคำสั่ง shell หรือเครื่องมือเบราว์เซอร์ให้ Libre Claw โดยตรง แต่จะ proxy คำขอผู้ดูแลระบบที่ยืนยันตัวตนแล้วไปยัง daemon ในเครื่อง และแสดงสถานะการรัน เหตุการณ์ การอนุมัติ การทำงานอัตโนมัติ การใช้งาน และการกำหนดค่าของ daemon

เริ่ม 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]"

เริ่ม daemon:

libre-claw start

แดชบอร์ดและ API เริ่มต้นอยู่ที่:

http://127.0.0.1:8766/dashboard

จากนั้นเปิด Libre WebUI → Libre Claw

สภาพแวดล้อมของ backend​

Libre WebUI ใช้ URL daemon ในเครื่องตามค่าเริ่มต้น:

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

ตั้ง LIBRE_CLAW_BASE_URL หาก daemon รันบนโฮสต์อื่น IP ของ Tailscale หรือบริการในเครื่องที่อยู่หลัง reverse proxy

เส้นทาง WebUI​

ทุกเส้นทาง Libre Claw ต้องใช้ผู้ดูแลระบบที่ยืนยันตัวตน เพราะอาจเปิดเผยเส้นทางไฟล์ในเครื่องและเริ่มงานตัวแทน:

เส้นทาง WebUIฟีเจอร์ Libre Claw
GET /api/libre-claw/statusสถานะ daemon, base 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/:idmetadata และ 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 ปกติ
  • รอบเป้าหมาย — โหมด autopilot ที่มีขอบเขต ซึ่ง Libre Claw จะทำต่อจนตัวตัดสินทำเครื่องหมายว่าเป้าหมายเสร็จหรือถึงขีดจำกัดที่กำหนด

ค่า override ผู้ให้บริการ/โมเดลที่เป็นทางเลือกจะถูกส่งไปยัง Libre Claw สำหรับรอบนั้น หากไม่ระบุ Libre Claw จะใช้ผู้ให้บริการและโมเดลเริ่มต้นที่กำหนดไว้

การอนุมัติ​

เมื่อ Libre Claw ขอสิทธิ์ WebUI จะแสดงการเรียกเครื่องมือที่รออยู่และให้ผู้ดูแลระบบเลือก:

  • allow_once
  • deny
  • always_allow_tool

Libre Claw ยังคงเป็นเจ้าของรูปแบบสิทธิ์และการตรวจสอบความปลอดภัย WebUI เพียงบันทึกตัวเลือกของผู้ดูแลระบบผ่าน API ของ daemon

การทำงานอัตโนมัติ​

Libre WebUI สามารถสร้างและจัดการการทำงานอัตโนมัติของ daemon Libre Claw:

  • การทำงานอัตโนมัติสำหรับรายงาน
  • การทำงานอัตโนมัติที่ส่งผ่าน Telegram
  • พัก/ทำต่อ
  • รันทันที
  • ลบ

สิ่งเหล่านี้เป็นการทำงานอัตโนมัติของ Libre Claw ไม่ใช่งาน cron ของโฮสต์ รายงานและประวัติการทำงานยังอยู่ในที่เก็บการรันของ Libre Claw

หน่วยความจำ ทักษะ Soul และเครื่องมือ​

หน่วยความจำ ทักษะ ไฟล์ soul, เครื่องมือ MCP, เครื่องมือเบราว์เซอร์, SearXNG, Petdex และ Telegram จะกำหนดค่าใน Libre Claw เอง WebUI แสดงและควบคุมฟีเจอร์ที่หันเข้าหา daemon โดยไม่ทำซ้ำระบบกำหนดค่าภายในของ Libre Claw

คำสั่ง Libre Claw ที่มีประโยชน์:

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

การแก้ปัญหา​

WebUI แสดง "Libre Claw daemon is not connected"​

เริ่ม daemon:

libre-claw start

หรือตั้ง URL ของ backend:

LIBRE_CLAW_BASE_URL=http://127.0.0.1:8766

ปุ่มอนุญาตไม่ทำงาน​

รอบอาจเสร็จแล้ว หรือสิทธิ์อาจถูกจัดการจากพื้นที่อื่น เช่น แดชบอร์ด Libre Claw หรือ Telegram bridge ให้รีเฟรชหน้า WebUI และตรวจ timeline ของรอบ

เครื่องมือถูกปฏิเสธ​

ตัวจัดการสิทธิ์ของ Libre Claw เป็นแหล่งตัดสิน ตรวจการกำหนดค่าและเหตุการณ์การรันของ Libre Claw หากการเรียกถูกปฏิเสธก่อน WebUI เห็นคำขออนุมัติ

การทำงานอัตโนมัติไม่ทำงาน​

ตรวจสถานะ daemon และการกำหนดค่าการทำงานอัตโนมัติของ Libre Claw:

libre-claw status
libre-claw start

daemon ต้องทำงานเพื่อให้การทำงานอัตโนมัติตามกำหนดเวลาและการส่งผ่าน Telegram ทำงาน

เอกสารที่เกี่ยวข้อง​