前提条件
- WhatsAppがインストールされ、アクティブなアカウントを持つスマートフォン
- LemonClawインスタンス:
- ホスト型: Clawインスタンスを作成する
- セルフホスト型: LemonClawをインストールする
セットアップガイド
LemonClaw WebUIを開く
- ホスト型のClawを使用している場合は、Claw Dashboardに移動し、Open WebUIをクリックします
- LemonClawをセルフホストしている場合は、自身のWebUI(例:
http://your-ip:18789)を開き、tokenでサインインします - WebUIで、Settings → Channelsに移動します
- WhatsAppセクションを展開します
- Access Policyを設定します(allowlistを推奨)
- 最初にSaveをクリックしてください。QRコードをスキャンする前に設定を保存する必要があります
QRコードをスキャンする
- Scan QR Codeボタンをクリックします
- QRコードが表示されます(有効期限は約60秒間です)
- スマートフォンのWhatsAppで、Settings → Linked Devices → Link a Deviceを開きます
- 画面に表示されたQRコードをスキャンします
- 接続が確立されるまで待ちます
Access Policyの設定
WhatsAppはallowlistポリシーを使用します。指定した電話番号のみがAIボットと対話できます。LemonClaw WebUIで許可された電話番号を追加します(国際形式、例:
+1234567890)。グループ設定
WhatsAppグループがサポートされています。LemonClaw WebUI の Channels 設定でグループの動作を設定します:| 設定 | オプション | 説明 |
|---|---|---|
| Group Policy | Open (デフォルト) / Allowlist / Disabled | グループ内で誰がボットをトリガーできるかを制御します |
| Require @mention | On / Off | ボットは@mentionされた時のみ応答します |
| Group IDs | グループJIDのリスト | 特定のグループに制限します(空の場合はすべてのグループ) |
| Group Allowed Users | 電話番号のリスト | これらのユーザーのみがボットをトリガーできます(allowlistモード) |
トラブルシューティング
QRコードの期限切れ
QRコードの期限切れ
もう一度Scan QR Codeをクリックして、新しいコードを生成してください。QRコードは約60秒後に期限切れになります。
WhatsAppが切断された
WhatsAppが切断された
WhatsAppは、非アクティブな状態が続くとリンクされたデバイスを切断する場合があります。QRコードを再スキャンして再接続してください。
メッセージにAIの応答がない
メッセージにAIの応答がない
- 送信者の番号がallowlistに含まれているか確認してください(allowlistポリシーを使用している場合)
- インスタンスが実行されていることを確認してください
- LemonDataの残高を確認してください