跳到主要内容

Libre Claw 集成

Libre WebUI 原生集成 Libre Claw，即 Kroonen AI 的本地 Agent 运行时。它在 Libre WebUI 中是一级 Agent 界面，而不是通用补全插件。

Libre Claw 继续负责持久运行和 JSONL 日志、文件/Shell/Git/浏览器/HTTP/Web 搜索/MCP/计划工具、副作用前审批、持久记忆和项目/用户技能、目标模式、备用模型路由、使用报告、Daemon 自动化与 Telegram 交付以及独立面板。

Libre WebUI 通过 HTTP 与 Daemon 通信并在已认证界面中展示这些功能。界面称为 Agent；侧边栏、/agents 和命令面板均使用该名称，而 Daemon、命令和环境变量仍保留 Libre Claw 名称。

Libre Claw 与 Work 不同​

Libre Claw 是可选外部运行时，内置 Work 不依赖它。

WorkLibre Claw
运行时Libre WebUI 原生模型/工具循环与 Docker独立 Libre Claw Daemon
主要范围每任务一个持久隔离编程工作区更广泛的工具、记忆、审批、计划、浏览器和 MCP
持久化SQLite 历史和任务 Docker Volume自有运行和记忆存储
模型路由Ollama、Ollama Cloud 或 Libre WebUI 插件Libre Claw 提供商、模型和备用配置
缺少时Work 正常运行仅 /agents 断开

需要受限容器内文件操作时使用 Work；需要更广工具、审批、记忆、目标或自动化时使用 Libre Claw。

架构​

WebUI 后端不会替 Libre Claw 直接运行 Shell 或浏览器工具，只代理管理员请求并显示状态、事件、审批、自动化、使用情况和配置。

启动 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

然后打开 Libre WebUI → Libre Claw。

后端环境​

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

Daemon 位于其他主机、Tailscale 或反向代理后时设置 LIBRE_CLAW_BASE_URL。

WebUI 路由​

所有路由都要求已认证管理员，因为可能暴露本地路径并触发工作：

WebUI 路由功能
GET /api/libre-claw/status健康和 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更新 Dashboard/TUI
GET /api/libre-claw/runs列出持久运行
POST /api/libre-claw/runs启动聊天/目标运行
GET /api/libre-claw/runs/:id元数据和制品
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删除

启动运行​

  • 聊天运行是普通 Agent 轮次。
  • 目标运行会有限自动继续，直到 Judge 判定完成或达到限制。

可按运行覆盖提供商/模型，否则使用 Libre Claw 默认配置。

审批​

WebUI 显示待审批调用，并可选择：

  • allow_once
  • deny
  • always_allow_tool

Libre Claw 始终是权限和安全的权威；WebUI 只传递管理员决定。

自动化​

Libre WebUI 可管理报告、Telegram 路由、暂停/恢复、立即运行和删除。这些是 Libre Claw 自动化而非主机 Cron，历史保存在其运行存储中。

记忆、技能、Soul 和工具​

记忆、技能、Soul 文件、MCP、浏览器、SearXNG、Petdex 与 Telegram 均在 Libre Claw 内配置。

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

故障排除​

WebUI 显示“Libre Claw Daemon 未连接”​

libre-claw start
LIBRE_CLAW_BASE_URL=http://127.0.0.1:8766

权限按钮无响应​

运行可能已结束，或已通过 Dashboard/Telegram 处理。刷新并检查时间线。

工具被拒绝​

Libre Claw 权限管理器具有最终决定权，请检查配置和运行事件。

自动化未运行​

libre-claw status
libre-claw start

计划和 Telegram 交付要求 Daemon 运行。

相关文档​