前提条件
- WeCom の管理者アカウント
- LemonClaw インスタンス:
- ホスト型: Claw インスタンスを作成する
- セルフホスト型: LemonClaw をインストールする
セットアップガイド
WeCom アプリの作成
- WeCom 管理コンソールにログインします
- アプリ管理 → アプリを作成 に移動します
- アプリ名を入力し、ロゴをアップロードして、表示範囲を設定します
- 作成 をクリックします
コールバック URL の設定
- アプリ設定で メッセージ受信 → API 受信設定 に移動します
- ホスト型 Claw の場合、WeCom セクションを展開すると LemonClaw WebUI にコールバック URL が表示されます:
- セルフホスト型 LemonClaw の場合、
/webhook/wecomで終わる独自の公開 HTTPS URL を公開します - Token (ランダムな文字列) と EncodingAESKey (43文字のランダムな文字列) を設定します
- 保存 をクリックします — WeCom がコールバック URL を検証します
LemonClaw WebUI を開く
- ホスト型 Claw を使用している場合は、Claw ダッシュボードに移動し、WebUI を開く をクリックします
- LemonClaw をセルフホストしている場合は、独自の WebUI (例:
http://your-ip:18789) を開き、token でサインインします - WebUI で 設定 → IM 統合 に移動します
- WeCom セクションを展開します
- ホスト型 Claw を使用している場合は上部に表示されている Callback URL をコピーし、セルフホストしている場合は独自の公開 webhook URL を入力します
- Corp ID、Corp Secret、Token、EncodingAESKey を入力します
- 保存 をクリックします
トラブルシューティング
現在の LemonClaw の WeCom サポートはユーザー単位の 1:1 メッセージングです。完全なグループ mention、スレッド、返信セマンティクスはまだ利用できません。
コールバック URL の検証に失敗する
コールバック URL の検証に失敗する
- LemonClaw インスタンスが実行されていることを確認してください
- URL 形式を確認してください:
https://claw-{subdomain}.lemondata.cc/webhook/wecom - WeCom で検証する前に、Token と EncodingAESKey が LemonClaw の設定に保存されていることを確認してください
ボットが応答しない
ボットが応答しない
- Corp ID と Corp Secret が正しいことを確認してください
- アプリがユーザーアカウントに表示されていることを確認してください (表示範囲の設定)
- WeCom と LemonClaw の間で Token と EncodingAESKey が一致していることを確認してください