2026 OpenHuman インストール完全ガイド：Homebrew / apt / npm 導入 + Memory Tree オンボーディング + クラウド Mac 24時間運用

OpenHuman は TinyHumans AI が GPL-3.0 で公開する個人向け AI スーパーアシスタントです。Rust + TypeScript、Tauri v2 デスクトップ、SQLite 永続化、200 以上のクラウドモデルルーティング、Ollama / LM Studio によるローカル推論に対応します。セッションごとに消えるチャットボットではなく、接続アカウントとローカルファイルから継続的にコンテキストを取得し、Memory Tree として Markdown 構造に整理します。週を跨いだ習慣、プロジェクト文脈、連絡先の優先度がここに蓄積され、以降の推論に注入されます。

インストール成功は第一関門に過ぎません。ユーザーはデスクトップまたは音声経由でアシスタントに依頼し、先週の決定事項を踏まえた応答を期待します。そのためには設定ディレクトリ、SQLite データベース、Memory Tree ファイル群が再起動と OS アップデートを跨いで存続するホストが必要です。開発用 MacBook で以下の手順を試すのは問題ありませんが、本番 Memory Tree をスリープするノート PC に載せるのは適切ではありません。記憶の複利効果が証明された段階で、多くのチームは同一設定 tarball を専用クラウド Mac へ移行します。

本記事は、GUI または SSH + VNC、外向き HTTPS、OAuth 連携を許可する権限があることを前提とします。OpenHuman は早期ベータです。pin したバージョンの上流ドキュメントを正とし、本番では main を追跡せず GitHub Releases の検証済みビルドを選んでください。

コミュニティスレッドで多いのは壊れたインストーラではなく、ホスト不一致、Headless Linux への GUI 期待、設定ディレクトリのエフェメラル配置、ローカル AI の未オプトインです。下表は、Memory Tree を常時育成させるうえで各プラットフォームが満たすべき条件と、典型的な失敗パターンを対照したものです。

• インストール経路の選択：Homebrew と apt は OS パッケージ署名チェーンを通します。npm は Node 18+ が必要で、初回にネイティブバイナリを SHA-256 検証付きで取得します。curl 一行は最速ですが、本番 Mac では Releases DMG または Homebrew を推奨します。
• 専用 Unix ユーザー：root や共有ログインユーザーではなく、固定 Home を持つ非 root アカウントで OpenHuman を実行します。OAuth Token と Memory Tree 権限が複雑化するのを防ぎます。
• ディスク設計：設定ディレクトリ、SQLite、Memory Tree、ログ用に別領域を確保します。20GB root ボリュームは数週間の連携同期で満杯になりやすいです。
• ローカル AI：デフォルト無効です。config.toml で local_ai.runtime_enabled と local_ai.opt_in_confirmed を明示的に true にしない限り、Ollama が起動していても OpenHuman はクラウドモデル経路のみです。
• スナップショット方針：Memory Tree は利用に伴い成長します。パイロット中にディスクスナップショットを乱発すると、週次で蓄積した嗜好が消えます。設定ツリーの tarball バックアップを先に確立してください。

いずれかの経路でインストール直後に GUI を一度起動し、バージョン表示と設定 Home の書き込み権限を確認してください。OAuth 連携の失敗を Memory Tree のせいにする前に、ネットワークとディスク永続性を先に直すほど、オンボーディング時間を短縮できます。

上流は五つの公式経路を提供します。macOS 本番では Homebrew または署名付き DMG、Debian 系 Linux では signed apt repo、CI やクロスプラットフォーム CLI では npm、監査重視チームでは GitHub Releases の直接取得、最速検証では curl スクリプトが定番です。以下 6 ステップは、新規 NUKCLOUD インスタンスとクリーンな Ubuntu デスクトップの双方で検証済みの順序です。

1. 01
   ホスト準備：macOS では Xcode Command Line Tools を確認します。Ubuntu / Debian では sudo apt update && sudo apt install -y curl gnupg2 ca-certificates を実行します。OpenHuman 専用ユーザーを作成し、Home を tmpfs ではなく永続ディスク上に置きます。
2. 02
   経路選択とインストール：下記いずれかを実行します。本番では pin したリリースタグに合わせ、Homebrew bottle または apt パッケージバージョンを固定してください。
3. 03
   バイナリとバージョン確認：アプリまたは openhuman --version で CLI が応答することを確認します。npm 経路ではグローバル bin が PATH に入っているか確認します。
4. 04
   初回 GUI 起動：macOS では Applications から、Linux ではデスクトップエントリまたは AppImage から起動します。Headless クラウド Mac では VNC または画面共有を先に開いてください。
5. 05
   設定 Home 確認：ウィザードが示すユーザー設定ディレクトリに config.toml が生成されることを確認します。権限は専用ユーザーのみが読み書きできること。
6. 06
   ベースライン記録：macOS マイナーバージョンまたは /etc/os-release、インストール経路、設定ディレクトリパス、初回バージョンを記録します。Memory Tree 接続前に tarball 化しておけば、悪アップグレードで SQLite が壊れた際に復元できます。

brew tap tinyhumansai/core
brew install openhuman
openhuman --version

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
sudo apt-get update
sudo apt-get install -y openhuman

npm install -g openhuman
openhuman --version

https://github.com/tinyhumansai/openhuman/releases/latest
OpenHuman_*_aarch64.dmg
OpenHuman_*_amd64.deb
OpenHuman_*_amd64.AppImage

curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash

新規クラウド Mac では、プロバイダパネルで provision し、SSH Key を登録、VNC を有効化してからインストール経路を選んでください。本番 SKU を決める段階では 注文ページ でディスクと RAM を先に選び、Memory Tree と SQLite が cramped な root ボリュームを共有しないようにします。NUKCLOUD コンソール Runbook に沿って SSH 接続する場合も、インストールコマンド自体は自宅 Mac と同一です。

