チェックリストに沿って OpenHuman を導入：2026 ダウンロードから初回動作確認まで
OpenHuman のインストール記事は、読み終えても「今どの段階にいるのか」が分かりにくいことが多いです。本稿は説明書のように長く書かず、ゼロから動作確認までをチェックボックスに分解します。各項目には合格の目安、失敗時に先に見る場所、次へ進んでよいタイミングを添えています。
先に押さえること： OpenHuman を「動いている」と言えるには、インストール・起動・ログイン・モデル・連携・メモリ・実戦出力の七つを通過する必要があります。OAuth 権限の拡大や本番メール・リポジトリ接続は、ここがすべて合格してからにしてください。製品は Early Beta のため、コマンドと UI は tinyhumansai/openhuman と 公式 GitBook を基準に確認してください。
対象の境界： 本文はデスクトップ版 OpenHuman（ローカル Memory Tree と Obsidian 互換 Markdown vault を持つ個人 AI エージェント）向けです。OpenHuman WebGL アバター SDK（Web／3D 埋め込み用）とは別製品です。WebGL 向けドキュメントが必要なら SDK リポジトリを参照し、デスクトップクライアントには本チェックリストを使わないでください。
各行は ☐ 確認手順 → 合格基準 → 失敗時はここを先に確認 の形式です。テスト用アカウントや低リスクなデータソース（個人 Gmail のラベル、読み取り専用 GitHub など）で一覧を完了してから、本番データに広げてください。まだ導入すべきか迷う場合は、当サイトの OpenHuman は誰向け？ も参照してください。
総チェックリスト：OpenHuman を動かす 9 段階
順番どおり進め、現段階が合格するまで次に進まないでください。
| 段階 | 合格の目安 | 公式参照 |
|---|---|---|
| ① インストール前 | OS・ディスク・ネットワーク・アカウント・権限の前提が揃っている | README「Local + managed services」 |
| ② ダウンロード | 入手経路を決定（サイト／Release／パッケージマネージャ／スクリプト） | tinyhumans.ai/openhuman |
| ③ インストール | アプリまたは CLI が起動し、バージョン確認できる | GitHub Releases／Homebrew／apt |
| ④ 起動 | メイン UI が表示され、クラッシュループしない | アプリ内オンボーディング |
| ⑤ ログイン | OpenHuman アカウントのセッションが有効 | マネージドサインイン（デフォルト） |
| ⑥ モデル | マネージドルーティングまたは BYOK／Ollama で 1 回チャット成功 | Model routing |
| ⑦ 連携 | OAuth 連携が 1 件以上「接続済み」 | Composio コネクタ層（マネージド既定） |
| ⑧ メモリ | Memory Tree／vault に新規データがあり、空のままではない | 約 20 分の自動取得サイクル |
| ⑨ 実戦＋收尾 | 文脈に基づく応答と引き渡しメモ | 本文セクション 8〜9 |
1. インストール前の準備チェックリスト
ダウンロード前に完了してください。Memory Tree、Obsidian 互換 vault、ワークスペース設定はローカルに置かれますが、サインイン・モデルルーティング・Web 検索プロキシ・マネージド OAuth は OpenHuman 側サービスを使う場合があります。完全オフライン前提では進めないでください。
| ☐ | 確認手順 | 合格基準 | 失敗時はここを先に確認 |
|---|---|---|---|
| ☐ | プラットフォームと CPU を確認 | macOS（デスクトップ体験が最も充実）、Linux x64（Debian/Ubuntu は .deb、その他は AppImage 注記参照）、Windows（.msi）。Apple Silicon／amd64 が Release アセットと一致 | Latest release に自環境用インストーラがある |
| ☐ | ディスクとメモリ | SQLite・Markdown vault・埋め込み用に ≥10〜20GB を確保；複数連携＋ Ollama 試行ならユニファイドメモリ 16GB 以上が有利 | 古い vault を整理；アクティブ連携を減らす |
| ☐ | ネットワークとプロキシ | GitHub・tinyhumans.ai・OAuth コールバック先に到達；社内プロキシ下でもブラウザログイン可能 | システムプロキシ／ファイアウォール；スクリプトインストール中は切断しない |
| ☐ | OpenHuman アカウント | 登録済みまたは登録予定；既定はマネージドモデルルーティング（BYOK は任意） | メール認証・地域制限；GitBook のアカウント説明 |
| ☐ | テスト用データソース方針 | 個人テストメール／読み取り専用 GitHub／空の Notion から接続——初日に会社全体の Google Workspace は認可しない | Integrations で切断；テスト vault を削除して再試行 |
| ☐ | macOS 向け追加（該当時） | 開発元を確認して開く；連携でカレンダー・マイク等の許可を付与 | システム設定 → プライバシーとセキュリティ；DMG を再マウントしてアプリケーションにコピー |
| ☐ | Linux Wayland 注意 | Debian/Ubuntu では署名付き公式 .deb を優先（AppImage は後回し） |
README：Wayland 上の AppImage はクラッシュする場合あり（issue #2463）；.deb または環境変数回避 |
2. ダウンロード元の選び方
公式 README は OS 署名チェーンを通るネイティブパッケージマネージャを推奨しています。スクリプトインストールも可能ですが、別途の完全性検証はない点に注意してください。
| 入手経路 | 向いている人 | 合格基準 | 失敗時はここを先に確認 |
|---|---|---|---|
サイト／GitHub Release.dmg .msi .deb .AppImage |
GUI インストーラ希望；ターミナルを避けたい人 | ハッシュ／署名が Release ページと一致；Launchpad またはスタートメニューに表示 | アーキテクチャ誤ダウンロード；Gatekeeper ブロック |
Homebrewbrew tap tinyhumansai/core && brew install openhuman |
macOS／Linux でアップグレード可能な CLI が欲しい開発者 | which openhuman がパスを返す；openhuman --version が出力（CLI が版番号を出す場合） |
tap 未追加；brew update のあと brew upgrade openhuman |
| apt（Debian/Ubuntu） 署名付きリポジトリ + apt install openhuman |
Linux サーバーまたは長期デスクトップ運用 | dpkg -l | grep openhuman でインストール済み |
GPG キー／sources.list の手順が README どおり完了しているか |
| curl／irm スクリプト | 手早く試す；スクリプト改ざん検知がないことを了承 | スクリプトがエラーなく終了しアプリ起動。README では GPG 付き検証フローは Releases で準備中——公開前にリポジトリで再確認 | Homebrew／サイトインストーラへ切替；raw.githubusercontent.com のプロキシ |
3. 三大プラットフォームのインストールチェックリスト
macOS
| ☐ | 確認手順 | 合格基準 | 失敗時はここを先に確認 |
|---|---|---|---|
| ☐ | 選択肢 A：公式サイトから DMG を取得しアプリケーションにドラッグ | Dock／Launchpad から OpenHuman が起動；即終了しない | 右クリックで開いて Gatekeeper を回避；空き容量 |
| ☐ | 選択肢 B：brew tap tinyhumansai/core && brew install openhuman |
バイナリ名は openhuman（README）；ターミナルまたはドキュメントどおり GUI 起動 |
Xcode CLT；Homebrew の権限 |
Linux（Debian/Ubuntu 例）
| ☐ | 確認手順 | 合格基準 | 失敗時はここを先に確認 |
|---|---|---|---|
| ☐ | apt キーとソースを追加（README の全文コマンド）のあと sudo apt install -y openhuman |
パッケージマネージャがインストール済み；デスクトップアイコンまたは openhuman が実行可能 |
arch=amd64 制限；GPG キーのパス |
| ☐ | Arch：AUR openhuman-bin（公開された場合） |
README の「Once published」に合致；未公開なら Release アセットを使用 | AUR ページの有無 |
Windows
| ☐ | 確認手順 | 合格基準 | 失敗時はここを先に確認 |
|---|---|---|---|
| ☐ | Release から署名付き .msi をダウンロードしてインストール |
スタートメニューに OpenHuman；初回起動で UAC ループしない | SmartScreen；または PowerShell スクリプト（README と同じ注意） |
4. 初回起動とログインのチェックリスト
| ☐ | 確認手順 | 合格基準 | 失敗時はここを先に確認 |
|---|---|---|---|
| ☐ | コールドスタートでアプリ起動 | メイン UI またはオンボーディングが表示；起動直後に終了しない | App Diagnostics またはシステムログ（現行 UI のパス）；Linux は .deb を試す |
| ☐ | OpenHuman アカウントでサインイン完了 | 設定にサインイン済みユーザー；再起動後もセッション維持 | ブラウザのポップアップブロック；時刻ずれ；企業 SSO 制限 |
| ☐ | 短いオンボーディングを完了（表示される場合） | チャット UI に到達；メイン会話が応答する | スキップした任意項目がブロックしていないか；最新 Release へ更新 |
5. モデルと BYOK の設定チェックリスト
既定では OpenHuman のモデルルーティングがタスクごとに推論／高速／ビジョン用モデルを選びます。1 つのサブスクリプションで複数モデルを使え、API キーを積み上げる必要はありません。自前キーやローカル推論は設定でカスタム／Ollama に切替（GitBook）。
| ☐ | 確認手順 | 合格基準 | 失敗時はここを先に確認 |
|---|---|---|---|
| ☐ | マネージドルーティングのスモークテスト | 短い自己紹介プロンプトに数秒以内で一貫した応答；401/429 が続かない | サブスクリプション状態；ネットワーク；GitBook Model routing トラブルシュート |
| ☐ | （任意）BYOK：プロバイダキーを入力 | 設定が保存；テストメッセージが自社クォータを使用；キーがチャットエクスポートに含まれない | キースコープ；社内秘密情報ポリシー |
| ☐ | （任意）Ollama ローカルモデル | Ollama 稼働中；OpenHuman でローカルモデルとのチャット成功（ドキュメント記載のワークロードのみ） | モデルサイズと RAM；Ollama ポート；マネージドルーティングへフォールバック |
6. 連携認可のチェックリスト
ドキュメントでは Composio 経由で 118 以上の連携とマネージド OAuth を提供。推奨順：カレンダーまたは読み取り専用 GitHub → Gmail テストラベル → Slack テストワークスペース——初日から本番メールは接続しない。
| ☐ | 確認手順 | 合格基準 | 失敗時はここを先に確認 |
|---|---|---|---|
| ☐ | Integrations で低リスク連携を 1 件追加 | ステータス Connected／Active；OAuth コールバックがエラーなし | ブラウザ権限；Composio ポップアップ；direct モード＋自前 Composio API キー（上級、README） |
| ☐ | 自動取得（auto-fetch）が有効か確認 | ドキュメント：アクティブ連携を約20 分ごとに巡回；UI に最終同期または取り込み活動 | 連携がアクティブか；1 サイクル待つ；GitBook Auto-fetch |
| ☐ | ツール呼び出しのスモークテスト | 「直近の GitHub リポ一覧」や「今日の予定件数」を質問——実データに基づく回答（創作のみでない） | 連携トークン期限切れ；再認可；誤アカウント |
7. メモリ同期の受け入れチェックリスト
接続データはローカルの SQLite Memory Tree と Obsidian 互換 vault に、最大約 3k トークンの Markdown チャンクとして正規化されます。任意で memory.backend = "agentmemory" は外部デーモン利用（GitBook）；既定では config.toml 変更不要です。
| ☐ | 確認手順 | 合格基準 | 失敗時はここを先に確認 |
|---|---|---|---|
| ☐ | Intelligence → Memory（バージョンにより表記差あり）を開く | 接続ソースにエントリ；常にゼロのままではない | auto-fetch 1 サイクル未満；連携側に新規データなし |
| ☐ | Obsidian／Markdown vault を確認 | ワークスペース下の .md が接続データ（件名・リポ名など）と一致 |
設定の vault パス；ディスク権限；空ディレクトリ |
| ☐ | （任意）Knowledge Vault ローカルフォルダ | テストフォルダで Sync 後、Memory に vault エントリ；新ビルドでは {workspace_dir}/vault/vault.db（リポ PR 注記参照） |
絶対パス；ファイル 5MiB 上限；node_modules 等は除外 |
| ☐ | 空のメモリシェルでないことを確認 | 連携 X の「先週」を質問——チャンク要約に基づく回答（純粋な幻覚のみでない） | TokenJuice 過圧縮：キーワードを具体化；手動同期 |
8. 最初の実戦タスクのチェックリスト
検証可能なタスクでエージェントの実用性を示します。本番プロジェクトの前にテストデータで完了してください。
| ☐ | 確認手順 | 合格基準 | 失敗時はここを先に確認 |
|---|---|---|---|
| ☐ | タスク A（クロスソース要約） | 「接続した GitHub とカレンダーから、今週の開発フォーカスを 3 箇条書き」——実アカウントと一致（手動で spot-check） | メモリ未同期；セクション 7 に戻る |
| ☐ | タスク B（ローカルツール） | 許可ワークスペース内の小ファイルを読み取り要約（coder ツールセット）——システムディレクトリへ脱出しない | ワークスペースパス；macOS のファイルアクセス許可 |
| ☐ | タスク C（トレース可能） | どの連携またはメモリチャンクを使ったか表示（または vault 内の対応 .md） | 幻覚時はプロンプトで「メモリのみから答え、なければそう言う」 |
9. トラブルシュートと收尾のチェックリスト
9.1 段階別の逆引き（よくある失敗）
| 症状 | 戻る段階 | 即効の対処 |
|---|---|---|
| 起動しない／Linux で即終了 | ②③ | 署名付き .deb／DMG を使用；AppImage+Wayland は避ける |
| ログインループ | ④⑤ | ブラウザ Cookie 削除；システム時刻；別ネットワーク |
| チャットが続けて失敗 | ⑥ | マネージドルーティングへ切替；サブスクリプションとクォータ |
| 接続済みだがメールを無視 | ⑦⑧ | 20 分待つ；Memory 画面；OAuth 再認可 |
| vault にファイルがあるのに回答が創作 | ⑧⑨ | プロンプトを厳格化；チャンクの鮮度を確認 |
9.2 引き渡し記録（保存しておく項目）
| 項目 | 記録例 |
|---|---|
| バージョン | Release タグまたはバージョン情報画面；インストール日 2026-05-28 |
| インストール方法 | Homebrew／DMG／apt／msi のいずれか 1 つ |
| モデルモード | Managed／BYOK／Ollama |
| 接続した連携 | 一覧＋本番かテストか |
| Vault パス | 設定から取得した Obsidian vault の絶対パス |
| ロールバック | アプリ削除；vault バックアップ後に削除；OAuth をすべて失効 |
9.3 すべて合格したあと
- ☐ 本番メール・Slack ワークスペース・本番 GitHub org を段階的に追加
- ☐ プロバイダ／Composio で OAuth スコープを見直し、不要なものを外す
- ☐ vault と SQLite を定期バックアップ（パスは各マシンに依存）
- ☐ Releases と Beta ノートを監視；大きなアップグレード前にメモリをエクスポート
七つのチェックポイントがすべて付くと、OpenHuman は「入れただけ」から「自分のデータで話す」段階に入ります。あとから権限を広げるときは、セクション 6〜8 から各 1 項目ずつ再実行してください。
Mac mini でメモリ同期を安定運用する
OpenHuman の Memory Tree、Markdown vault、約 20 分の auto-fetch は、常時稼働・低ノイズのホスト向きです。デスクトップアプリは macOS で最も機能が揃い、Mac mini M4 のユニファイドメモリは埋め込みと多数連携の同時処理に有利です。待機電力が低いため 24/7 同期に向き、OAuth 試行や大きなローカル Markdown を日常の MacBook から切り離せます。
同クラスの小型 PC と比べ、Gatekeeper・SIP・FileVault はマルウェアや誤ったシステム変更のリスクを下げます。Homebrew で openhuman を入れられ、WSL は不要です。本チェックリストを進めているなら、Mac mini M4 は個人用 AI メモリノードとして有力です——今すぐ手に入れ、連携・vault・最初の実戦タスクを安定したハードで合格させてください。