前提条件
セットアップガイド
Feishu アプリの作成
- Feishu オープンプラットフォーム (または Lark Developer) にアクセスします
- カスタムアプリを作成 をクリックします
- アプリ名と説明を入力します
- 作成 をクリックします
イベント購読の設定
- イベント購読 に移動します
- WebSocket モードを選択します (推奨 — 公開 URL は不要です)
- プロンプトが表示されたら、Encrypt Key と Verification Token を設定します
イベント権限の追加
- イベント購読の下で、以下のイベントを追加します:
im.message.receive_v1— メッセージの受信
- 権限とスコープ に移動し、以下を追加します:
im:message— メッセージの送受信im:message.group_at_msg— グループ内での @メンションの受信
- 保存 をクリックします
アプリの公開
- アプリのリリース → バージョン管理 に移動します
- 新しいバージョンを作成します
- レビューを申請します (社内アプリの場合、通常は即座に承認されます)
- 承認されると、アプリが公開されます
LemonData ダッシュボードでの設定
- Claw ダッシュボード にアクセスします
- インスタンスの設定アイコンをクリックします
- IM Integrations タブを開きます
- Feishu セクションを展開します
- App ID と App Secret を貼り付けます
- 自動生成された Encrypt Key と Verification Token を Feishu 開発者コンソールにコピーして戻します
- 保存 をクリックします
グループ設定
ダッシュボードの IM Integrations タブでグループチャットの動作を設定します:| 設定 | オプション | 説明 |
|---|---|---|
| Group Policy | 公開 (デフォルト) / ホワイトリスト / 無効 | グループ内で誰がボットを起動できるかを制御します |
| Require @mention | オン / オフ | ボットは @メンションされた時のみ応答します |
| Group IDs | チャット ID のリスト | 特定のグループに制限します (空の場合はすべてのグループ) |
| Group Allowed Users | Open ID のリスト | これらのユーザーのみがボットを起動できます (ホワイトリストモード) |
トラブルシューティング
ボットがメッセージを受信しない
ボットがメッセージを受信しない
- アプリが公開され、承認されているか確認してください
im.message.receive_v1イベントが購読されているか確認してください- WebSocket モードが選択されていることを確認してください (HTTP ではなく)
- Feishu コンソールと Claw 設定の間で Encrypt Key と Verification Token が一致しているか確認してください
'app_ticket' エラー
'app_ticket' エラー
- これは通常、App ID または App Secret が正しくないことを意味します
- ダッシュボードの認証情報を再確認してください