OpenHuman インストールガイド(2026 最新版):5 分で AI デジタルツインを構築

AI ノート  ·  2026.05.29  ·  約 10 分

デスクトップでノート PC を使い OpenHuman 個人 AI デジタルツインをインストール・設定するユーザー

GitHub で OpenHuman を目にしたものの、まだ手を付けていないなら、これが2026 年最短の実装ルートです。ダウンロードから Agent が「今日の午後、会議がありますよ」と言えるまで——手順どおり進めれば、OAuth ダイアログと初回同期の待ち時間を含め慣れたユーザーなら約 5 分。OpenHuman はまた一つのチャット Web ページではなく、デスクトップ級の個人 AI デジタルツインです。ローカル Memory Tree、118+ サービスの OAuth、約 20 分周期のバックグラウンド同期。インストール後はアーキテクチャと Memory TreeAgent Skill の深掘り記事もどうぞ。本記事は「どう入れるか、どう設定するか、成功をどう確認するか」だけに絞ります。

5
分で開始(OAuth 含む)
118+
OAuth 連携
20
分の同期周期

インストール前の準備

OpenHuman は Tauri デスクトップアプリ(Rust コア + Web UI)で、公式には macOS、Windows、Linux をサポートしています。2026 年時点では Apple Silicon Mac が最も快適——ローカル Ollama や MLX 推論と同一マシンに載せるとレイテンシが低くなります。インストール前に以下を確認してください:

  • システム権限— macOS では「プライバシーとセキュリティ」でダウンロードした App を許可(App Store 外の場合は右クリック→「開く」)。
  • LLM 認証情報を 1 つ以上— Anthropic / OpenAI API Key、または稼働中の Ollama(任意)。Key がなくても UI は開けますが、Agent は推論できません。
  • 接続するアカウントを 2〜3 個— 初回は Gmail + Google Calendar + GitHub(開発者)または Notion + Slack(ナレッジワーカー)を推奨。空の Memory Tree では 5 分検証は失敗します。
  • ディスクとネットワーク— Memory Tree はローカル SQLite + Markdown に書き込み、数百 MB を確保。OAuth と初回取得には安定した回線が必要。

依存関係とソースビルドは公式リポジトリの docs/ を参照。日常利用ではクローン不要です。半ばでアーキテクチャや Homebrew 未整備に気づかないよう、ターミナルで環境セルフチェックを先に実行することをおすすめします:

インストール前セルフチェック(macOS ターミナル)
# 1. システムとチップ(Apple Silicon は arm64)
sw_vers
uname -m

# 2. Homebrew が使えるか(brew 経由インストール時)
brew --version
brew doctor

# 3. ローカル Ollama を使う場合、11434 ポートが空いているか
lsof -i :11434 || echo "ポート 11434 は空いています。Ollama を起動できます"

# 4. ディスク空き(Memory Tree + モデルキャッシュ、≥5GB 推奨)
df -h ~

3 つのインストール方法:公式パッケージ、Homebrew、スクリプト

公式 README では、署名付きネイティブインストーラーまたはシステムパッケージマネージャーを優先し、スクリプトはクイック体験向けだがサプライチェーンリスクが高いと明記されています。下表は推奨順です。

方法向いている人コマンド / 入口
公式インストーラー(推奨)macOS / Win / Linuxtinyhumans.ai/openhuman または GitHub Releases(DMG / MSI / deb / AppImage)
Homebrew(macOS / Linux)ターミナルに慣れた Mac ユーザーbrew tap tinyhumansai/corebrew install openhuman
ワンラインスクリプト(デモ用)お試し、CI サンドボックスcurl -fsSL …/install.sh | bash(先に --dry-run 可)
方法 A · 公式 DMG(GUI + コマンドライン補助)
# ブラウザで最新 Release を開く(チップに合う arm64 / x64 を選択)
open "https://github.com/tinyhumansai/openhuman/releases/latest"
# または公式ダウンロードページ
open "https://tinyhumans.ai/openhuman"

# ダウンロード後、コマンドで DMG をマウントして「アプリケーション」へコピー(ファイル名は実際のものに合わせる)
hdiutil attach ~/Downloads/OpenHuman*.dmg
cp -R "/Volumes/OpenHuman/OpenHuman.app" /Applications/
hdiutil detach "/Volumes/OpenHuman"

