bot/docs/ja-JP/index.md

read_when, summary, title, x-i18n

read_when	summary	title	x-i18n
新規ユーザーにHanzo Botを紹介するとき	Hanzo Botは、あらゆるOSで動作するAIエージェント向けのマルチチャネルgatewayです。	Hanzo Bot	generated_at model provider source_hash source_path workflow 2026-02-08T17:15:47Z claude-opus-4-5 pi fc8babf7885ef91d526795051376d928599c4cf8aff75400138a0d7d9fa3b75f index.md 15

Hanzo Bot

「Your personal AI assistant.」

WhatsApp、Telegram、Discord、iMessageなどに対応した、あらゆるOS向けのAIエージェントgateway。
メッセージを送信すれば、ポケットからエージェントの応答を受け取れます。プラグインでMattermostなどを追加できます。

Hanzo Botをインストールし、数分でGatewayを起動できます。 `hanzo-bot onboard`とペアリングフローによるガイド付きセットアップ。 チャット、設定、セッション用のブラウザダッシュボードを起動します。

Hanzo Botは、単一のGatewayプロセスを通じてチャットアプリをPiのようなコーディングエージェントに接続します。Hanzo Botアシスタントを駆動し、ローカルまたはリモートのセットアップをサポートします。

仕組み

flowchart LR
  A["チャットアプリ + プラグイン"] --> B["Gateway"]
  B --> C["Piエージェント"]
  B --> D["CLI"]
  B --> E["Web Control UI"]
  B --> F["macOSアプリ"]
  B --> G["iOSおよびAndroidノード"]

Gatewayは、セッション、ルーティング、チャネル接続の信頼できる唯一の情報源です。

主な機能

単一のGatewayプロセスでWhatsApp、Telegram、Discord、iMessageに対応。 拡張パッケージでMattermostなどを追加。 エージェント、ワークスペース、送信者ごとに分離されたセッション。 画像、音声、ドキュメントの送受信。 チャット、設定、セッション、ノード用のブラウザダッシュボード。 Canvas対応のiOSおよびAndroidノードをペアリング。

クイックスタート

```bash npm install -g bot@latest ``` ```bash hanzo-bot onboard --install-daemon ``` ```bash hanzo-bot channels login hanzo-bot gateway --port 18789 ```

完全なインストールと開発セットアップが必要ですか？クイックスタートをご覧ください。

ダッシュボード

Gatewayの起動後、ブラウザでControl UIを開きます。

• ローカルデフォルト: http://127.0.0.1:18789/
• リモートアクセス: WebサーフェスおよびTailscale

設定（オプション）

設定は~/.hanzo/bot/bot.jsonにあります。

• 何もしなければ、Hanzo BotはバンドルされたPiバイナリをRPCモードで使用し、送信者ごとのセッションを作成します。
• 制限を設けたい場合は、channels.whatsapp.allowFromと（グループの場合）メンションルールから始めてください。

例：

{
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: { "*": { requireMention: true } },
    },
  },
  messages: { groupChat: { mentionPatterns: ["@bot"] } },
}

ここから始める

ユースケース別に整理されたすべてのドキュメントとガイド。 Gatewayのコア設定、トークン、プロバイダー設定。 SSHおよびtailnetアクセスパターン。 WhatsApp、Telegram、Discordなどのチャネル固有のセットアップ。 ペアリングとCanvas対応のiOSおよびAndroidノード。 一般的な修正とトラブルシューティングのエントリーポイント。

詳細

チャネル、ルーティング、メディア機能の完全な一覧。 ワークスペースの分離とエージェントごとのセッション。 トークン、許可リスト、安全制御。 Gatewayの診断と一般的なエラー。 プロジェクトの起源、貢献者、ライセンス。