2026年 OpenHuman 超入門インストール＆設定：macOS / Windows / Linux 完全ガイド
OpenHuman（tinyhumansai/openhuman）は 2026 年注目の GPL3 デスクトップ Agent です。Rust + Tauri、Memory Tree、mascot、Google Meet 参加に対応。環境マトリクス、3 OS インストール、検証、Ollama、エラー表を飛ばしなしで解説します（約 20 分）。
1. OpenHuman を選ぶ理由と本ガイドの到達点
OpenHuman は GPL3 デスクトップ Agent（Rust + Tauri）で Memory Tree、mascot、任意の Meet 参加が特徴です。OpenClaw や Hermes とは異なり UI 優先で onboarding できます。本稿は公式パッケージ → LLM → Memory Tree/mascot → 任意 Ollama を扱います。OpenClaw 同居は《レンタル Mac 双 Agent》参照。
2. インストール前の 3 つの落とし穴
- ソースビルドに迷い込む：
git clone+Rust は不要。Homebrew/apt/MSI を推奨。curl | bashは本番非推奨です。 - LLM 未設定のまま機能テスト：mascot/Meet は LLM 設定が前提。Key スキップで「UI のみ起動」になります。
- ノート閉蓋で subconscious 停止：7×24 ホストが必要。Memory Tree 複利は常時稼働 Mac で速いです。
3. 環境要件とハードウェア決定マトリクス
| 項目 | 最低要件 | 推奨構成 |
|---|---|---|
| OS | macOS 12+、Win10 64bit、Ubuntu 20.04+ | macOS 14+（Apple Silicon）、Win11、Ubuntu 24.04 LTS |
| CPU / チップ | x64 四コア | Apple M4 / M4 Pro、または 8 コア x64 + 独显 8 GB |
| メモリ | 8 GB（クラウド API のみ） | 16 GB（Ollama 7B）、32 GB（多連携 + ローカル 13B） |
| ディスク | 10 GB 空き | 50 GB SSD（Ollama モデルキャッシュ含む） |
| ネットワーク | LLM API / OAuth 到達可 | 低遅延安定回線；Meet プロキシは Google 到達必須 |
Apple Silicon 統合メモリは Ollama 共存に有利。NVIDIA は CUDA 12+ と VRAM が必要。ヘッドレス VPS では mascot/Meet が制限されます。
4. 事前準備と経路選定
| インストール経路 | 対象プラットフォーム | 整合性検証 | 推奨シーン |
|---|---|---|---|
| Homebrew tap | macOS、Linux | brew 署名チェーン | 日常ユーザー第一選択 |
| signed apt | Debian / Ubuntu amd64 | GPG リポジトリ | Linux デスクトップ / サーバー |
| 公式 MSI / DMG | Windows / macOS | リリース署名 | パッケージマネージャなし環境 |
| curl install.sh | macOS / Linux x64 | なし（本番非推奨） | お試し |
| ソースビルド | 全プラットフォーム | 自己検証 | コントリビュータ / CEF カスタム |
前提：macOS は Xcode CLT、Linux は apt が WebKit/GTK 取得、Windows は MSI のみ。
5. コアインストール（macOS / Linux / Windows）
macOS（Homebrew 推奨）：
brew tap tinyhumansai/core && brew install openhumanLinux：signed apt 後 sudo apt install openhuman。Arch は AUR、他は AppImage。
Windows：GitHub Releases の .msi。
npm：npm install -g openhuman（Node ≥ 18）。
6. 初回起動と検証チェックリスト
- onboarding 完了（API Key/OAuth）。
- スモーク対話で LLM 応答確認。
- Memory Tree に Markdown 生成確認。
- mascot busy/thinking、TTS 口形同期。
- 任意：Meet リンクで mascot 入室テスト。
7. 応用：Ollama、低 VRAM、連携
ローカル：ollama pull qwen2.5:7b → http://127.0.0.1:11434/v1。8 GB はクラウド API、16 GB Apple Silicon で 7B。Gmail 等 OAuth、Memory Tree は SFTP/rsync バックアップ可。
8. 典型エラー早見表
| エラー / 現象 | 原因 | 対処 |
|---|---|---|
| openhuman: command not found | PATH に brew/npm プレフィックスなし | brew link openhuman または端末再起動 |
| mascot 無反応 | LLM 未設定または 401 | onboarding 再実行、API Key 残量確認 |
| CUDA OOM | ローカルモデル過大 | 7B 量子化へ変更またはクラウド API |
| Memory Tree が空 | subconscious 無効または権限 | ディスク権限と連携 OAuth 状態を確認 |
| Linux WebView 起動不可 | GTK/WebKit 不足 | sudo apt install libwebkit2gtk-4.1-0 等 |
9. よくある質問
Q：GPU なし？ クラウド API 可；Mac M 系列で Ollama 7B 可。
Q：更新？ brew upgrade openhuman；前に Memory Tree バックアップ。
Q：商用？ GPL3 copyleft、SaaS は法務確認。
10. まとめ：インストールは起点、7×24 で Memory Tree が複利する
本稿どおり macOS/Windows/Linux で OpenHuman 導入・LLM・mascot/Memory Tree 検証まで到達できます。閉蓋・スリープ・ヘッドレス Linux は subconscious 中断の実行環境制約です。
7×24 運用は SFTPMAC Mac mini M4（SLA、Memory Tree SFTP/rsync）が有効です。