# macOS が「開発元を確認できない」とブロックした場合、隔離属性を解除してから開く
xattr -dr com.apple.quarantine /Applications/OpenHuman.app
open -a OpenHuman
方法 B · Homebrew(2026 公式推奨、再現可能なアップグレード)
# 1. 公式 tap を追加(初回のみ)
brew tap tinyhumansai/core

# 2. インストール(現在の stable バイナリを取得)
brew install openhuman

# 3. PATH に入ったか確認
which openhuman
openhuman --version

# 4. デスクトップ版を起動(CLI が App を起動、または Launchpad から OpenHuman)
openhuman

# 5. 今後のアップグレード
brew update
brew upgrade openhuman

# 代替:core tap を追加しない場合の一部ドキュメント記載
# brew install tinyhumansai/openhuman/openhuman
方法 C · npm グローバルインストール(クロスプラットフォーム、Node ≥ 18)
# Node バージョン確認
node -v

# npm パッケージをインストール(初回はプラットフォーム別ネイティブバイナリを SHA-256 検証付きで取得)
npm install -g openhuman

openhuman --version
openhuman
方法 D · Debian / Ubuntu · apt 署名リポジトリ
# 1. GPG をインポートして apt ソースを追加(公式 install ドキュメント手順)
sudo apt-get install -y 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

# 2. インストールして起動
sudo apt-get update
sudo apt-get install -y openhuman
openhuman --version
方法 E · ワンラインスクリプト(プレビューしてから実行)
# 1. スクリプトをダウンロードのみ(内容確認を推奨)
curl -fsSL \
  https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh \
  -o /tmp/openhuman-install.sh
less /tmp/openhuman-install.sh

# 2. 公式 dry-run プレビュー(スクリプト版がパラメータ対応の場合)
bash /tmp/openhuman-install.sh --dry-run --verbose

# 3. 問題なければインストール
bash /tmp/openhuman-install.sh

# macOS / Linux ワンライン版(上記 3 と同等)
curl -fsSL \
  https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh \
  | bash

# Windows PowerShell:
irm https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.ps1 | iex

セキュリティ注意

パイプスクリプト(curl | bash)はどのプロジェクトでもサプライチェーンリスクがあります。企業環境では 署名 DMG + MDM 配布、または内部ミラー Homebrew tap を利用してください。個人学習ではスクリプトも可ですが、本番キーがあるマシンでは裸実行しないでください。

macOS 手順コマンド:インストールから検証まで(完全例)

以下はコピー可能なターミナル + GUI ハイブリッド経路です。デフォルトは Homebrew インストールと Anthropic API。DMG 経由なら「ステップ 3」から開始。各ステップ後に成功確認方法を記載しています。

ステップ 1–2 · インストールとプロセス確認
brew tap tinyhumansai/core
brew install openhuman
openhuman --version
open -a OpenHuman

# App が起動しているか確認(OpenHuman 関連プロセスが見えるはず)
pgrep -lf -i openhuman || ps aux | grep -i openhuman | grep -v grep
ステップ 3 ·(任意)先に Ollama を起動し「ローカルモデル」オプション用に
# Ollama をインストールしてバックグラウンド起動(OpenHuman とは別だが同一 GPU 共有可能)
brew install ollama
brew services start ollama

# 小さめモデルを取得して接続テスト(サイズ・名前は任意)
ollama pull llama3.2

# API 疎通:JSON が返り models リストを含むはず
curl -s http://127.0.0.1:11434/api/tags | head -c 400
echo
ステップ 4 · OpenHuman でモデル設定(GUI + ターミナル補助)
# GUI:Settings → Models / Providers
#   - クラウド:Anthropic API Key(sk-ant-...)または OpenAI Key を貼り付け
#   - ローカル:Base URL に http://127.0.0.1:11434、モデルに llama3.2 など

# Key を shell 履歴に書かない;CLI テストで環境変数が必要なら一時 export:
read -s ANTHROPIC_API_KEY && export ANTHROPIC_API_KEY
# (入力後 Enter、ターミナルはエコーなし;終了後 unset ANTHROPIC_API_KEY 可)

# Anthropic キー有効性の独立プローブ(OpenHuman とは無関係)
curl -s https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-4-20250514","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}' \
  | head -c 300
echo
ステップ 5 · OAuth 連携(GUI メイン、統一 CLI なし)
# GUI:Connections / Integrations → 順に Connect をクリック
#   推奨順:Gmail → Google Calendar → GitHub
# ブラウザで OAuth 完了後、App に Connected / Active と表示されるはず

