前提条件
- 管理者権限を持つ DingTalk アカウント
- LemonClaw インスタンス:
- ホスト型: Claw インスタンスを作成する
- セルフホスト型: LemonClaw をインストールする
セットアップガイド
DingTalk アプリの作成
- DingTalk Open Platform にアクセスします
- Application Development → Enterprise Internal Development をクリックします
- Create Application をクリックします
- アプリ名と説明を入力します
- Confirm をクリックします
ロボット機能の有効化
- アプリ内で App Features → Robot に移動します
- ロボット設定を有効にします
- Stream Mode を選択します（推奨 — パブリック URL は不要です）
- Publish をクリックします
アプリの公開
- Version Management に移動します
- 新しいバージョンを作成します（少なくともテストバージョン）
- 公開範囲（どのユーザー/部門がボットを表示できるか）を設定します
- 送信して公開します
LemonClaw WebUI を開く
- ホスト型の Claw を使用している場合は、Claw Dashboard に移動し、Open WebUI をクリックします
- LemonClaw をセルフホストしている場合は、自身の WebUI（例:
http://your-ip:18789）を開き、トークンでサインインします - WebUI で Settings → Channels に移動します
- DingTalk セクションを展開します
- AppKey と AppSecret を貼り付けます
- Save をクリックします
グループ設定
LemonClaw WebUI の Channels 設定でグループチャットの動作を設定します:| 設定 | オプション | 説明 |
|---|---|---|
| Group Policy | Open (デフォルト) / Allowlist / Disabled | グループ内で誰がボットを起動できるかを制御します |
| Group Allowed Users | ユーザー ID のリスト | これらのユーザーのみがボットを起動できます（Allowlist モード） |
DingTalk では、グループ内でボットを起動するために常に @メンションが必要です。これはプラットフォームの制限であり、設定で変更することはできません。DingTalk ではグループ ID によるフィルタリングは利用できません。アクセス制御には Group Policy 設定を使用してください。
トラブルシューティング
現在の LemonClaw の DingTalk サポートは、まだ完全なグループワークベンチ統合ではありません。グループメッセージは bot への @ がある場合にのみ AI フローへ入り、返信は元の sessionWebhook を優先します。
ボットが応答しない
ボットが応答しない
- AppKey と AppSecret が正しいか確認してください
- アプリが公開されているか確認してください（少なくともテストバージョン）
- ロボット設定で Stream Mode が選択されていることを確認してください
- ボットがユーザーアカウントから見える状態であることを確認してください
接続が頻繁に切れる
接続が頻繁に切れる
- Stream モードは永続的な WebSocket 接続を維持します
- 一時的な切断は正常です。ボットは自動的に再接続します
- 問題が解決しない場合は、ダッシュボードからインスタンスを再起動してみてください