moltbotCNAPP — ClawdBot と国内 IM のブリッジ
概要
ClawdBot Gateway(ローカルで稼働する AI エージェントのゲートウェイ)と、飛書(Feishu)などの中国国内 IM プラットフォームをつなぐブリッジ実装です。Go 言語で書かれており、Feishu の企業自建アプリの App ID / App Secret を用いた認証や webhook 受信を通じて受信イベントを取り込み、ローカルの ClawdBot に対して会話やコマンドを仲介します。配布は事前ビルドのバイナリが用意され、Go 1.21+ を想定しています。MIT ライセンスで公開されているため、カスタマイズや社内導入もしやすく設計されています。
リポジトリの統計情報
- スター数: 29
- フォーク数: 2
- ウォッチャー数: 29
- コミット数: 6
- ファイル数: 10
- メインの言語: Go
主な特徴
- 飛書(Feishu)など国内 IM と ClawdBot Gateway をシームレスに連携するブリッジ
- Go で実装され、事前ビルドバイナリにより簡単にデプロイ可能
- ClawdBot Gateway をローカル(デフォルト port 18789)で利用する構成をサポート
- MIT ライセンスで商用・非商用利用や改変が可能
技術的なポイント
このプロジェクトは「IM プラットフォーム側のイベント受信」と「ローカルの ClawdBot Gateway への転送」を主軸にしたブリッジアプリです。技術的には主に以下の要素が関係します。
-
Webhook ハンドリング: 飛書のようなプラットフォームはイベント通知を webhook で行うため、HTTP サーバを起動して受信イベント(メッセージ受信、イベント通知など)をパースします。受信時に署名検証や認証トークンのチェックを行い、不正なリクエストを排除する実装が想定されます。
-
認証とトークン管理: 飛書の企業自建アプリは App ID / App Secret による認証が必要です。短期トークンの取得と更新(キャッシュ)や、API 呼び出し時のヘッダ設定など、安定した認証フローの実装が重要になります。
-
ClawdBot Gateway 連携: README にあるようにローカルで稼働する ClawdBot Gateway(デフォルト 18789)に対して、受信イベントを元に会話の開始、応答取得、コンテキスト管理などのリクエストを送ります。HTTP API を使ったシンプルな同期/非同期通信やリトライ、エラーハンドリングが設計ポイントです。
-
設定ファイルと運用: ClawdBot の設定はユーザーディレクトリ(例: ~/.clawdbot/clawdbot.json)に置くことが想定され、接続先や認証情報は環境変数や設定ファイルで管理できます。Makefile や事前ビルドバイナリにより、ビルドと配布の運用が簡素化されています。
-
セキュリティとネットワーク: ブリッジは外部 IM からのコールを受けるため TLS 設定、公開 URL(リバースプロキシやトンネリング)、および内部の ClawdBot との通信のアクセス制御を整備する必要があります。また、ログ/監査とメッセージのプライバシー保護(不要なデータのマスクなど)も考慮すべき点です。
リポジトリは比較的小規模で、Go 1.21+ を前提にしたシンプルな実装が意図されています。導入は既存の ClawdBot Gateway をローカルで稼働させ、Feishu 側で企業自建アプリを作り、App ID / App Secret を用意することから始めます。これにより国内向け IM を通じて ClawdBot の機能を社内チャットに組み込むユースケース(自動応答、社内向け AI アシスタントなど)に適しています。
プロジェクトの構成
主要なファイルとディレクトリ:
- .github: dir
- .gitignore: file
- LICENSE: file
- Makefile: file
- README.md: file
…他 5 ファイル
まとめ
ClawdBot と国内 IM をつなぐ実用的なブリッジ。設定と運用が簡単で社内導入に向く。
リポジトリ情報:
- 名前: moltbotCNAPP
- 説明: 説明なし
- スター数: 29
- 言語: Go
- URL: https://github.com/wy51ai/moltbotCNAPP
- オーナー: wy51ai
- アバター: https://avatars.githubusercontent.com/u/253894366?v=4
READMEの抜粋:
ClawdBot Bridge
连接飞书等国内 IM 平台与 ClawdBot AI Agent 的桥接服务。
前置要求
- ClawdBot Gateway 正在本地运行(默认端口 18789,配置在
~/.clawdbot/clawdbot.json) - 飞书企业自建应用的 App ID 和 App Secret
安装
预编译二进制
Linux (amd64)
curl -sLO https://github.com/wy51ai/moltbotCNAPP/releases/latest/download/clawdbo...