Communityコーディング&開発github.com

hec-ovi/telegram-bot-skill

ローカルのCLIコーディングエージェント(Claude Code、opencode、Codex、Gemini)をTelegramボットとして公開します。ゼロ依存のNode 24コア、決定論的アクセスゲートによる階層化権限、ハーネスレベルのツールゲーティング、QRコードオンボーディングを備えています。

telegram-bot-skill とは?

このスキルは、ローカルで動作するCLIベースのAIコーディングエージェント(Claude Code、opencode、Codex、Geminiなど)を、Telegramボットとして外部から利用可能にするためのツールです。ゼロ依存のNode 24コアで実装されており、軽量かつ高速に動作します。決定論的アクセスゲート機構により、ユーザーごとに階層化された権限(例:読み取り専用、特定のコマンドのみ許可、フルアクセス)を設定でき、セキュリティを確保しながら柔軟な運用が可能です。また、ハーネスレベルでのツールゲーティングにより、エージェントが実行できるアクションを細かく制御できます。オンボーディングはQRコードを使って簡単に行え、複数のユーザーが同時にボットを利用するのに適しています。主に開発チーム内でのAIエージェント共有や、リモートからのコードレビュー・実行環境として有用です。

対応✓Claude Code✓Codex CLI~Cursor✓Gemini CLI✓OpenCode
Part ofMobile
npx skills add hec-ovi/telegram-bot-skill

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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コーディングエージェント

クイックスタート

  1. リポジトリをクローンし、ディレクトリに移動します:

    git clone https://github.com/hec-ovi/telegram-bot-skill.git
    cd telegram-bot-skill
    
  2. 環境変数 TELEGRAM_BOT_TOKEN にあなたのボットトークンを設定します:

    export TELEGRAM_BOT_TOKEN="YOUR_BOT_TOKEN"
    
  3. 設定ファイル(例: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"]
      }
    }
    
  4. アプリケーションを起動します:

    node index.js
    
  5. QRコードを生成してユーザーをオンボーディングします:

    node generate-qr.js
    

設定

  • config.json: アクセスゲートルールとツールゲーティングの設定
  • .env: 環境変数(例:TELEGRAM_BOT_TOKEN)

セキュリティ

  • 決定論的アクセスゲートにより、権限のないユーザーはコマンドを実行できません。
  • ツールゲーティングにより、エージェントが危険な操作を行うのを防ぎます。
  • QRコードオンボーディングにより、安全な認証フローを提供します。

ライセンス

MIT

関連スキル