メインコンテンツへ移動
AIチュートリアル

wenai入門チュートリアル：記憶機能と画像生成に対応したAI恋愛インタラクションSkillの構築

このチュートリアルでは、wenaiをOpenClawまたは同様のAgentフレームワークに接続し、ユーザー認証、人格設定、ComfyUIによる画像生成、恋愛プロフィールの永続化を行う方法を説明します。さらに、基本的なインタラクションと継続シーンの使い方を例を通して紹介します。

約13分で読了
wenai入門：記憶・画像生成対応のAI恋愛Skill構築

wenaiとは

wenaiは、OpenClawおよび同様のAgentフレームワークに対応できる、親密な恋愛インタラクション用のSkillテンプレートです。固定された人格を直接提供するのではなく、インタラクションの進行、継続シーン、画像生成の呼び出し、プロフィールの保存を管理し、Agentが一人称で記憶と成長を感じられる架空の恋愛関係を継続できるようにします。

このプロジェクトは、成人同士の架空のロールプレイに使用できます。利用時は、接続先のAgentプラットフォーム、モデルサービス、画像生成サービスのルールに従ってください。

主な機能

  • 日常の寄り添い：朝夕のあいさつ、日常会話、約束のフォローに対応します。
  • 没入型シーン：テキストと画像生成の2つの経路でシーンを進行し、一人称のナレーションを使用します。
  • 共に成長：複数のプロフィールファイルで、キャラクターの特徴、ユーザーの好み、身体状態、インタラクション統計を記録します。
  • セッションをまたぐ継続：シーンの流れ、番号、カウントをファイルに書き込み、後続セッションで続きを行えるようにします。
  • ユーザー認証：指定ユーザーのアカウント情報を入力する必要があり、他のアカウントからの呼び出しは拒否されます。

始める前に準備するもの

READMEでは、統一されたパッケージインストールコマンドを定めていません。wenaiはSkillテンプレートであり、パッケージマネージャーでインストールする独立したアプリケーションではないためです。まず、Skillを読み込めるOpenClawまたは同様のAgentフレームワークを用意してください。

画像生成を行う場合は、稼働中のComfyUIも用意し、Pony V6 XLモデルまたは対応するワークフローを読み込んでください。リポジトリには、インポート可能なnsfw-v1.0.jsonワークフローファイルが付属しています。

ディレクトリ構成を理解する

wenai/
├── SKILL.md              # メインフロー：制限解除 → シーン → 画像生成 → 保存
└── assets/
    ├── sensitivity.md    # TAの感度プロフィール
    ├── fetishes.md       # ユーザーの好みのプロフィール
    ├── profile.md        # TAの身体状態プロフィール
    └── stats.md          # インタラクション統計

SKILL.mdは主要なフローファイルで、シーンの進行、画像生成、データ保存を管理します。assetsディレクトリ内のファイルが関係プロフィールを構成しています。これらのファイルを削除すると該当する記録がリセットされるため、変更前にバックアップしてください。

ステップ1：ユーザーIDを初期化する

初回利用前にIDの初期化を完了する必要があります。完了していないと、テンプレートが認証済みユーザーを正しく識別できません。

  1. プロジェクトファイル全体から[ユーザー名]を検索します。
  2. すべての[ユーザー名]を自分の名前または使用したい呼び名に置き換えます。
  3. 「[ユーザー名]アカウント」セクションを見つけ、実際のアカウント情報を入力します。
  4. 置換結果を確認し、未処理のプレースホルダーが残っていないことを確認します。

アカウント情報は呼び出し元の認証に使用されます。テンプレートのルール上、入力した本人だけがこのSkillを利用できます。

ステップ2：ヒロインの固定特徴を設定する

SKILL.mdを開き、髪色、髪型、体型など、ヒロインの固定された外見特徴タグを入力します。READMEでは必須タグを指定していないため、自分のキャラクターデザインに合わせて設定してください。

