基本コンセプト
クイックスタートに進む前に、Desktop Homunculus 全体で登場する 3 つの基本概念を紹介します。
Persona
Persona は、デスクトップ上に住むキャラクターです。各 Persona は以下の要素で構成されます:
- アイデンティティ — キャラクターを定義する名前、年齢、性別、性格の説明、プロフィールテキスト
- VRM モデル — 他のアプリケーションの上に浮かぶ透明ウィンドウでレンダリングされる 3D アバター。組み込みモデルを使用するか、自分の VRM ファイルを使用できます
- 永続設定 — セッション間で保存される外見の調整(ボーンスケール)や各種設定
複数の Persona を作成でき、それぞれ独自の外見と性格を持たせることができます。Persona の Auto-Spawn を有効にすると、アプリ起動時に自動的にキャラクターが表示されます。
Persona はシステムトレイからアクセスできる Persona Management ダッシュボードで管理します。
MOD
MOD は、Desktop Homunculus に機能を追加するパッケージです。右クリックメニュー、設定パネル、既定のアセット(キャラクターモデル・アニメーション・効果音)はエンジンに組み込まれています。Persona 管理は、インストーラーに同梱される公式 MOD によって提供されます。
公式 MOD は @hmcs/ プレフィックスを使用します:
| MOD | 機能 |
|---|---|
@hmcs/persona | Persona 管理とデフォルトのキャラクター動作 |
テキスト読み上げ(@hmcs/voicevox)や音声認識(@hmcs/stt)などの追加 MOD は、hmcs CLI でいつでもインストールできます。AI 連携については、AI 連携を参照してください(外部で OpenClaw を起動する必要があります)。
Asset
Asset は、エンジンに組み込まれているか MOD にバンドルされたファイルです — VRM モデル、アニメーション(VRMA)、効果音、画像、HTML UI など。Asset は mod-name:asset-id の形式の ID で参照します。
例:
vrm:elmer— 組み込みの VRM キャラクターモデルvrma:idle-maid— デフォルトの待機アニメーションse:open— UI オープン時の効果音
これらのデフォルトの Asset はエンジンに組み込まれており、Persona システムをすぐに動かせます。
次のステップ
準備はできましたか?クイックスタートガイドに進んで、最初の Persona を作成しましょう。