2026年 OpenHuman 完全インストール・設定ガイド：ゼロから動かすまでの手厚いチュートリアル

2. 入れ違え注意：デスクトップ OpenHuman と WebGL デジタルヒューマン SDK

OpenHuman（本記事の対象）は tinyhumansai/openhuman のデスクトップ個人 AI アシスタントです。UI 優先、Memory Tree、Obsidian 風 Markdown ボルト、118+ OAuth 連携、任意のローカル Ollama。既定ではサインイン、モデルルーティング、検索プロキシ、Composio 経由の OAuth にホスト側サービスが関与します（設定で BYOK / Composio 直結へ段階的に移行可能）。

同名に近い OpenHuman WebGL デジタルヒューマン SDK は Web 上の 3D キャラクター向けで、本記事のインストール対象ではありません。「個人ナレッジベース + メール/カレンダー/リポジトリ文脈」が目的なら、GitHub の openhuman デスクトップリポジトリと tinyhumans.ai/openhuman のダウンロードページを確認してください。

一般の Web チャットとも違い、OpenHuman はローカルワークフローデータ + 定期取得の連携を重視します。ターミナル優先の CLI Agent と比べ、GUI と短いオンボーディングで、設定ファイルを書かなくても会話を始められます。

3. よくあるつまずき

1. 制限：「インストール完了＝もう私のことを知っている」。公式どおり Memory Tree、Markdown ボルト、ワークスペース設定、ローカル実行状態は本機に残りやすい一方、ログイン・モデルルーティング・検索プロキシ・既定 OAuth はホスト側を通る場合があります。連携なし・同期待ちなしでは、Agent は一般論しか返せません。
2. 隠れコスト：権限を広げすぎ、最初から本番アカウント。OAuth 一回でメール読取・カレンダー・リポジトリまで届くことがあります。Beta 段階ではテスト用 Gmail / テスト GitHub だけで範囲と取り消し手順を確認してから本番データへ。
3. 安定性と監査：記憶の場所・ログの場所がわからない。困るとアンインストール→再インストールし、SQLite とボルトの同期手がかりを消しがちです。ワークスペースパス、連携 ID、モデルモード（マネージド / BYOK / Ollama）をメモしておくとロールバックしやすいです。

4. インストール前チェックリスト

目的：途中でネットやディスクが足りず何時間も迷うのを防ぐ。通過基準：下の項目をすべて確認してからインストーラを落とす。

• OS：macOS（Apple Silicon / Intel）、Windows 10/11（64bit）、Debian/Ubuntu や Arch などの Linux デスクトップ。最低バージョンは当時の Release 表記に従う。製品は Early Beta で UI・パスが変わる可能性あり。
• ハードウェア：推奨 メモリ 16GB+（Ollama 利用時はさらに厳しめ）；ディスク ≥5GB（アプリ + ボルト + SQLite + モデルキャッシュ、利用次第）。
• ネットワーク：GitHub、tinyhumans.ai、OAuth リダイレクト先に到達できること。社内プロキシはシステムまたはブラウザで事前設定。
• アカウント：OpenHuman 製品アカウント。BYOK なら各ベンダーの API Key。Ollama なら事前にローカルインストールとモデル pull。
• テストデータ：テスト用 Gmail / テスト GitHub リポジトリを用意。初回から会社 Slack や本番メールは接続しない。
• 権限：macOS では通知・マイク（音声）・フォルダアクセスのプロンプトあり。Linux は Wayland 上の AppImage 既知問題（公式 issue #2463）に注意。

5. ダウンロード元と安全確認

README 上の推奨優先度：① 公式サイト / GitHub Release → ② ネイティブパッケージマネージャ（Homebrew、署名 apt、MSI）→ ③ スクリプトインストール（独立署名なし。リスクを理解したうえでのみ）。

失敗時はまず：破損ファイル → Release から再取得；SmartScreen / Gatekeeper → 発行者確認後に許可。出所不明の「高速ミラー」は使わない。

6. 三 OS のインストール手順

6.1 macOS（Homebrew 推奨）

brew tap tinyhumansai/core
brew install openhuman

Release の .dmg をアプリケーションにドラッグしても可。通過基準：Launchpad から OpenHuman が開く。失敗時はまず：「開発元を確認できない」→ システム設定 → プライバシーとセキュリティ → それでも開く；通知/マイク/フォルダは必要最小限のみ許可。

6.2 Windows（署名 MSI）

latest release から .msi を取得しインストール。SmartScreen では発行者を確認。通過基準：スタートメニューにショートカットがあり起動できる。失敗時はまず：企業ポリシー、ウイルス対策の隔離、ファイアウォールが OAuth コールバックを阻害していないか。

6.3 Linux（apt 推奨。AppImage は注意）

sudo apt-get install -y --no-install-recommends gnupg2 curl ca-certificates
curl -fsSL https://tinyhumansai.github.io/openhuman/apt/KEY.gpg \
  | sudo gpg --dearmor -o /etc/apt/keyrings/openhuman.gpg
echo "deb [signed-by=/etc/apt/keyrings/openhuman.gpg arch=amd64] \
  https://tinyhumansai.github.io/openhuman/apt stable main" \
  | sudo tee /etc/apt/sources.list.d/openhuman.list
sudo apt-get update
sudo apt-get install -y openhuman

Arch は openhuman-bin AUR（yay -S openhuman-bin、AUR の実際の公開に従う）。AppImage は Wayland や一部 Arch で起動失敗の報告あり（issue #2463）。Debian/Ubuntu は .deb / apt を優先。通過基準：デスクトップメニューから起動。失敗時はまず：依存ライブラリ、Wayland 環境変数、X11 セッションへの切替。

