前提条件
- 開発者アクセス権限を持つ Feishu または Lark アカウント
- LemonClaw インスタンス:
- ホスト型: Claw インスタンスを作成する
- セルフホスト型: LemonClaw をインストールする
セットアップガイド
Feishu アプリを作成する
- Feishu オープンプラットフォーム (または Lark デベロッパー) にアクセスします
- Create Custom App をクリックします
- アプリ名と説明を入力します
- Create をクリックします
イベント購読を設定する
- Event Subscriptions に移動します
- WebSocket モードを選択します (推奨 — パブリック URL は不要です)
- プロンプトが表示されたら、Encrypt Key と Verification Token を設定します
イベント権限を追加する
- Event Subscriptions の下で、以下のイベントを追加します:
im.message.receive_v1— メッセージの受信
- Permissions & Scopes に移動し、以下を追加します:
im:message— メッセージの送信と受信im:message.group_at_msg— グループ内での @メンションの受信
- Save をクリックします
アプリを公開する
- App Release → Version Management に移動します
- 新しいバージョンを作成します
- レビューを申請します (社内アプリの場合、通常は即座に完了します)
- 承認されると、アプリが公開されます
LemonClaw WebUI を開く
- ホスト型の Claw を使用している場合は、Claw ダッシュボードに移動し、Open WebUI をクリックします
- LemonClaw をセルフホストしている場合は、自身の WebUI (例:
http://your-ip:18789) を開き、token でサインインします - WebUI で、Settings → Channels に移動します
- Feishu セクションを展開します
- App ID と App Secret を貼り付けます
- 自動生成された Encrypt Key と Verification Token を Feishu デベロッパーコンソールにコピーして戻します
- Save をクリックします
グループ設定
LemonClaw WebUI の Channels 設定で、グループチャットの動作を設定します:| 設定 | オプション | 説明 |
|---|---|---|
| Group Policy | Open (デフォルト) / Allowlist / Disabled | グループ内で誰が Bot を起動できるかを制御します |
| Require @mention | On / Off | Bot は @メンションされた時のみ応答します |
| Group IDs | チャット ID のリスト | 特定のグループに制限します (空の場合はすべてのグループ) |
| Group Allowed Users | Open ID のリスト | これらのユーザーのみが Bot を起動できます (allowlist モード) |
トラブルシューティング
Bot がメッセージを受信しない
Bot がメッセージを受信しない
- アプリが公開され、承認されているか確認してください
im.message.receive_v1イベントが購読されているか確認してください- WebSocket モードが選択されていることを確認してください (HTTP ではなく)
- Feishu コンソールと LemonClaw 設定の間で Encrypt Key と Verification Token が一致しているか確認してください
'app_ticket' エラー
'app_ticket' エラー
- これは通常、App ID または App Secret が正しくないことを意味します
- ダッシュボードの認証情報を再確認してください