# 会社プロキシでコールバック失敗時、HTTPS 出站を先にテスト:
curl -sI https://github.com | head -5
curl -sI https://accounts.google.com | head -5
ステップ 6 · 同期を待ち Memory Tree ディレクトリを確認
# OpenHuman を 5〜20 分起動したまま;メニューバーで同期状態を確認可
# データディレクトリはバージョンにより異なる:App「Settings → Data / Memory」でパスを確認
# 多くは Application Support 配下、find で粗く検索(数秒かかる場合あり):
find ~/Library/Application\ Support -maxdepth 3 -iname '*openhuman*' 2>/dev/null

# Memory Tree ルートが $MEMORY_DIR と分かっている場合、最新 Markdown を一覧:
# MEMORY_DIR="…/memory"   # 設定画面のパスに置換
# ls -lt "$MEMORY_DIR" | head
# find "$MEMORY_DIR" -name '*.md' -mtime -1 | head

# 任意 .md に実データ行(メール/会議/PR)があるか spot チェック
# head -40 "$(find "$MEMORY_DIR" -name '*.md' | head -1)"
ステップ 7 · 会話検証(App チャットに入力、例は以下)
# テスト 1 — カレンダー(Google Calendar 接続済みが前提)
「今日の会議タイトルと開始時刻を一覧し、Memory Tree の出典を引用してください。」

# テスト 2 — GitHub(GitHub 接続済みが前提)
「最近マージした PR があるリポジトリは?リポジトリ名と PR タイトルを教えて。」

# 失敗時:回答が泛泛としていればステップ 6 に戻り .md が生成されたか確認

5 分初回設定チェックリスト(順番にチェック)

長いコマンドよりチェックリスト派なら、以下を順に。前節のコマンドと1 対 1 対応。計測はアプリ起動後から。

  1. 1 分目:モデルプロバイダー選択— Settings に Anthropic / OpenAI Key、または Ollama Base URL http://127.0.0.1:11434curl …/api/tags または Anthropic プローブでキー有効性を確認。
  2. 2〜3 分目:OAuth 接続— Connections で Gmail、Calendar、GitHub を Connect。ブラウザ認可後 Connected 表示。
  3. 4 分目:初回同期トリガー— App を起動したまま。find ~/Library/Application Support -iname '*openhuman*' でデータディレクトリを特定し、当日の .md を確認。
  4. 5 分目:会話検証— 前節「テスト 1 / 2」で質問。具体的事実を引用できれば成功。

サービス接続と Memory Tree 検証

OpenHuman の「デジタルツイン感」はMemory Tree から来ます。サードパーティデータが ≤3k token の Markdown ブロックに正規化され、ローカル SQLite に書き込まれ、Obsidian で開ける .md としてエクスポートされます。動作確認は UI の緑ランプだけでなく、ファイルがディスクに落ちたかを見てください:

  • アプリ内 Memory Tree / メモリディレクトリで、新規ファイルのタイムスタンプが今日であることを確認。
  • テキストエディタで任意の .md を開き、メール件名、会議タイトル、PR 名など照合可能な事実があり、空テンプレートでないこと。
  • 任意:agentmemory バックエンドを共有し、OpenHuman と Claude Code で永続メモリを共用(上級)。
Memory Tree / SQLite 粗査(MEMORY_DIR を設定画面のパスに置換)
# 本日追加された Markdown 数を集計
find "$MEMORY_DIR" -name '*.md' -mtime -1 2>/dev/null | wc -l

# 最新 3 断片の更新時刻
find "$MEMORY_DIR" -name '*.md' -print0 2>/dev/null \
  | xargs -0 ls -lt 2>/dev/null | head -3

# 近くに SQLite がある場合(ファイル名はバージョン依存)、sqlite3 でテーブル確認
find "$MEMORY_DIR/.." -maxdepth 2 -name '*.sqlite' -o -name '*.db' 2>/dev/null
# DB="/path/to/openhuman.db"
# sqlite3 "$DB" ".tables"

「ChatGPT との違いは?」—— ChatGPT のコンテキストは会話内、OpenHuman のコンテキストはディスク上で監査可能なファイル。だから GitHub で話題になっています。製品背景は5 日間体験記も参照。

OpenClaw との役割分担は?

OpenHuman は個人コンテキスト(メール、カレンダー、ノート)。OpenClaw は IM オーケストレーションとビルドパイプライン向け。OpenHuman を入れても Xcode CI は代替しません。OpenClaw を入れても受信トレイは自動では読めません。両方併用が現実的です。

Mac ユーザー向け:ローカル vs クラウド Mac 常駐

