macOS Homebrew · Memory Tree · 118+ OAuth · エラー早見表 · VNC リモート Mac 検収
OpenHuman は tinyhumansai が開発するオープンソースのデスクトップ型パーソナル AI Agent です。単なるチャット窓ではなく、記憶・ツール・外部連携・音声をひとつのローカル知能層に統合します。2026年5月に v0.56.0 がリリースされ、GitHub スターは3万を超えました。本稿では macOS Homebrew による推奨インストール、初回起動と LLM 設定、Memory Tree の有効化、118 以上の OAuth 連携、よくある 10 項目のエラー表、そして VNC リモート Mac 上での 20 分検収チェックリストを v0.56 時点の情報で整理します。関連記事：OpenClaw & OpenHuman デプロイ、Hermes Agent インストール。
OpenHuman は 「Personal AI super intelligence」 を標榜する、プライベートで拡張性の高いデスクトップ Agent です。OpenClaw（ターミナル優先・BYO モデル）や Hermes Agent（CLI 中心）とは異なり、GUI ファーストの設計です。デスクトップ上のマスコットが会話し周囲のコンテキストに反応し、キーボード入力が止まってもバックグラウンドで情報を取り込み続けます。
技術スタックは Rust + Tauri + React、ライセンスは GNU GPL-3.0 です。最新安定版は v0.56.0（2026-05-27） で、Early Beta 段階のためアップデート時は Release Notes の確認をおすすめします。類似ツールとの主な違いは次のとおりです。
| 比較軸 | OpenHuman | OpenClaw | Hermes Agent | Claude Cowork |
|---|---|---|---|---|
| オープンソース | ✅ GNU GPL-3.0 | ✅ MIT | ✅ MIT | 🚫 プロプライエタリ |
| 操作 UI | ✅ デスクトップ GUI | ⚠️ ターミナル優先 | ⚠️ ターミナル優先 | ✅ デスクトップ + CLI |
| 記憶 | ✅ Memory Tree + Obsidian | ⚠️ プラグイン依存 | ✅ 三層メモリ | ✅ セッション単位 |
| 外部連携 | ✅ 118+ OAuth | ⚠️ 手動接続 | ⚠️ 手動接続 | ⚠️ 少数 |
| 自動同期 | ✅ 約20分ごと | 🚫 なし | 🚫 なし | 🚫 なし |
| モデルルーティング | ✅ 内蔵（TokenJuice 可） | ⚠️ 手動 | ⚠️ 手動 | 🚫 単一モデル |
コマンドラインで環境構築したくない方、日常のワークフローを AI に理解させたい方には、GUI と 118 以上のコネクタが大きな強みです。反面、初回 OAuth や macOS 権限ダイアログはグラフィカルな画面操作が必須——SSH のみのリモート環境では詰まりやすく、ここで VNC リモート Mac の出番になります。
一般ユーザー（バイナリインストール）向けには、追加ランタイムはほぼ不要です。macOS 12 Monterey 以上（14 Sonoma / 15 Sequoia 推奨）と Homebrew、または .dmg ダウンロードがあれば足ります。ソースからビルドする開発者には別要件があります。
| 項目 | バイナリ（一般） | ソースビルド（開発者） |
|---|---|---|
| macOS | 12+（14+ 推奨） | 同左 |
| Node.js | 不要 | 24+ |
| pnpm | 不要 | 10.10.0 固定 |
| Rust | 不要 | 1.93.0 |
| CMake / Xcode CLT | Homebrew 経由で要る場合あり | 必須 |
| GPU / CUDA | 不要 | 不要 |
OpenHuman は Electron ではなく Tauri（WebKit）を使い、推論は設定した LLM プロバイダが担います。本機 GPU は不要で、Apple M1/M2/M3/M4 いずれも快適に動きます。メモリ 8GB で日常利用は可能ですが、Memory Tree 有効化後は 16GB 以上を推奨します。アプリ本体は約 150〜200MB、Memory Tree データベースは初期 500MB 前後から長期利用で 2〜5GB まで増える見込みです。
tinyhumansai は Homebrew tap（推奨）、公式 .dmg、curl スクリプト（非推奨）、ソースビルドの四経路を提供しています。本節では Homebrew を中心に説明します。
Homebrew の確認：ターミナルで brew --version を実行します。未インストールなら次を実行してください。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
この際 Xcode Command Line Tools の GUI インストールが出ることがあります。VNC デスクトップ上で「インストール」を押せる点が、SSH だけより安全です。
tap 追加とインストール：
brew tap tinyhumansai/core brew install openhuman
完了後、~/Applications/OpenHuman.app に配置されます。チェックサム検証付きでバイナリが展開されます。
初回起動と権限：Spotlight（⌘ + Space）で OpenHuman を起動します。補助機能と通知の許可ダイアログが出るので、「システム設定 → プライバシーとセキュリティ → 補助機能」で OpenHuman にチェックを入れてください。
オンボーディング：LLM 設定：Claude、OpenAI GPT-4o/mini、Gemini、Grok、ローカル Ollama から選択し API Key を入力します（TokenJuice も可）。Memory Tree を活かすなら長コンテキスト対応モデル（Claude Sonnet 系など）が向いています。
OAuth 連携（118+）：Settings → Integrations で Google Drive/Gmail/Calendar、GitHub、Notion、Slack 等を選び、ブラウザの OAuth 画面で承認します。グラフィカルデスクトップ必須です。
Memory Tree 初回同期：Settings → Memory → Memory Tree で「Enable」を押すと、承認済みデータの走査とベクトル化が始まります。10〜25 分かかることがあり、強制終了は避けてください。
動作確認：「昨日送ったメールは？」（Gmail 連携時）や「今週の GitHub PR を振り返って」など、Memory Tree 由来の文脈付き回答が返れば成功です。
tinyhumans.ai/openhuman または GitHub Releases から arm64（Apple Silicon）/ x86_64（Intel）を選び、Applications へドラッグします。Gatekeeper で「開発元を確認できない」と出たら「システム設定 → プライバシーとセキュリティ」から「このまま開く」を選んでください。
curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash
公式はスクリプト改ざんを検知できないと明言しています。使う場合は -o install.sh で保存し、内容を目視確認してから実行してください。
git clone https://github.com/tinyhumansai/openhuman.git cd openhuman git submodule update --init --recursive pnpm install pnpm --filter openhuman-app dev:app
Node.js 24+、pnpm 10.10.0、Rust 1.93.0、CMake、Xcode CLT が揃っていることを確認してください。初回 Tauri ビルドは 5〜15 分程度かかります。
Memory Tree は OpenHuman 最大の差別化要素です。セッション単位ではなく、メール・PR・ドキュメント・カレンダーを横断する個人知識グラフとして約 20 分間隔で増分更新されます。
Settings → Memory → Memory Tree で間隔（最短 5 分、既定 20 分）と各ソースの期間（例：Gmail は直近 90 日のみ）を調整できます。範囲を広げるほど初回は遅くなりますが、Recall 精度は上がりやすいです。まずは既定値で一週間様子を見るのが無難です。
Settings → Memory → Local Sources に Vault ルートを追加すると、Markdown の変更を監視してインデックスを更新します。読み取り専用で .md は書き換えません。OpenHuman から Vault へ書き込む場合は Integrations → Obsidian Write を別途設定してください。
Integrations で除外キーワード（例：label:payroll）を指定するか、Local Sources で .private/ などを除外できます。データベースは ~/.openhuman/memory/ にあり、バックアップや別 Mac への移行に使えます。
Early Beta のため、初回セットアップで遭遇しやすい症状を表にまとめました。
| # | 症状 | 主な原因 | 対処 |
|---|---|---|---|
| 1 | brew install が 404 / tap 失敗 | Formula URL 変更、ネットワーク | brew update、または .dmg へ切替 |
| 2 | 起動直後クラッシュ（WebKit terminated） | macOS 12 未満、WebKit キャッシュ破損 | OS 確認、~/Library/WebKit/tinyhumansai 削除 |
| 3 | 補助機能ダイアログが一瞬で消える | TCC 未登録 | システム設定から手動で OpenHuman を追加 |
| 4 | OAuth コールバック失敗 | 既定ブラウザ、ポート競合 | 58080〜58090 の占有確認、ブラウザ変更 |
| 5 | Memory Tree が 0% のまま | ネットワーク、Token 失効 | Integrations で再認可 |
| 6 | LLM 応答なし / API Key invalid | Key 誤入力、残高不足 | Settings → LLM で Test Connection |
| 7 | 自動更新失敗 | .dmg 版の権限不足 | brew upgrade openhuman または手動 .dmg |
| 8 | マスコット非表示 | 表示倍率、補助機能未許可 | Retina 既定倍率、権限再確認 |
| 9 | Obsidian 監視が効かない | パス空白、ディスクアクセス不足 | パスを引用符で囲む、完全ディスクアクセス付与 |
| 10 | 音声・マイク無反応 | マイク権限、オーディオ競合 | プライバシー → マイクに OpenHuman を追加 |
表にない場合は ~/Library/Logs/tinyhumansai/ のログ、または GitHub Issues を参照してください。
OpenHuman は GUI 前提のため、次の操作はVNC などのグラフィカルセッションが必要です。
VNCMac のリモート Mac で OpenHuman を本番投入する際の検収手順（安定回線で約 20 分）です。
VNC 接続：VNC Viewer 等でデスクトップが表示されることを確認します。解像度は 1440×900 以上を推奨します。
Homebrew + OpenHuman：セクション 03 の手順 1〜2 を実行。CLT ダイアログは VNC 上で「インストール」を押します。
初回起動と権限：~/Applications/OpenHuman.app を起動し、補助機能・通知・必要なら完全ディスクアクセスをすべて許可します。
LLM と OAuth：VNC デスクトップの Safari/Chrome を既定ブラウザにし、Google/GitHub 等の OAuth を完了させます。コールバックが OpenHuman に戻ることを確認してください。
Memory Tree 検証：Settings → Memory の同期が緑チェックになるまで待ち、「最近最もコミットが多い GitHub リポジトリは？」など文脈付き回答が得られれば検収完了です。
以降の日常対話や brew upgrade の多くは SSH でも可能ですが、クリックが要る初回セットアップだけ VNC——この切り分けが運用を楽にします。
動作します。UI は WebKit、推論は API または Ollama が担うため GPU は必須ではありません。ローカル Ollama では Apple Silicon の ANE が補助しますが、必須ではありません。
有効化直後に承認済みコネクタの履歴を走査し、ベクトル化してローカル知識グラフへ書き込む処理です。10〜25 分かかることがあり、ネットワークを維持し強制終了しないでください。
公式はバイト整合性検証ができないと警告しています。Homebrew tap または署名付き .dmg を優先し、スクリプト利用時は内容確認後に実行してください。
Claude、OpenAI GPT 系、Gemini、Grok、Ollama に対応しています。TokenJuice で請求を一本化することも可能です。Settings → LLM で Test Connection を実行してください。
Homebrew 版は brew upgrade openhuman。.dmg 版はアプリ内更新または GitHub Releases から手動上書き。Early Beta では Release Notes の確認をおすすめします。
補助機能・OAuth・マイク権限など「画面をクリックする工程」は VNC 必須です。日常のチャットや brew upgrade は SSH でも可能で、初回だけ GUI が要ります。
OpenHuman は GUI で Agent の敷居を下げ、Memory Tree で仕事の文脈を蓄え、118 以上の OAuth でデジタル断片をひとつの検索可能な層にまとめます。その代償としてデスクトップ GUI への依存が残ります——初回権限、OAuth、Memory 同期の可視化はすべて「見える画面」が前提です。
Windows/Linux が主力機の方や、ディスプレイのない Mac で 7×24 常駐させたい方は、自宅 Mac mini の購入・維持も選択肢ですが、電源・故障リスクも伴います。VNC 付きリモート Mac を月額で借りる方法なら、GUI 認可を完了したうえで OpenHuman を常時オンラインに保てます——Mac mini M4 月額プランで検証する方も増えています。