6.4 プラットフォーム別インストール比較

アンインストールと再インストール：先に OAuth をすべて切断し、必要ならボルトをバックアップ。アプリ削除後もワークスペースと SQLite がユーザーディレクトリに残ることがあります。公式のデータパスを確認してから削除し、唯一の記憶コピーを消さないでください。

7. 初回起動とアカウントログイン

1. 起動し、ワークスペース（workspace）の場所を選ぶ——専用フォルダを推奨。ホーム全体を指さない。
2. OpenHuman 製品アカウントでログイン（既定はマネージドログインフロー）。通過基準：設定にログイン済みと表示。
3. 更新チャネルとプライバシー関連（通知、音声、検索プロキシなど）は一旦デフォルトのまま。動いたあと細かく調整。

失敗時はまず：ログイン画面が真っ白 → 既定ブラウザへ、広告ブロックをオフ；繰り返し失敗 → システム時刻・DNS・プロキシ。地域やサブスク制限は公式の最新説明に従い、本記事は全地域で同一機能を保証しません。

8. モデル設定と BYOK

マネージドモデル（既定）：OpenHuman バックエンドが model routing（推論/高速/ビジョン等をタスクに応じて選択）。サブスク内の複数モデルルートはアカウントページの最新表示に従い、価格・上限は変わり得ます。

BYOK（Bring Your Own Key、持ち込み API キー）：設定に各ベンダーの API Key を入力。コストとクォータは利用者負担。企業契約や細かい課金管理向け。

ローカルモデル（Ollama）：公式は任意のローカル AI をサポート。Apple Silicon Mac ではユニファイドメモリが中小モデルに有利ですが、大モデルはメモリ上限と遅延を自分で検証してください。

通過基準：「一言で自己紹介して」などのテストに一貫した返答。失敗時はまず：マネージド → サブスク/ネットワーク；BYOK → Key 権限と請求；Ollama → サービス待受とモデル名の一致。

9. 連携と権限設定

OpenHuman は Composio コネクタ層で Gmail、Slack、Notion、GitHub、Calendar、Drive など 118+ 連携を提供します。既定の OAuth とツール呼び出しはホスト側プロキシ経由。Composio 直結する場合は設定で Composio API Key が必要で、リアルタイム trigger の webhook ホスティングも自分で担います。

OAuth は、ブラウザで第三者にログインし、アプリにデータの一部へのアクセスを許可する標準手順です。権限画面では今回のケースに必要な最小 scopeだけを読み、理解できない scope は承認しない。

通過基準：連携が Connected、OAuth コールバックエラーなし。失敗時はまず：ポップアップブロック、企業 SSO、Composio 状態、プロキシ。

10. 記憶システムの検収のしかた

初心者向けに OpenHuman の記憶パイプラインを整理すると：

• Memory Tree（メモリツリー）：連携から取り込んだデータを階層サマリーにし、本機 SQLite に保存して Agent が検索。
• Markdown vault（Obsidian 互換）：同じ知識が .md としても残り、Obsidian で閲覧・編集可能。
• auto-fetch：アクティブな接続ごとに約 20分 ごとに新データを取得（手動 cron 不要）。

検収手順：テスト連携を接続 → 少なくとも1回分（約20分）の同期を待つ（UI に手動トリガーがあればそれでも可）→ Memory ビューまたはボルトで新 Markdown を確認 → テストデータにしかないキーワードで質問する。

通過基準：回答が正しい出典またはファイル断片を示す。失敗時はまず：連携が非アクティブ、同期未完了、本番データを聞いているのにテスト源しか繋いでいない（空コンテキストの幻覚）。

11. 最初の実践ケース：テスト Gmail で「今週のサマリー + ToDo」

目的：モデル・連携・記憶・出力・取り消しを一度に検証する。

1. テスト Gmail を用意し、件名がはっきりしたメールを2〜3通自分に送る（例：「Q2 予算」「金曜までに週報提出」）。
2. OpenHuman ではそのテストメールだけを OAuth 接続。
3. 初回 auto-fetch を待つ（目安 ≥20分）。ボルト / Memory に新コンテンツがあることを確認。
4. 質問例：「テストメールの最近の内容から、今週のサマリーと ToDo を作り、各項目がどのメール由来か示して。」
5. サマリーがテストメールと一致するか、存在しない話題を捏造していないか確認。エクスポートがあれば保存。
6. OpenHuman と Google の両方で認可を取り消し、Disconnect 後にそのメールを参照しないことを確認。

通過基準：出力がテストメールと一致、出典が照合可能、取り消し後はアクセスしない。失敗時はまず：④ モデル層と ⑥ 記憶層を混ぜず、止まっている層だけを見る。

12. よくある問題（層別）

13. 完了後チェックリスト：動いたあとに広げる

• テスト OAuth を取り消し、本番メール/リポジトリは一度に1連携だけ追加。
• ワークスペース、ボルト、主要設定のスクリーンショットをバックアップ。モデルモードとおおよその月額を記録。
• 公式 プライバシーとセキュリティ を読み、通知・音声を再確認。
• アンインストール手順とデータの保存場所を把握し、唯一の記憶庫を誤削除しない。

七ステップ Runbook：準備 → 公式インストール → ログイン → モデルテスト → 低リスク連携1つ → 記憶待ち → 実践して取り消し。すべて通過してから Slack、Notion、長期ワークフローを足してください。