mcpField
F
feishu-connection

feishu-connection

github.com/xiaomingx生産性795 回インストール39 週間前に更新
リポジトリ

feishu-connection について

ローカル WebSocket 経由で Feishu ボットのメッセージを Clawdbot Gateway に転送し、各 Feishu チャットを Clawdbot セッションに対応付けるブリッジです。インバウンドポートやパブリック IP を用意せず、Feishu の会話を AI エージェントに接続したい場合に使えます。

主な機能

  1. 01Feishu と Clawdbot Gateway の接続
  2. 02チャットと Clawdbot セッションの対応付け
  3. 03Feishu SDK によるアウトバウンド接続
  4. 04グループメッセージへの返信条件設定
  5. 05macOS サービスとしての起動

活用シーン

  1. 01Feishu チャットを Clawdbot エージェントへ転送
  2. 02Feishu グループ内のボットメッセージ処理
  3. 03ブリッジの macOS サービス運用

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/xiaomingx/moltbot-connector-feishu-dingtalk --skill feishu-connection

インストール後、Claude Code で/feishu-connectionを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

.env.example
bridge.py
pyproject.toml
README.md
setup_service.py

詳細

Feishu ブリッジ

Feishu ボットのメッセージを、ローカル WebSocket 経由で Clawdbot Gateway に中継します。

アーキテクチャ

Feishu user → Feishu cloud ←WS→ bridge.py (local) ←WS→ Clawdbot Gateway → AI agent
  • Feishu SDK はアウトバウンド接続します（インバウンドポートやパブリック IP は不要です）
  • ブリッジは既存のゲートウェイトークンを使って Gateway に認証します
  • Feishu の各チャットは Clawdbot セッション（feishu:<chatId>）に対応します

セットアップ

1. Feishu ボットを作成する
  1. open.feishu.cn/app に移動 → セルフビルドアプリを作成 → ボット機能を追加
  2. 権限を有効にします：im:message、im:message.group_at_msg、im:message.p2p_msg
  3. イベント：im.message.receive_v1 を追加し、配信方法をWebSocket 長時間接続に設定します
  4. アプリを公開します（バージョンを作成 → 承認を申請）
  5. App ID と App Secret を控えます
2. シークレットを保存する
mkdir -p ~/.clawdbot/secrets
echo "YOUR_APP_SECRET" > ~/.clawdbot/secrets/feishu_app_secret
chmod 600 ~/.clawdbot/secrets/feishu_app_secret
3. インストールして実行する
cd <skill-dir>/feishu-connection
uv sync
FEISHU_APP_ID=cli_xxx uv run python bridge.py
4. 自動起動（macOS）
FEISHU_APP_ID=cli_xxx uv run python setup_service.py
launchctl load ~/Library/LaunchAgents/com.clawdbot.feishu-bridge.plist

診断

# Check service
launchctl list | grep feishu

# Logs
tail -f ~/.clawdbot/logs/feishu-bridge.err.log

# Stop
launchctl unload ~/Library/LaunchAgents/com.clawdbot.feishu-bridge.plist

グループチャットでの動作

ブリッジは、ユーザーがボットに @ メンションした場合、メッセージが ?／？ で終わる場合、依頼を表す動詞（帮／请／分析／总结…）が含まれる場合、またはボットの名前で呼びかけた場合にのみ返信します。名前のリストは bridge.py → should_respond_in_group() でカスタマイズできます。

環境変数

変数必須デフォルト
FEISHU_APP_ID✅—
FEISHU_APP_SECRET_PATH—~/.clawdbot/secrets/feishu_app_secret
CLAWDBOT_CONFIG_PATH—~/.clawdbot/clawdbot.json
CLAWDBOT_AGENT_ID—main
FEISHU_THINKING_THRESHOLD_MS—2500

コメント

Markdown 対応