文档 技能模型开发日志关于 路线图 Telegram 安全

文档

概览安装提供商仪表盘Libre WebUITelegram定时任务技能安全
GitHub Forgejo 镜像

Libre Claw

OPEN SOURCE // APACHE-2.0

一个终端原生的自主编程代理框架,面向需要真实运行、可见工具、持久记忆、Telegram 控制和本地优先安全的开发者。

开始构建 查看源码

四个界面

从终端、浏览器或手机使用同一个代理。

守护进程是重心。TUI、Libre WebUI、仪表盘、Telegram 桥接和定时任务都可以观察或恢复持久运行。

  1. 01

    TUI

    交互式

    交互式编程、文件浏览器、审批、运行时间线和产物。

    libre-claw tui
  2. 02

    DAEMON

    持久

    后台执行、仪表盘、定时任务、运行轮询和 Telegram 监管。

    libre-claw start -d
  3. 03

    TELEGRAM

    远程

    远程聊天、内联审批、模型切换、定时报告和取消。

    libre-claw telegram up
  4. 04

    WEB UI

    可视化

    Libre WebUI 添加浏览器控制界面:运行时间线、审批、自动化和用量。

    libre-claw start
本地仪表盘打开控制面板
Libre Claw 仪表盘,显示运行、定时任务、用量和审批
Telegram AI 编程代理机器人工作流
与 Libre Claw 的 Telegram 对话

为何存在

框架和模型同等重要。

Libre Claw 围绕让代理在生产中实用的部分构建:状态、审批、可恢复性、日志、成本可见性、截图和记忆。

关于 Libre Claw
  1. 01
    MESSAGETUI · WEB · TELEGRAM · CRON
  2. 02
    REASONPRIMARY + FALLBACK PROVIDERS
  3. 03
    ACTALLOW · ASK · DENY
  4. 04
    REMEMBEREVENTS · ARTIFACTS · MEMORY

本地优先

为留下可审计证据而构建。

Libre Claw 围绕让代理在生产中实用的部分构建:状态、审批、可恢复性、日志、成本可见性、截图和记忆。

01

本地优先

运行、记忆、配置和产物存放在本地主目录下。

~/.libre-claw
02

需授权

写入、Shell、浏览器操作、Git 提交和 MCP 调用都会先询问。

ALLOW / ASK / DENY
03

可审计

只追加的 JSONL 日志使每个工具调用和决策都可审查。

EVENTS.JSONL
04

可移植

技能、灵魂文件和提供商路由可在项目和模型间迁移。

SKILL.MD / SOUL.MD

需要浏览器? Libre WebUI 在同一个守护进程上添加完整的控制界面 — 查看集成.

五分钟开始

克隆、安装、运行 TUI。

一个仓库。一个守护进程。所有界面始终连接到同一个运行。

安装指南 Forgejo 镜像
bash zsh - 安装 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 -e ".[dev]"
libre-claw tui

常见问题

给评估框架的构建者的简短回答。

01Libre Claw 是本地优先的吗?

是的。运行、会话存档、记忆、配置、浏览器配置文件和产物默认存放在用户主目录下。

02支持哪些模型提供商?

Libre Claw 支持 OpenRouter、Ollama 和 Ollama Cloud、Anthropic、OpenAI、通过 Codex CLI 的 Codex OAuth,以及本地兼容端点。

03可以从 Telegram 运行 Libre Claw 吗?

可以。Telegram 桥接连接到同一个守护进程和持久运行存储,支持斜杠命令,并可以内联审批工具调用。