Libre Claw 連携

Libre WebUI には、Kroonen AI のローカルエージェントハーネス Libre Claw とのネイティブ連携が組み込まれています。Libre Claw は汎用的な completion プロバイダープラグインではなく、Libre WebUI 内の主要なエージェント画面として提供されます。

強力なエージェント機能を所有するランタイムは、引き続き Libre Claw です。

永続的な実行と JSONL イベントログ
ファイル、シェル、git、ブラウザー、HTTP、Web 検索、MCP、スケジュールの各ツール
副作用が生じる前の承認リクエスト
永続メモリとプロジェクト／ユーザースキル
ゴールモード
フォールバックモデルルート
使用量レポート
デーモンが管理する自動化と Telegram 配信
独立したローカルダッシュボード

Libre WebUI は HTTP 経由で Libre Claw デーモンと通信し、これらの機能を通常の認証済み WebUI シェル内に表示します。

インターフェイスでは、この画面をエージェントと呼びます。サイドバーのアイコン、/agents ルート、コマンドパレットの項目はすべてこの名前を使います。その背後のランタイムが Libre Claw であるため、デーモン、コマンド、環境変数については、このガイド全体で固有の名称を使います。

Libre Claw と Work の違い

Libre Claw は引き続き任意の外部ランタイムです。Libre WebUI に組み込まれた Work モードに必要なものではありません。

	Work	Libre Claw
ランタイム	Libre WebUI ネイティブのモデル／ツールループと Docker	独立した Libre Claw デーモン
主な範囲	タスクごとに 1 つの永続的で隔離されたコーディングワークスペース	より広範なエージェント実行、メモリ、承認、スケジュール、ブラウザー、MCP、ツール
永続化	SQLite のタスク履歴と、タスクが所有する Docker 名前付きボリューム	Libre Claw 独自の実行ストアとメモリストア
モデルルーティング	Ollama、Ollama Cloud、または設定済みの Libre WebUI completion/chat プラグイン	Libre Claw のプロバイダー、モデル、フォールバック設定
なくても利用できるもの	Work は通常どおり動作	切断されるのは `/agents` の Libre Claw 画面だけ

制限されたタスク専用コンテナ内でモデルにファイルを作成、変更させる場合は Work を使います。デーモンのより広範なツール群、承認システム、メモリ、ゴール、自動化が必要な場合は Libre Claw を使います。

アーキテクチャ

Libre Claw のために WebUI バックエンドがシェルコマンドやブラウザーツールを直接実行することはありません。認証済み管理者のリクエストをローカルデーモンへ中継し、デーモンの実行状態、イベント、承認、自動化、使用量、設定を表示します。

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]"

デーモンを起動します。

libre-claw start

既定のダッシュボードと API は次の場所で利用できます。

http://127.0.0.1:8766/dashboard

次に Libre WebUI → Libre Claw を開きます。

バックエンド環境

Libre WebUI は既定でローカルデーモンの URL を使います。

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

デーモンが別のホスト、Tailscale IP、リバースプロキシ経由のローカルサービスで動作している場合は、LIBRE_CLAW_BASE_URL を設定します。

WebUI ルート

Libre Claw の全ルートでは、認証済み管理者ユーザーが必要です。ローカルファイルのパスが明らかになったり、エージェントの処理が起動されたりする可能性があるためです。

WebUI ルート	Libre Claw の機能
`GET /api/libre-claw/status`	デーモンの正常性、ベース 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/: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`	自動化を削除

実行の開始

WebUI ページから次の処理を開始できます。

チャット実行 — 通常の Libre Claw エージェントターン。
ゴール実行 — Libre Claw の判定機構がゴールの完了を認定するか、設定済みの上限に達するまで処理を続ける、上限付きの自動操縦モード。

任意のプロバイダー／モデル上書きは、その実行用として Libre Claw に渡されます。省略すると、Libre Claw が設定済みの既定プロバイダーとモデルを使います。

承認

Libre Claw が権限を要求すると、WebUI は保留中のツール呼び出しを表示し、管理者は次から選択できます。

allow_once
deny
always_allow_tool

権限モデルと安全確認を所有するのは、引き続き Libre Claw です。WebUI はデーモン API を介して管理者の選択を記録するだけです。

自動化

Libre WebUI から Libre Claw デーモンの自動化を作成、管理できます。

レポート自動化
Telegram に振り分ける自動化
一時停止／再開
今すぐ実行
削除

これらはホストの cron ジョブではなく、Libre Claw の自動化です。レポートと実行履歴は Libre Claw の実行ストアに残ります。

メモリ、スキル、Soul、ツール

メモリ、スキル、soul ファイル、MCP ツール、ブラウザーツール、SearXNG、Petdex、Telegram は Libre Claw 自体で設定します。WebUI は Libre Claw の内部設定システムを複製せず、デーモン側の機能を表示、制御します。

便利な 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

またはバックエンド URL を設定します。

LIBRE_CLAW_BASE_URL=http://127.0.0.1:8766

権限ボタンを押しても反応しない

実行がすでに終了しているか、Libre Claw ダッシュボードや Telegram ブリッジなど別の画面で権限が解決済みの可能性があります。WebUI ページを更新し、実行タイムラインを確認してください。

ツールが拒否された

Libre Claw の権限マネージャーが最終的な決定権を持ちます。WebUI に承認リクエストが表示される前に呼び出しが拒否された場合は、Libre Claw 自身の設定と実行イベントを確認してください。

自動化が実行されない

Libre Claw デーモンの状態と自動化の設定を確認します。

libre-claw status
libre-claw start

スケジュール済み自動化と Telegram 配信には、デーモンが実行中である必要があります。

Libre Claw と Work の違い​

アーキテクチャ​

Libre Claw の起動​

バックエンド環境​

WebUI ルート​

実行の開始​

承認​

自動化​

メモリ、スキル、Soul、ツール​

トラブルシューティング​

WebUI に「Libre Claw daemon is not connected」と表示される​

権限ボタンを押しても反応しない​

ツールが拒否された​

自動化が実行されない​

関連ドキュメント​