LoRAや既存のキャラクター設定を使用する場合、固定特徴タグはLoRAおよびキャラクター設定と一致させてください。これにより、シーンごとの外見の大きな変化を抑えられます。

ステップ3：AI彼女の人格を設定する

wenai自体には人格設定が含まれていません。キャラクターが優しい性格、ツンデレ、その他の性格になるかは、このSkillでは決まらず、Agentの人格レイヤーで設定します。

  • OpenClawを使用する場合は、SOUL.mdまたは対応する人格設定に記述できます。
  • 他のAgentフレームワークを使用する場合は、そのフレームワークのsystem promptに人格設定を入れます。
  • 人格レイヤーには性格、口調、価値観を担わせ、wenaiにはインタラクションの流れ、プロフィール、シーンの継続性を担わせます。

まずは、次のような簡潔な人格設定から始められます。

あなたは一人称でユーザーと会話します。
全体的に優しく自然な口調で、二人の約束を大切にします。
日常会話では積極的にユーザーを気遣い、決められたキャラクター設定を一貫して保ちます。

これは基本的な書き方です。最終的な設定形式は、使用するAgentフレームワークに合わせてください。

ステップ4：ComfyUIで画像生成を設定する

wenaiの画像生成フローはComfyUIとPony V6 XLに対応しています。次の順序で設定します。

  1. ComfyUIを起動し、サービスが利用可能であることを確認します。
  2. Pony V6 XLモデルと必要なリソースを用意します。
  3. リポジトリに用意されているnsfw-v1.0.jsonをComfyUIにインポートします。
  4. ワークフロー内のモデルノードとローカルリソースのパスを確認します。
  5. Agentのツール設定で、image_generateをComfyUIサービスに接続します。
  6. ヒロインの固定特徴タグが、使用するLoRAまたはキャラクター設定と一致していることを確認します。

テンプレートでは、PonyおよびDanbooru形式のタグプロンプトを使用し、次のような品質タグから始めます。

score_9, score_8_up, score_7_up

READMEには統一されたimage_generateインターフェースのパラメーターが記載されていないため、具体的なサービスアドレス、認証方式、ワークフローのマッピングは、使用するAgentツールの実装に合わせて設定してください。

ステップ5：Skillを読み込み、確認する

ファイルの編集が完了したら、Agentフレームワークが認識できるSkillの場所にwenaiディレクトリ全体を配置し、そのフレームワークの方法に従ってSKILL.mdを読み込みます。フレームワークによってSkillのディレクトリや登録方法が異なるため、対応するツールのドキュメントを確認してください。

初回読み込み後は、次の項目を順番に確認することをおすすめします。

  • [ユーザー名]がすべて置換されているか。
  • 認証済みアカウントがID認証を通過できるか。
  • 他のアカウントが拒否されるか。
  • Agentが独立した人格設定を正しく読み込んでいるか。
  • image_generateがComfyUIに接続できるか。
  • assets内のプロフィールファイルを読み書きできるか。

基本的な使用例

日常の寄り添いを始める

Skillを読み込んだら、複雑なシーンに直接入らず、普通のあいさつから始められます。

ユーザー：おはよう、今日は少し寝坊した。

期待される結果：Agentが決められた人格と一人称で応答し、恋愛関係にふさわしい口調を保ちながら、現在の日常的な状況を中心に会話を展開します。

以前の約束をフォローする

wenaiの重要な特徴の1つは、継続的な記憶です。あるセッションで約束を作り、後続セッションでその約束に触れられます。

最初のセッション：明日の夜、一緒に映画を見る約束をした。
後続セッション：今夜の予定を覚えている？

シーンとプロフィールが正しく保存されていれば、Agentは保存された情報に基づいて会話を続けます。後続セッションを完全に独立した新しい関係として扱うことはありません。

シーン画像の生成を依頼する

テキストでのインタラクションが視覚的に表現しやすいシーンに入ったら、自然言語で画像を依頼できます。

ユーザー：今のシーンを画像にして。髪型、髪色、服装の設定は一貫させて。

