メインコンテンツへスキップ
飛書（Feishu）の企業向けカスタムアプリを通じて CowAgent を接続。1 対 1 チャット、グループチャット（@メンション）に対応。WebSocket 長接続を使用するため公開 IP 不要、ストリーミングのタイプライター応答や音声メッセージにも対応します。
接続には管理者権限を持つ Feishu 企業ユーザーが必要です。

​
1. 接続方法

​
方式 1: ワンクリック作成（推奨）

事前に Feishu 開発者プラットフォームでアプリを作成する必要はありません。Cow を起動後、Web コンソール（既定 http://127.0.0.1:9899/）を開き、チャネル メニュー → チャネルを追加 → Feishu を選択し、QR スキャン タブで ワンクリックで Feishu アプリを作成 をクリック。Feishu アプリ で QR コードをスキャンするとアプリ作成と接続が自動完了します。
作成されたアプリには必要な権限（メッセージ送受信、カード読み書き、グループイベントなど）とイベント購読がすべて事前設定されています。現在は Feishu 中国版のみ対応で、Lark 国際版は未対応です。
CLI から feishu_app_id 未設定で起動した場合は、ターミナルにも QR コードが表示されます。

​
方式 2: 手動作成

Feishu 開発者プラットフォームで自分でアプリを作成し、Web コンソールまたは設定ファイルから接続します。 ステップ 1: アプリ作成
  1. Feishu 開発者プラットフォーム にアクセスし、企業カスタムアプリを作成 をクリック:
  1. アプリ機能の追加 で Bot 機能を追加:
  1. 権限管理 で以下の権限を貼り付け、全選択して 一括有効化:
im:message,im:message.group_at_msg,im:message.group_at_msg:readonly,im:message.p2p_msg,im:message.p2p_msg:readonly,im:message:send_as_bot,im:resource,cardkit:card:write
  1. 認証情報と基本情報 から App ID と App Secret を取得:
ステップ 2: CowAgent に接続
Web コンソールから チャネル → チャネルを追加 → Feishu → 手動入力 タブに切り替え、App ID と App Secret を入力して接続。
ステップ 3: アプリの公開
  1. Cow 起動後、Feishu 開発者プラットフォームの イベントとコールバック で ロングコネクション モードを選択して保存:
  1. イベントを追加 で「メッセージ受信」を検索し、メッセージ受信 v2.0 を選択。
  2. バージョン管理とリリース で新バージョンを作成し 本番リリース を申請、Feishu クライアントで承認:

​
2. 機能一覧

機能対応状況
1 対 1 チャット✅
グループチャット（@Bot）✅
テキストメッセージ✅ 送受信
画像メッセージ✅ 送受信
音声メッセージ✅ 送受信
ストリーミング応答✅（Feishu cardkit ストリーミングカードベース）
ストリーミング応答には cardkit:card:write 権限（ワンクリック作成では自動付与）と Feishu クライアント 7.20 以上が必要です。古いクライアントではアップグレード案内が表示され、権限/バージョン未充足時は通常テキスト応答に自動フォールバックします。

​
3. 使い方

接続完了後、Feishu で Bot 名を検索してチャットを開始できます。 グループで使う場合は Bot をグループに追加し、@メンションでメッセージを送ってください。