OpenHuman 初心者の始め方：
2026 インストールからデータソース連携までの丁寧 Q&A

OAuth、BYOK、Memory Tree が初見でも問題ありません。まず最小ルートを動かす。アーキテクチャ文書は、動いたあとで十分です。

Q結局、何をインストールしているの？

A：Web サイトでも SDK でもなく、デスクトップアプリ＋ローカル Agent です。OAuth（Google/GitHub などで「このアプリに権限を渡す」標準の仕組み）で Gmail、Notion、GitHub などをつなぎ、学習した内容を端末内のメモリツリーと Markdown vault（Obsidian で開ける）に書き込みます。メモリはローカルに残りますが、チャット・モデル経路・一部 OAuth は OpenHuman のクラウドを通る場合があります——ローカル優先 ≠ オフライン専用です。いまやること： tinyhumans 版であることを確認してからダウンロード。

Qインストール前の準備と、どのファイルを落とす？

A：普段使う PC、安定したネット、数 GB の空き容量、Gmail などへの読み取り権限付与への理解が必要です。初心者は公式の DMG（macOS）または Releases のインストーラから。上級者は Homebrew（brew install tinyhumansai/openhuman/openhuman）や公式 install.sh も可——メイン機ではスクリプトを読むか GUI インストーラに留めるのが安全です。いまやること： ログイン画面が出るまでインストール。

QOS がブロックするのはなぜ？

A：macOS の Gatekeeper や Windows の SmartScreen は、App Store 外のアプリをよく止めます。公式サイトから落としたうえで「このまま開く」を選び、GitHub Releases のバージョンと一致させてください。ミラー URL からのインストールは避けます。いまやること： 警告を通過して一度起動。

Qログイン後、他に何を設定する？

A：アカウントの OAuth ログインは本人確認とサブスク有効化。Gmail 連携とは別物です。デフォルトではチャットや連携のツール呼び出しが OpenHuman のマネージドバックエンド（コネクタに Composio など）を通る場合があります。まだ必要なのは ① Settings でモデル選択 ② Integrations で各サービスを Connect。いまやること： ログイン → モデル → 連携。長いチャットはこのあと。

Qモデルはどう選ぶ？ API Key は必須？

A：必須ではありません。BYOK（Bring Your Own Key）はクラウド事業者のキーを自分で貼り、従量課金する方式。サブスク＋TokenJuice（ツール出力を圧縮してトークン節約）も選べます。Ollamaはローカル推論——Apple Silicon では統合メモリ 24GB 以上が実用的な目安です。キーは Git に入れない。一行「こんにちは」で応答を確認。いまやること： 課金方式を一つ決め、モデル応答を検証。

Q連携はなぜ別途承認が要る？

A：OpenHuman へのサインインと Gmail 接続は OAuth が二回、スコープも別。いつでも解除できます。118 以上のコネクタのうち、auto-fetch（約 20 分周期でメモリツリーへ自動取り込み）が強いのは Gmail・Notion・Slack など——自分のコネクタは最新 GitBook で要確認。一度に全部つなぐとコストとプライバシー面積も増えます。いまやること： Gmail と、普段使っているソースをあと 1 つ。

Qメモリはいつ出る？テストデータを読んだかどう確認する？

A：有効な連携はおおよそ 20 分ごとに更新。初回は 1 サイクル分待つことが多いです。検証手順：ユニークな件名のテストメールを送る → 20～40 分待つ → vault で件名検索 → Agent に本文にしかない詳細を引用させる。vault に .md があるのに引用できない場合は OAuth ではなく検索・モデル設定側を疑う。いまやること： この 4 ステップを完了してから連携を増やす。

Q最初のタスクと、失敗したときの見方？

A：最初は読み取り専用で、例：「Gmail の [プロジェクト X] に関する直近 3 通を要約して」。失敗時は層で切り分け：アプリのバージョンと再起動 → ログインとモデル → 連携が Expired か → 20 分以上待ったか、vault に新しい md があるか → 別 Google アカウントを繋いでいないか → GitHub Issues。費用はサブスク、BYOK 従量、Ollama の RAM/CPU を混同しない。いまやること： 読み取り専用の Q&A を 1 回成功させてから連携を拡張。

→Mac mini で OpenHuman を常時稼働

メモリツリーと auto-fetch は静かに電源を入れっぱなしに向きます。Mac mini M4 の統合メモリは Ollama に有利、macOS の SIP・FileVault は個人コンテキストの保管に向き、アイドル時の消費電力はおおよそ 4W 前後。寝ている間もメールやドキュメントを取り込みたいなら、Mac mini M4 はコスパの良い起点です——vault のサイズとモデル選択に合うか、スペックを確認してみてください。