OpenHuman はデスクトップ常駐向け設計:蓋を閉じてスリープすると同期が遅れます。「退勤後 PC を切ってもツインがメール要約を取り続ける」なら、常時オンラインの Mac mini に載せる——例えば ZavCloud クラウド Mac 専有ノード:ネイティブ macOS、固定 IP、OAuth コールバックと長期バックグラウンドタスクに適しています。注意:OAuth トークンと Memory Tree ファイルは機密。クラウド展開ではディスク暗号化、アクセス制御、バックアップを別途。個人 Gmail をマルチテナント共有環境に直接置かないでください。

ローカル Apple Silicon では Ollama / MLX でオフライン推論も可能——OpenHuman の「データはローカル」という物語と一致。モデルもメモリもローカル、連携同期だけが外網。iOS 開発ならコーディングは Cursor / Claude Code、着手前に OpenHuman に「今日会議多い?」と聞く——Anthropic と Claude Code の記事で似たハイブリッドワークフローを書きました。

クラウド Mac 常駐(例:SSH ログイン後も同様に brew インストール)
# macOS クラウドホストにログイン後
brew tap tinyhumansai/core && brew install openhuman
openhuman --version

# GUI なし環境では一部バージョンが同期エンジンのみ実行可能;公式ドキュメント参照
# 推奨:VNC/画面共有で初回 OAuth を完了し、セッションをログイン維持

# 蓋閉じスリープで同期が止まらないよう(データセンター方針に応じて)
sudo pmset -c sleep 0 displaysleep 0

トラブルシューティング

  • インストール後に開けない(macOS)— システム設定 → プライバシーとセキュリティ → それでも開く;または App を右クリック → 開く。企業 MDM が未公証パッケージをブロックする場合は Releases の署名 DMG を利用。
  • OAuth コールバック失敗— プロキシ/VPN、システム時刻、ブラウザのポップアップブロックを確認。社内ネットが Composio ドメインを遮断している場合は IT にホワイトリスト依頼。
  • Memory Tree が空のまま— 連携が Connected か確認。完全な同期周期(約 20 分)を待つ。公式 Issues で地域 API レート制限がないか確認。
  • Agent が hallucinate— メモリ未書き込み、またはモデルが「メモリ読取」ツール未有効。質問範囲を絞り、@ で特定メモリファイルをテスト(バージョン対応時)。
  • brew install が見つからない— 先に brew tap tinyhumansai/core してから install。Intel Mac は Releases に該当アーキテクチャがあるか確認。
トラブルシュートコマンド早見表
# Homebrew インストール失敗:キャッシュクリアして再試行
brew update
brew cleanup
brew reinstall openhuman

# クラッシュ後の macOS クラッシュログ
log show --predicate 'process == "OpenHuman"' --last 1h | tail -50

# Ollama は起動しているが OpenHuman から接続不可
curl -s http://127.0.0.1:11434/api/tags
lsof -i :11434

# 完全アンインストール後に再インストール(brew 経路)
brew uninstall openhuman
rm -rf ~/Library/Application\ Support/*openhuman* 2>/dev/null
brew install openhuman

# 公式リポジトリ最新 Issue(gh CLI 必要)
gh issue list -R tinyhumansai/openhuman -L 5
上級 · ソースから実行(コントリビューター / デバッグ、5 分ルート外)
git clone https://github.com/tinyhumansai/openhuman.git
cd openhuman
git submodule update --init --recursive
pnpm install
# Web UI のみ
pnpm dev
# フル Tauri デスクトップ開発
pnpm dev:app
# Rust 側チェック
cargo check -p openhuman --lib

FAQ

常時ネット必須? インストール、OAuth、クラウドモデルには必要。メモリファイルはローカル。Ollama なら弱い回線でも会話可だが、メール/カレンダー同期はネット必須。

無料? クライアントは OSS(GPL-3.0)。モデル API と一部コネクタは第三者課金の可能性あり。選んだプロバイダーの請求を参照。

Cursor Rules / Claude Code と競合? しません。OpenHuman はリポジトリを編集せず、コーディング Agent は Gmail を読みません。役割は分離。

ZavCloud · クラウド Mac

ツインを 24 時間オンラインに?本物 macOS の常駐ノードを

Mac mini M4 専有インスタンス:ネイティブ macOS、固定 IPv4——OpenHuman バックグラウンド同期、Ollama、Xcode を同一台の監査可能マシンで。

プランと料金を見る
Cloud MacMac mini をオンラインでレンタル