Files
zeekayandHanzo Dev 84e4069c2c docs name the state dir and config file the bot reads: ~/.bot/bot.json
The docs said ~/.hanzo-bot/hanzo-bot.json (and ~/.hanzo-bot-<profile>, hanzo-bot.plugin.json), which nothing reads: src/config/paths.ts resolves ~/.bot, bot.json and ~/.bot-<profile>, and plugins ship bot.plugin.json. Every such path in docs/ now names what the code opens.

Co-authored-by: Hanzo Dev <[email protected]>
2026-09-24 21:12:09 -07:00

6.5 KiB

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

HanzoBot

HanzoBot HanzoBot

「EXFOLIATE! EXFOLIATE!」 — たぶん宇宙ロブスター

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

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

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

仕組み

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 hanzo-bot@latest ``` ```bash hanzo-bot onboard --install-daemon ``` ```bash hanzo-bot channels login hanzo-bot gateway --port 18789 ```

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

ダッシュボード

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

HanzoBot

設定(オプション)

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

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

例:

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

ここから始める

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

詳細

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