モデルエンドポイントのない OpenHuman は空のデスクトップシェルです。設定はユーザー設定ディレクトリの config.toml と OAuth 資格情報に置かれます。ファイル名とキーはリリースで変わるため、pin したバージョンの上流ドキュメントを正とし、ブックマークを維持してください。

ローカル AI 有効化：デフォルトではクラウドモデル経路のみです。Ollama または LM Studio を使う場合、config.toml で明示的にオプトインします。Ollama は 127.0.0.1:11434 で先行起動させ、設定 UI からエンドポイントを選択してください。OLLAMA_KEEP_ALIVE=-1 はコールドスタート抑制に有効です。

クラウド Provider：200 以上のモデル slug にルーティングできます。API Key は mode 600 の env ファイルに置き、設定から参照します。軽量タスクと推論タスクでモデルを分ける model routing が Memory Tree 注入コストの最適化に有効です。

永続パス：設定ディレクトリ、SQLite、Memory Tree フォルダが永続ボリューム上にあることを確認します。Docker やエフェメラル VPS イメージでは、これらのパスを明示的に bind-mount しないと、コンテナ再作成で週次記憶がリセットされます。

local_ai.runtime_enabled = true
local_ai.opt_in_confirmed = true

brew install ollama
ollama pull qwen2.5:7b
export OLLAMA_KEEP_ALIVE=-1
ollama serve
curl http://127.0.0.1:11434/api/tags

設定編集後は GUI を再起動し、ローカルモデル一覧が表示されるか確認してください。チームが OpenClaw + Ollama ローカル Agent も評価している場合、OpenHuman はデスクトップ記憶と SaaS 連携が強みです。同機共存は可能ですが、Ollama モデルロードとメモリ競合を避けるため、時間帯で分けるかモデルサイズを tier 分けしてください。Telegram 本番ゲートウェイが必要なら Hermes Agent インストール記事 の launchd 手順を別ホストまたは別ユーザーで参照してください。

Memory Tree は OpenHuman の中核です。初回ウィザードでデータソースを接続し、以降バックグラウンド同期が Markdown 構造に圧縮・整理します。Gmail、Notion、Slack、GitHub、カレンダー、ローカルファイルなど、チームの実ワークフローに合わせて段階的に追加してください。一度に全連携を有効化すると OAuth 失敗の切り分けが困難になります。

初回オンボーディング：VNC または画面共有でクラウド Mac に入り、GUI ウィザードを完了します。各 SaaS で OAuth 同意画面が開くため、Headless SSH のみでは不十分です。接続成功後、Memory Tree ビューでノードが増えることを 24 時間以内に確認してください。

macOS 常駐：ログイン項目または LaunchAgent で OpenHuman を自動起動します。WorkingDirectory を設定 Home に合わせ、クラッシュ時 KeepAlive を有効にします。NUKCLOUD クラウド Mac も自宅 Mini も手順は同一です。

Linux デスクトップ：systemd user unit で GUI セッション起動後に OpenHuman を載せます。loginctl enable-linger で SSH ログアウト後も同期ジョブを維持できます。Pure VPS では VNC デスクトップスタックの構築が前提です。

1. 01
   GUI 初回起動 → 言語とプライバシー同意 → 設定 Home の場所を確認します。
2. 02
   Memory Tree ウィザードで Gmail / Notion / Slack から 1 つずつ接続し、各 OAuth 成功を確認します。
3. 03
   config.toml で local_ai を有効化し、Ollama エンドポイントを設定 UI から選択します。
4. 04
   テストプロンプトで「先週の会議メモ」を想起できるか確認し、Memory Tree ノード増分を観測します。
5. 05
   launchd または systemd で常駐化し、意図的 kill 後 30 秒以内の再起動と SQLite 存続を確認します。
6. 06
   設定ディレクトリの週次 tarball バックアップをスケジュールします。72 時間安定後に追加 SaaS 連携を開放してください。

[Unit]
Description=OpenHuman Desktop Agent
After=graphical-session.target

[Service]
ExecStart=/usr/bin/openhuman
Restart=on-failure
RestartSec=15
Environment=DISPLAY=:0

[Install]
WantedBy=default.target

運用メモ：最初の 1 週間は同期ジョブエラー、ディスク増分、OAuth Token 更新失敗を毎日確認します。7 日間安定稼働後は設定ツリーと Memory Tree の週次 tarball を維持してください。day-two 用：Releases ページでバージョン drift 確認、アップグレード前の設定バックアップ、Linux では journalctl --user -u openhuman.service、macOS では Console.app フィルタです。

インストーラは意図的にクロスプラットフォームです。ホスティング選択が、Memory Tree が週次で育つかリセットされるかを決めます。Headless Linux VPS に curl だけ流しても、OAuth オンボーディングと Tauri GUI が欠けるため本番 Memory Tree には向きません。自宅 Mac mini は電源と ISP をコントロールできる場合に有効です。エンタープライズチームは、VNC 到達性と文書化されたテナント境界を持つクラウド Mac を選ぶことが多いです。

ハード購入前に Memory Tree の複利を検証したいチームには、NUKCLOUD の従量制クラウド Mac がキャッシュフローを保ちつつ、同期品質とディスク永続性を測れます。汎用分課金 macOS VPS は CPU オーバーセルで同期ジョブ中に GUI が落ちやすいです。Memory Tree が本番向けの場合、月十ドル節約より、安定ディスク・予測可能な外向きネットワーク・再起動耐性の方が重要になります。