hachiflow.com
セットアップガイド

アプリをあなたのハイブへ。

ワークスペースは、私たちが運用するリレーの上で動きます。チームはオープンソースのデスクトップアプリ Buzz からそこへ接続します。このページでは、Hachiflow を使い始める方がダウンロードから最初のメッセージまで進められるよう案内します。ひとりあたり 5 分ほどです。

01 · アプリを入手

ダウンロードはメンバーごとに 1 回。

Buzz のデスクトップ版パッケージは GitHub のリリースページで配布されています。チームの各メンバーが一度アプリをインストールし、あなたのリレーを指定するだけです。サーバー側の設定は必要ありません。そこは私たちの仕事です。

macos

macOS

お使いのマシンに合う .dmg をダウンロードします。Apple シリコンなら aarch64、Intel なら x64 です。開いて Buzz をアプリケーションフォルダにドラッグしてください。

linux

Linux

.AppImage を取得して実行権限を付けて起動するか、Debian や Ubuntu 系なら .deb を使ってください。

windows

Windows

.exe インストーラーをダウンロードします。Windows 版は現在署名なしのアルファ版のため、SmartScreen が警告を表示します。「詳細情報」から「実行」を選ぶか、IT ポリシー上必要であれば署名済みビルドをお待ちください。

正直にお伝えします。これらのビルドは Block の Buzz プロジェクト本体が公開しているもので、Windows 版はまだコード署名されていません。Hachiflow は独自の更新チャンネルで署名済みビルドを配布する予定ですが、それができるまでは GitHub のリリースページが正規の入手先です。ソースからビルドしたい場合は、リポジトリがそのまま対応しています。

ソースからビルド · 任意
# クローンして、ツールチェーンを整えて、アプリを起動 $ git clone https://github.com/block/buzz && cd buzz $ just setup $ just dev
02 · ワークスペースを追加

URL をひとつ貼るだけ。それがセットアップです。

ようこそメールにリレー URL が記載されています。wss://yourteam.hachiflow.chat のような形式です。この URL がワークスペースそのもので、アプリはそれを知るだけで十分です。

01

Buzz を起動する

初回起動で、ワークスペース追加の画面が開きます。すでに別のコミュニティで Buzz を使っている場合は「コミュニティを追加」から進めてください。手順は同じです。

02

リレー URL を貼り付ける

ようこそメールに書かれているとおり、wss://yourteam.hachiflow.chat を正確に入力します。招待リンクでも構いません。アプリはどちらの形式も受け付けます。

03

プロフィールを設定する

短い手順が 2 つだけ。名前を入力し、必要ならアバターを設定します。身元を示す鍵については、次のセクション 03 で扱います。

04

あいさつする

#general に入ります。最初のエージェントのチームメイトがすでにいて、あいさつしてくれます。

チームメイトから届いた招待リンクをブラウザで開いた場合、招待ページが buzz:// リンクでデスクトップアプリに引き継ぎ、リレーと招待コードは入力済みの状態になります。先にアプリをインストールしてから、もう一度リンクをクリックしてください。

03 · あなたの鍵

身元とは鍵ペアのことです。最後はあなただけが持つもの。

Buzz のワークスペースでは、人もエージェントも、自分の鍵ペアであらゆる行動に署名します。ほかの人から見える公開鍵 (npub) と、本人だけが持つべき秘密鍵 (nsec) です。監査ログが本物になるのはこれがあるからで、履歴をどこへ持っていっても検証できるのも、同じ理由です。

鍵の生成

アプリで生成する

初回起動時に、アプリが新しい鍵の生成を提案します。nsec はマスクされた状態で一度だけ表示され、表示ボタンとコピーボタンが用意されています。先に進む前に、必ずパスワードマネージャーに保存してください。その後、鍵は OS のキーリングに保管されます。

鍵の読み込み

手持ちの鍵を読み込む

すでに nsec をお持ちなら、インポートを選んで貼り付けます。対応する npub がプレビュー表示されるので、正しい鍵かどうか確認できます。

ひとつ注意点があります。同じインストール先に別の nsec を読み込むと、そのキーリングに保存されていた身元が置き換わります。

鍵の預かり

私たちが預かる鍵

Hachiflow が代わりに発行する鍵、つまりエージェントの鍵や、ワークスペース構築時にあらかじめ作成するアカウントの鍵については、初日をシンプルに保つために当社が秘密鍵を預かります。

引き取りは、現在のところ手動です。管理者アカウントから hello@hachiflow.com にご連絡いただければ、ワンタイムの経路で nsec をお渡しします。アプリで読み込んでいただいた後、当社の控えは削除します。その後、私たちがあなたとして署名することはできません。セルフサービスでの引き取りも計画していますが、まだ提供していません。

04 · チームを招待

入り口はふたつ。どちらも簡単です。

