AI Agent OpenHuman 2026.06.01

2026 OpenHuman インストール完全ガイド: 四平台ネイティブパッケージ、Memory Tree と Ollama をゼロから稼働

OpenHumantinyhumansai/openhuman)は 2026 年に注目を集めているオープンソースのデスクトップ向けパーソナル AI スーパーアシスタントです。ローカルの Memory Tree により「会話が終わると忘れる」ステートレス問題に対処します。Python + CUDA 重みを要する「デジタルヒューマン動画生成」パイプラインとは別物です。run_demo.pycheckpoints/*.pth を含むチュートリアルは別プロジェクトの混入であることが多く、本記事は公式 Early Beta(約 v0.54.x)の実インストール手順に厳密に沿います。

本記事は「1 本でインストールまで完結したい」読者向けです。① OpenHuman の機能と ChatGPT / OpenClaw との役割分担、② Homebrew / apt / MSI / curl の選定マトリクスと六段階検収、③ 初回 OAuth、Memory Tree 同期、Ollama / LM Studio によるローカル推論設定を扱います。レンタル Mac で OpenClaw + OpenHuman の二重フレームワークを検討する場合はレンタル Mac 二重フレームワークガイドをご覧ください。本記事は OpenHuman 単体のゼロから可用までに集中します。

01 OpenHuman とは:2026 デスクトップ Agent と三つのよくある誤解

Tiny Humans AI チームがメンテする OpenHuman は Your Personal AI super intelligence を標榜する Rust + Tauri v2 クロスプラットフォームデスクトップアプリです。Gmail、Slack、GitHub、Notion など 118+ サービスを OAuth で取得したデータを Token 圧縮してローカル SQLite 駆動の Memory Tree に書き込み、モデルが数分で跨週コンテキストを得られるようにします(公式ドキュメント)。

インストール前に次の三つの誤解を避けてください。

  • 「デジタルヒューマン顔替え」と混同:数 GB の .pthcheckpoints/ に置く必要はなく、NVIDIA CUDA による動画推論にも依存しません。GUI インストーラのサイズは通常数百 MB 程度です(バージョンにより変動)。
  • 純 Web チャットと混同:核心価値はバックグラウンド自動同期 + 記憶ツリー検索です。ウィンドウを閉じても記憶は失われませんが、初回は OAuth とインデックス構築が必要です。
  • 未検証スクリプトの使用:公式は curl … | bash ではスクリプトのバイト整合性を検証できないと明記しています。本番環境では Homebrew / 署名 apt / 署名 MSI を優先してください(install.md)。

OpenClaw との役割分担:OpenClaw は Telegram/WhatsApp 等のメッセージング Bot チャネルに強く、OpenHuman はデスクトップスーパーアシスタント + Memory Tree + 会議/音声に強いです。どちらも Ollama に接続できますが、インストールと常駐方式は異なります。

02 OpenHuman 環境要件と四平台インストール経路の決定マトリクス

ホスト環境:最低 vs 推奨(デスクトップ GUI + ローカル Ollama 8B)
項目 最低 推奨
OS macOS 12+ / Win 10+ / Ubuntu 20.04+ macOS 14+(Apple Silicon)/ Win 11 / Ubuntu 24.04
メモリ 8 GB(クラウド API のみ) 16 GB+(Ollama 7B–8B 並行)
ディスク 約 2 GB(アプリ + キャッシュ) 20 GB+(Memory インデックス + ローカルモデル)
GPU 不要(クラウド API 可) Apple Silicon / NVIDIA で Ollama 加速
インストールチャネルの選び方(整合性 vs 利便性)
チャネル プラットフォーム 整合性検証 向いている人
Homebrew macOS / Linux あり(bottle hash) 開発者の日常更新
署名 apt Debian / Ubuntu あり(GPG リポジトリ) Linux ワークステーション / GUI 付きサーバー
署名 MSI Windows あり(公式 Release) 企業デスクトップ標準化
curl / npm 全平台 制限あり(スクリプトまたは npm ラッパー) クイック体験;本番では curl パイプは慎重に

ソースからビルドする場合は Node.js 24+、pnpm、Rust 1.93+ 等が必要です(リポジトリ README 参照)。一般ユーザーはソースビルド不要です。118+ 連携は国際 SaaS が中心のため、国内向けサービスは Beta 段階で未対応の可能性があります。デプロイ前に設定画面のコネクタ一覧を確認してください。

03 OpenHuman インストール六段階:ネイティブパッケージから初回対話検収まで

以下は macOS Homebrew を例にします。Linux apt と Windows MSI のコマンドは同節末尾に記載し、ロジックは同一です。

install-macos.sh
brew tap tinyhumansai/openhuman
brew install openhuman
openhuman --version

# Linux Debian/Ubuntu(署名リポジトリ、抜粋)
# curl -fsSL .../KEY.gpg | sudo gpg --dearmor -o /etc/apt/keyrings/openhuman.gpg
# sudo apt-get update && sudo apt-get install -y openhuman
  1. チャネル選択:本番では Homebrew / apt / MSI を優先します。監査されていない環境で本番機に curl | bash を実行しないでください。
  2. インストール実行:macOS では brew install openhuman 後、ターミナルから openhuman で起動できます。Launchpad から GUI を開くこともできます。
  3. バージョン確認:GitHub Releases と照合し、現在の Beta(例 v0.54.x)か確認します。古い場合は brew upgrade openhuman またはパッケージマネージャで更新します。
  4. 初回ウィザード:アプリを起動し、案内に従いアカウントログイン、タイムゾーン、プライバシー設定を完了します。データはデフォルトで本機ユーザーディレクトリの SQLite に保存されます(パスは設定画面を参照)。
  5. OAuth ソースを 1–2 個接続:まず Gmail または GitHub でスモークテストし、Memory Tree に「同期中 / インデックス済み」が表示されるか確認します。
  6. スモーク対話:デスクトップクライアントで「GitHub の直近 1 週間の issue を要約して」や「受信トレイに基づき返信草稿を」と質問し、同期後のコンテキストを引用できるか確認します。

Windows ユーザーは 最新 Release から .msi をダウンロードしてインストールします。Arch ユーザーはリポジトリ内 AUR レシピ openhuman-bin を参照できます。npm グローバル npm install -g openhuman は初回インストール時にプラットフォームバイナリをダウンロードし SHA-256 を検証します。実行時は Node に依存しません(公式 install.md)。

04 Memory Tree 設定と Ollama ローカル推論の接続

Memory Tree はソースツリー → トピックツリー → グローバルツリーの三層構造です。下層はコネクタ(Gmail、Slack 等)ごとに生データをアーカイブし、中層はトピックでクラスタリング、上層は対話検索に供します。公式は約 20 分周期の自動増分同期を謳い(現在 Beta 設定を参照)、TokenJuice 類の技術で Token 占有を圧縮します。

  1. 最小権限で認可:まず読み取り専用ソースを 1–2 個接続し、インデックス完了を確認してから拡張します。初回フル同期でディスクと帯域を使い切らないようにします。
  2. インデックス状態の監視:設定画面で各コネクタの「最終同期時刻」を確認します。長時間 syncing のままならプロキシと OAuth 期限切れを確認します。
  3. Ollama インストール:ホストに Ollama を入れ、例として ollama pull qwen2.5:7b でモデルを取得します(モデル名は環境に合わせてください)。
  4. ローカルエンドポイント設定:OpenHuman 設定で Local / Ollama または LM Studio を選び、Base URL は通常 http://127.0.0.1:11434/v1(OpenAI 互換パスは UI を参照)。
  5. 低 VRAM 戦略:16GB 統合メモリ機では 7B–8B 量子化モデルを優先します。13B では Activity Monitor で Ollama と OpenHuman の合計使用量を監視します。
  6. Obsidian 同期(任意):ノート双方向同期を有効にする場合、vault パスは SSD ローカルに置き、ネットワークドライブで watcher が失効しないようにします。
ollama-local.sh
ollama serve
ollama pull qwen2.5:7b
# OpenHuman 設定 → Local LLM → http://127.0.0.1:11434

完全オフライン構成ではクラウド LLM API を接続せず、Ollama + ローカル Memory のみで対話とインデックスを本機内に留められます。法務・社内文書アシスタント向けに適しています。M シリーズ Mac は独显なしでも 7B 級モデルを実行できます。速度は統合メモリ帯域に依存します。

05 OpenHuman 引用可能仕様とインストール設定エラー早見

  • オープンソースライセンス:メインリポジトリは GPL-3.0。商用派生物は传染性条項に従う必要があり、クローズド製品への直接埋め込み前に法務確認を推奨します(MIT の OpenClaw と対比)。
  • 連携規模:公式は 118+ OAuth サービスコネクタを謳います(設定画面のリアルタイム一覧を参照)。
  • ストレージ:Memory データは本機 SQLite に保存され、デフォルトではクラウドに上がりません。アンインストール前にユーザーデータディレクトリを手動エクスポートまたはバックアップしてください。
  • バージョンリズム:Early Beta。2026 年 5 月時点でコミュニティ観測の GitHub Stars は約 6k+ 規模で複数回 Trending。デプロイ前に必ず Release changelog を確認してください。
インストールと初回同期の高頻度問題
現象 想定原因 対処
OAuth コールバック失敗 システムプロキシ / 時刻ずれ 時刻を校正;ブラウザを直結;企業環境でコールバックドメインを許可
Memory が syncing のまま 初回フル同期 / トークン期限切れ コネクタ数を減らす;OAuth を切断して再接続
ローカルモデル無応答 Ollama 未起動 / ポート誤り ollama serve;11434 とモデル名を確認
Linux で GUI トレイなし デスクトップセッションなし VNC またはデスクトップ付きクラウド Mac で初回認可を完了

更新:パッケージマネージャ(brew upgrade / apt upgrade)または MSI 再インストール。重大 Beta アップグレード前は設定スクリーンショットと SQLite ディレクトリのバックアップを推奨します。アンインストール:システムからアプリ削除後、残存データディレクトリと Ollama モデルキャッシュ(不要なら)を手動削除します。

06 OpenHuman を載せるマシン:平台比較と JEXCLOUD まとめ

OpenHuman デプロイ先比較(Memory 同期 + ローカル Ollama)
平台 GUI / OAuth 7×24 同期 向いている段階
個人 MacBook 完全 スリープで同期一時停止 Memory Tree 試用
GUI なし Linux VPS 制限あり 7×24 可だが OAuth 困難 第一候補非推奨
JEXCLOUD Mac Mini M4 VNC + ネイティブ Tauri 常時オンライン、Memory 増分継続 本番アシスタント + ローカル 8B

ノート PC とオーバーセル VPS の三つの実際の弱点:① フタ閉じ・スリープで Memory 自動同期が止まり、月曜に開いても「記憶喪失」のように感じる;② GUI なし Linux では OAuth と Tauri GUI の初回設定が困難;③ 近隣ディスク IO 争いで Ollama とインデックスが同時に遅延し、「入るが安定しない」状態になります。

OpenHuman を 7×24 増分記憶 + ローカル Qwen2.5 で運用するなら、JEXCLOUD ベアメタル Mac Mini M4 で本記事の Homebrew インストールと Ollama 設定を行い、VNC で OAuth を一度完了し、以降は SSH でモデルとログのみメンテナンスするのが安定です。仮想化オーバーセルなし、データはレンタルディスク上。退租前に SQLite と Ollama モデルディレクトリをパックバックアップできます。仕様とリージョンは 料金ページ、注文は 注文ページ、リモートデスクトップは ヘルプセンターをご覧ください。