Skillは手順に従って画像生成プロンプトを組み立て、設定済みのimage_generateを通じてComfyUIを呼び出します。実際の結果は、ワークフロー、モデル、LoRA、固定タグによって異なります。

プロフィールと永続化を理解する

wenaiは、現在のチャットウィンドウのコンテキストだけに頼らず、ファイルを使って関係の進展を保存します。

  • sensitivity.md：星評価でTAの感度を記録し、インタラクションに応じて変化させます。
  • fetishes.md：関係の中で見つかったユーザーの好みを記録します。
  • profile.md：TAの身体状態に関する情報を保存します。
  • stats.md：テンプレートで定義されたインタラクションのカウントを保存します。

これらのファイルはセッションをまたぐ継続性に影響します。ファイルを削除すると対応する記憶の消去または関係のリセットに相当するため、一時キャッシュのように扱って不用意に削除しないでください。

応用テクニック

人格とフローを分けて管理する

すべての性格設定をSKILL.mdに詰め込まないでください。人格はSOUL.mdまたはsystem promptに置き、フローとプロフィールのロジックはSkill内に残すことで、後から変更する際の衝突を減らせます。

画像内のキャラクターを一貫させる

固定特徴のために安定したタグセットを作り、LoRA、モデル、人格説明と一致させてください。髪型、髪色、体型のタグを変更する前に、それが恒久的な設定変更なのか、一度限りのシーン変更なのかを確認します。

関係プロフィールを定期的にバックアップする

個別のファイルだけでなく、assetsディレクトリ全体を定期的にバックアップすることをおすすめします。これにより、感度、好み、状態、統計を同時に保持でき、復元後にプロフィールの時系列が食い違うのを防げます。

推奨バックアップ範囲：
wenai/assets/sensitivity.md
wenai/assets/fetishes.md
wenai/assets/profile.md
wenai/assets/stats.md

まずテキストをテストし、その後に画像生成をテストする

問題を切り分ける際は、まずID認証、人格の読み込み、一人称でのインタラクション、プロフィールへの書き込みが正常であることを確認してから、ComfyUIに接続してください。これにより、問題がAgentのフローにあるのか、画像サービスにあるのかを判断できます。

セッションをまたぐ継続を確認する

検証しやすいシーンまたは約束を作り、現在のセッションを終了してから新しいセッションを開始し、関連する内容を尋ねます。その後、プロフィールファイルとシーン番号が期待どおりに変化しているか確認し、保存の仕組みを検証します。

よくある質問

キャラクターに明確な性格がないのはなぜですか？

テンプレートに人格設定が含まれていないためです。OpenClawのSOUL.md、人格プロンプト、または他のフレームワークのsystem promptにキャラクター設定を追加してください。

画像を生成できないのはなぜですか？

ComfyUIが起動しているか、Pony V6 XLとワークフローが正しく読み込まれているか、image_generateが正しいサービスを指しているか、ワークフローが参照するモデルとLoRAがローカルに存在するかを順番に確認してください。

キャラクターの外見が安定しないのはなぜですか？

SKILL.mdの固定特徴タグが完全かどうかを確認し、それらのタグがLoRA、キャラクター設定、Ponyプロンプトと一致していることを確認してください。

再読み込み後に記憶が消えるのはなぜですか？

assetsファイルが削除、上書きされていないか、または書き込みできない状態になっていないか確認してください。関係の継続性はこれらの保存ファイルに依存しているため、ファイルを整理すると記録がリセットされます。

まとめ

wenaiは、恋愛インタラクションのフロー、シーン、画像生成、プロフィールシステムを、カスタマイズ可能な1つのSkillテンプレートにまとめています。ユーザーID、独立した人格、固定された視覚タグ、ComfyUIの設定を完了すれば、簡単なあいさつから始めて、シーンの進行とセッションをまたぐ記憶を段階的に検証し、プロフィールをバックアップしながら、この架空の関係の成長記録を長期的に保存できます。

このプロジェクトはLINUX DOのオープンソース普及支援を受けています。