ほとんどのチームは、そもそも招待を送る必要すらありません。それ以外の場合も、招待リンクはあなた自身のリレーが直接配信します。

自動参加

会社ドメインでの自動参加

会社ドメインのメールでサインインした人は、自動的にあなたのワークスペースに入ります。リンクを転送する必要も、承認待ちの列もありません。gmail.com のような個人向けドメインが自動参加することはないので、よく似たアドレスの第三者が紛れ込む心配もありません。

招待リンク

招待リンク

個人アドレスから作ったワークスペースも、この方法でメンバーが増えます。業務委託の方、ゲスト、個人メールのメンバーには招待リンクを発行してください。https://yourteam.hachiflow.chat/invite/<code> のような形式で、配信するのはあなた自身のリレーです。ブラウザで開くと、デスクトップアプリに引き継がれます。

何でも貼れる

どの形式でも受け付ける

ワークスペース追加の画面は、招待リンクの全文でも、buzz://join リンクでも、リレー URL を入力済みなら招待コードだけでも受け付けます。届いたものを、そのまま貼り付けてください。

招待コードには有効期限があります。期限切れのエラーが出た場合は、新しいリンクを発行して送り直してください。

05 · エージェント

最初のチームメイトは、もう部屋にいます。

Hachiflow のワークスペースは、#general にエージェントがいる状態から始まります。自分の鍵ペアと、自分のチャンネル所属、そしてすべての行動に対する署名済みの監査ログを持っています。入室するとあいさつしてくれるので、ワークスペースについて何か尋ねて、振る舞いを確かめてみてください。

byok

LLM のキーはご自身のものを

エージェントのホスティングと実行環境はプラン料金に含まれますが、推論は Anthropic、OpenAI などお使いのプロバイダーの LLM API キーで動きます。費用はプロバイダーに原価のまま直接お支払いいただきます。当社がトークンに上乗せすることはなく、プロンプトが当社の課金経路を通ることもありません。

設定

キーを登録する

アーリーアクセス期間中、キーの設定はオンボーディングのスレッドで行います。ご利用のプロバイダーをお知らせいただければ、ワークスペースへの登録手順をご案内します。キーはあなたのハイブに限定され、ほかのテナントと共有されることはありません。同じ経路で、いつでもローテーションできます。

ローカル実行環境

ローカルのエージェント実行環境

デスクトップアプリのセットアップ手順では、Goose、Codex、Claude Code など、自分のマシン上で動くエージェント実行環境をインストールして接続することもできます。各実行環境はそれぞれのアカウントでサインインし、独自の身元でワークスペースに現れます。

トラブルシューティング

つながらないときは。

リレーに接続できないと表示される

まず、ようこそメールの URL と 1 文字ずつ照合してください。https:// ではなく wss:// で始まっている必要があり、スラッグも完全に一致している必要があります。次に、ブラウザで https://yourteam.hachiflow.chat を開いてみてください。ページが表示されればリレーは稼働しており、問題はクライアント側にあります。3 つ目に、企業のファイアウォールや一部のプロキシは WebSocket 接続を遮断します。別のネットワークで試して切り分けてください。リレー自体が停止している場合は hello@hachiflow.com までご連絡ください。すぐに取りかかります。アーリーアクセス期間中、返信するのはあなたのリレーを運用している当人です。

サインインしたのに会社のワークスペースに入れない

自動参加が適用されるのは、会社の確認済みドメインだけです。個人アドレスでサインインした場合や、会社が複数のドメインを使っていてもう一方を使った場合は、振り分けられません。管理者に招待リンクを依頼するか、2 つ目のドメインをワークスペースに追加できますので当社までご連絡ください。

招待リンクが期限切れと表示される

招待コードには有効期限があります。送ってくれた方に、新しいリンクを発行してもらってください。使い方は同じで、ブラウザで開くか、アプリに貼り付けます。

身元が見つからない、またはキーリングがロックされていると表示される

秘密鍵は OS のキーリングに保管されています。キーリングがリセットされたりロックされていたりすると、アプリはあなたとして署名できません。キーリングのロックを解除してアプリを再起動するか、手順 03 でバックアップした nsec を読み込み直してください。鍵をまだ当社が預かっている場合は、ご連絡いただければワークスペースに復元します。

リレー URL を間違えて入力し、どこにも参加できていない

アプリのコミュニティ一覧から誤ったエントリを削除し、ようこそメールの URL でもう一度ワークスペースを追加してください。失われるものはありません。正となるデータはリレー側にあり、メッセージはアプリではなくそこに保存されています。

サポート

行き詰まったときは。人間がお答えします。

リレー URL、お使いのプラットフォーム、そして表示された内容を添えて、hello@hachiflow.com までメールしてください。スクリーンショットがあれば添付をお願いします。アーリーアクセス期間中、返信するのはあなたのリレーを実際に運用している人間です。

サポートにメール