前提条件
- Telegram アカウント
- LemonClaw インスタンス:
- ホスト型: Claw インスタンスを作成する
- セルフホスト型: LemonClaw をインストールする
セットアップガイド
BotFather でボットを作成する
- Telegram を開き、@BotFather を検索します
/newbotを送信します- ボットの 表示名 を選択します (例: “My AI Assistant”)
botで終わる ユーザー名 を選択します (例:my_ai_assistant_bot)- BotFather が Bot Token を返信します。形式は以下の通りです:
LemonClaw WebUI を開く
- ホスト型の Claw を使用している場合は、Claw Dashboard に移動し、Open WebUI をクリックします
- LemonClaw をセルフホストしている場合は、自身の WebUI (例:
http://your-ip:18789) を開き、Token でサインインします - WebUI で、Settings → Channels に移動します
- Telegram セクションを展開します
- Bot Token を貼り付けます
- Save をクリックします
オプション: ボットプロフィールのカスタマイズ
ボットを作成した後、BotFather でカスタマイズできます:| コマンド | 目的 |
|---|---|
/setdescription | ボットのバイオ/説明を設定する |
/setabouttext | 「About」セクションを設定する |
/setuserpic | プロフィール画像をアップロードする |
/setcommands | コマンドの候補を追加する |
グループでの使用
グループ設定
LemonClaw WebUI の Channels 設定でグループの動作を設定します:| 設定 | オプション | 説明 |
|---|---|---|
| Group Policy | Open (デフォルト) / Allowlist / Disabled | グループ内で誰がボットを起動できるかを制御します |
| Require @mention | On / Off | ボットが @メンション されたときのみ応答します (推奨) |
| Group IDs | チャット ID のリスト | 特定のグループに制限します (空の場合はすべてのグループ) |
| Group Allowed Users | ユーザー ID のリスト | これらのユーザーのみがボットを起動できます (allowlist モード) |
DM ポリシー
ボットにダイレクトメッセージを送信できるユーザーを制御します:| ポリシー | 動作 |
|---|---|
| Pairing (デフォルト) | 新しいユーザーにはペアリングコードが表示されます。WebUI に入力して承認してください |
| Allowlist | 指定したユーザー ID のみがボットにメッセージを送信できます |
| Open | 誰でもボットにメッセージを送信できます (注意して使用してください — AI クレジットを消費します) |
トラブルシューティング
ボットが応答しない
ボットが応答しない
- Bot Token が正しいか確認してください (余計なスペースがないか)
- インスタンスが実行中であることを確認してください (ダッシュボードで緑色のステータス)
- ダッシュボードからインスタンスを再起動してみてください
「ペアリングコード」が表示されない
「ペアリングコード」が表示されない
- グループではなく、ボットに ダイレクトメッセージ を送信していることを確認してください
- ペアリングシステムは、新しいユーザーからの最初のメッセージで有効になります
ボットの応答が遅い
ボットの応答が遅い
- 応答時間は選択した AI モデルによって異なります
- 大規模なモデル (Claude Opus, GPT-5) は数秒かかる場合があります
- LemonData の残高を確認してください。クレジットが不足しているとエラーが発生します