Libre WebUI 集成

将 Libre WebUI 连接到 Libre Claw 守护进程,获得具有运行时间线、内联工具审批、自动化和提供商用量的浏览器控制界面。

Libre Claw 的浏览器控制界面。

Libre WebUI 是 Kroonen AI 构建的隐私优先、自托管 AI 聊天界面。从 0.12 版本开始,它提供一流的 Libre Claw 代理界面:专用侧边栏条目、/agents 路由和代理本地守护进程的管理员专用后端路由。你的代理运行时、安全模型、记忆、工具和定时任务留在 Libre Claw 中;Libre WebUI 在上面添加浏览器。

源码和设置位于 github.com/libre-webui/libre-webui, 集成指南 (31-LIBRE_CLAW_INTEGRATION.md) 31-LIBRE_CLAW_INTEGRATION.md.

启动守护进程

Libre WebUI 通过 localhost 与 Libre Claw 守护进程通信。照常启动,然后在 WebUI 中打开代理页面。

启动 Libre Claw
libre-claw start
# daemon listens at:
http://127.0.0.1:8766

然后打开 Libre WebUI → Libre Claw 连接到 http://127.0.0.1:8766.

将 WebUI 指向自定义守护进程

如果守护进程运行在另一主机或端口,在启动 Libre WebUI 前设置后端环境变量。

backend/.env
LIBRE_CLAW_BASE_URL=http://127.0.0.1:8766
LIBRE_CLAW_TIMEOUT_MS=30000

重启 WebUI 后端使新值生效。

代理页面能做什么

Run timelines

启动聊天或目标模式运行,传递提供商/模型覆盖,流式传输增量事件,检查工具调用和结果,并取消活动运行。

Inline approvals

从浏览器解决工具权限请求:允许一次、拒绝或始终允许工具,无需离开页面。

Automations

创建、更新、立即运行、暂停、恢复和删除定时报告和 Telegram 路由。

Usage

从同一代理页面检查提供商用量记录和回退路由状态。

Model routing

通过管理员专用代理路由切换活动提供商和模型,并审查回退槽。

Daemon status

无需离开 Libre WebUI 即可查看连接状态、健康和仪表盘 URL。

如何组合在一起

Libre WebUI 是浏览器;Libre Claw 是运行时。WebUI 的后端调用 /api/libre-claw 下的管理员专用路由来代理守护进程 — 代理、记忆或安全模型没有重复。审批、持久运行、JSONL 日志和定时任务都仍在 Libre Claw 中。

仅限管理员

Libre Claw 代理路由仅限管理员。全新 Libre WebUI 安装上创建的第一个账户成为管理员,因此代理界面受到与应用其余部分相同的认证保护。