telegram-bot-skill は何をしますか?
ローカルのCLIコーディングエージェント(Claude Code、opencode、Codex、Gemini)をTelegramボットとして公開します。ゼロ依存のNode 24コア、決定論的アクセスゲートによる階層化権限、ハーネスレベルのツールゲーティング、QRコードオンボーディングを備えています。
機能
- Telegramボットとして公開: ローカルで動作するAIコーディングエージェントを、Telegramを介したインターフェースで利用可能にします。
- ゼロ依存: Node 24のネイティブモジュールのみを使用して構築されており、インストールや依存関係の管理が不要です。
- 決定論的アクセスゲート: ユーザー権限を階層的に管理し、読み取り専用、コマンド制限、フルアクセスなどのレベルを設定できます。
- ツールゲーティング: エージェントが利用できるツールをハーネスレベルで制御し、安全性を高めます。
- QRコードオンボーディング: 新しいユーザーの追加が簡単で、QRコードを介して認証・設定を行えます。
対応プラットフォーム
- Claude Code
- opencode
- Codex
- Gemini
必要条件
- Node.js 24 以降(ゼロ依存のため追加パッケージは不要)
- Telegram Bot Token(BotFatherから取得)
- ローカルで動作するCLIコーディングエージェント
クイックスタート
-
リポジトリをクローンし、ディレクトリに移動します:
git clone https://github.com/hec-ovi/telegram-bot-skill.git cd telegram-bot-skill -
環境変数
TELEGRAM_BOT_TOKENにあなたのボットトークンを設定します:export TELEGRAM_BOT_TOKEN="YOUR_BOT_TOKEN" -
設定ファイル(例:
config.json)でアクセスゲートルールを定義します:{ "access_gates": [ { "user_id": "USER_ID_1", "permissions": ["read", "execute"] }, { "user_id": "USER_ID_2", "permissions": ["read"] } ], "tool_gating": { "allowed_tools": ["execute_command", "read_file", "list_directory"] } } -
アプリケーションを起動します:
node index.js -
QRコードを生成してユーザーをオンボーディングします:
node generate-qr.js
設定
config.json: アクセスゲートルールとツールゲーティングの設定.env: 環境変数(例:TELEGRAM_BOT_TOKEN)
セキュリティ
- 決定論的アクセスゲートにより、権限のないユーザーはコマンドを実行できません。
- ツールゲーティングにより、エージェントが危険な操作を行うのを防ぎます。
- QRコードオンボーディングにより、安全な認証フローを提供します。
ライセンス
MIT