概要

mini-claw は、Telegram 上で持続的（Persistent）な AI 会話を実現するための軽量なボット実装です。pi-mono（Pi coding agent）と連携して、Claude Pro/Max や ChatGPT Plus の個人サブスクリプションを直接利用することを目的としており、API 利用料を発生させずに高度なモデルを利用できます。会話は保存され、自動で圧縮（auto-compaction）して履歴を管理。さらにワークスペース（作業ディレクトリ）移動やサーバ上コマンド実行をサポートすることで、対話を通じた操作や開発支援が可能な点が特徴です。

リポジトリの統計情報

スター数: 13
フォーク数: 1
ウォッチャー数: 13
コミット数: 5
ファイル数: 12
メインの言語: TypeScript

主な特徴

Persistent Sessions: 会話を保存して永続化、一定条件で自動圧縮して履歴を管理
Workspace Navigation: /cd でディレクトリ移動、/shell でサーバ上のコマンド実行を可能に
Session Management: セッションのアーカイブ、切り替え、古い履歴のクリーンアップ機能
API コスト不要: Claude/ChatGPT の個人契約を直接利用することで外部 API に対する課金を回避

技術的なポイント

mini-claw は TypeScript（Node.js）で実装されたシンプルな Telegram ボットで、pi-mono（Pi coding agent）を介してエンドユーザーの Claude/ChatGPT サブスクリプションを利用する設計になっています。pi-mono の利用により「自分のサブスクリプションを経由してモデルを呼ぶ」方式を採用し、外部 API のリクエスト課金を避けられるのが最大の利点です。README にある機能から想定される技術構成は次の通りです。

通信基盤: Telegram Bot API を用いたメッセージ受信・送信、TypeScript でボットロジックを実装。
モデル連携: pi-mono（外部リポジトリ）と連携して Claude/ChatGPT とやり取り。pi-mono 側でブラウザ操作やセッション管理を行い、mini-claw はそれを呼び出す役割を果たす想定。
永続化: 会話セッションの保存と自動圧縮（auto-compaction）機能。実装はファイルベースや軽量なストレージ（SQLite 等）を想定でき、不要なトークンを削減して会話履歴を維持する設計が組み込まれている模様です。
ワークスペース / シェル操作: /cd コマンドでワークディレクトリを切り替え、/shell でコマンド実行が可能。これは開発支援やリモート操作に便利ですが、セキュリティリスク（任意コマンド実行）を伴うため、実運用では認可・権限制御、ログ記録、サニタイズが必須です。
設定とデプロイ: .env.example があるため環境変数で Telegram トークンや pi-mono のエンドポイント／認証情報を管理する想定。Makefile が用意されているので、セットアップやビルド、起動の自動化が簡易に行える設計です。
ドキュメント: CLAUDE.md が含まれており、Claude を使う際の注意点や設定がまとめられている可能性が高いです。README は機能説明と基本的な使い方を提供します。

拡張性の面では、mini-claw のミニマルなコードベースはカスタマイズしやすく、例えば認証付きの管理インターフェース追加、セッションストアの外部化（Redis / DB）、あるいはマルチユーザー・マルチセッションの強化などが行いやすい構造が期待できます。一方で、/shell のような機能は安全性を脅かすため、運用前にアクセス制御や監査機構を厳格に適用することを推奨します。

プロジェクトの構成

主要なファイルとディレクトリ：

.env.example: file
.gitignore: file
CLAUDE.md: file
Makefile: file
README.md: file

…他 7 ファイル

まとめ

シンプルかつ実用的な Telegram ベースの AI 会話ボット。個人サブスクを活かして低コストで運用したい開発者に適する。

リポジトリ情報：

名前: mini-claw
説明: minimalism alternative of OpenClaw
スター数: 13
言語: TypeScript
URL: https://github.com/htlin222/mini-claw
オーナー: htlin222
アバター: https://avatars.githubusercontent.com/u/61491860?v=4

READMEの抜粋：

Mini-Claw

Lightweight Telegram bot for persistent AI conversations using Pi coding agent.

A minimalist alternative to OpenClaw - use your Claude Pro/Max or ChatGPT Plus subscription directly in Telegram, no API costs.

Features

Persistent Sessions - Conversations are saved and auto-compacted
Workspace Navigation - Change directories with /cd, run shell commands with /shell
Session Management - Archive, switch, and clean up old …

mini-claw — 軽量な OpenClaw 代替の Telegram 向け AI ボット