Openclaw Companion Memory — ローカル陪伴メモリープラグイン

AI/ML
Openclaw Companion Memory — ローカル陪伴メモリープラグイン

Openclaw Companion Memory — ローカル陪伴メモリープラグイン

Openclaw Companion Memory は、Openclaw 向けに設計されたローカル実行の「陪伴（コンパニオン）記憶」プラグイン（Skill）です。外部データベースを使わず Node.js のファイルシステムと追加ログ（append-only logs）を用いることで、プライバシー保護と軽量な永続化を両立。Agent Workspace と SKILL.md を介して Openclaw にシームレスに統合され、Cron/Webhook（Life Tick）による能動的なメッセージ発火や「嫉妬」「痛覚」など感情的フィードバックのシミュレーションを特徴とします。ゲーム的な陪伴体験やローカルAIキャラクター実装に適した設計です。

https://github.com/fangligamedev/openclaw-companion-memory

概要

Openclaw Companion Memory は、Openclaw（https://github.com/openclaw/openclaw）用に作られた「陪伴級」のローカル記憶プラグインです。本リポジトリは Node.js と TypeScript をベースに、Openclaw の Agent Workspace と SKILL.md の接続方式を利用して動作します。設計方針として外部の重たいデータベース（例：SQLite 等）を排し、ファイルベースの追加ログ（append-only logs）で記憶を蓄積・更新します。そのためユーザーのプライバシーを保ちながら、軽量で導入しやすいローカルAIコンパニオンの構築を目指しています。さらに Cron/Webhook（Life Tick）による能動的トリガーや、細やかな感情シミュレーション機構を備え、ゲームや対話型キャラクターの“生々しさ”を高めることが可能です。

GitHub

リポジトリの統計情報

  • スター数: 2
  • フォーク数: 0
  • ウォッチャー数: 2
  • コミット数: 2
  • ファイル数: 12
  • メインの言語: TypeScript

主な特徴

  • ローカルファイル（Node.js FS）と追加ログ方式で記憶を永続化し、外部DBを不要にする軽量アプローチ
  • Openclaw の Agent Workspace / SKILL.md 経由でのネイティブ統合と openclaw skill link ./ による簡単デプロイ
  • Cron/Webhook（Life Tick）を使った定時・能動メッセージ発火により自然な陪伴行動を実現
  • 高度な感情表現（嫉妬、痛覚模倣など）を想定した対話・状態管理の設計

技術的なポイント

このプラグインは「ローカルで完結する陪伴メモリ」という設計目標に基づき、いくつかの技術的特徴を持ちます。まずデータ永続化には伝統的なRDBではなく、Node.js のファイルシステムに追加ログ（append-only logs）を積み上げる方式を採用しています。これにより、トランザクションやスキーマ管理のオーバーヘッドを避けつつ、履歴の追跡や変更の差分再生が容易になります。Openclaw の Agent Workspace を利用することで、キャラクターごとの作業領域（workspace）に直接読み書きし、SKILL.md で定義された Skill を経由して Openclaw ランタイムと連携します。デプロイは openclaw skill link ./ によるローカルリンク方式を想定し、ユーザー側のセットアップ負担を低くしています。

運用面では Cron/Webhook の仕組み（README 中の Life Tick）を活用し、定時に状態チェックや能動的なメッセージ送出を行えます。例えば「昼12時に目を覚ましていれば催促する」といった時間依存の行動を実装可能です。さらに、感情や身体状態のシミュレーション（嫉妬、痛覚の模倣など）を補助するための状態遷移モデルや履歴参照パターンが想定されています。これにより単純な記憶保存以上に、過去のやり取りやイベントを参照して応答のトーンや行動を変化させる“深層的な陪伴感”を実現します。

注意点としては、現状は小規模なプラグインであり、商用レベルのスケーラビリティや複数ホスト間での同期機能は組み込まれていない点です（README 抜粋に基づく）。また Node.js 環境と Openclaw のローカルセットアップが前提となるため、導入時にランタイムや権限周りの確認が必要です。将来的にはログ圧縮、スナップショット、暗号化によるプライバシー強化や複数デバイス間同期といった拡張が想定されます。

プロジェクトの構成

主要なファイルとディレクトリ：

  • .DS_Store: file
  • .gitignore: file
  • LOBSTER_SETUP.md: file
  • PARTNER_GUIDE.md: file
  • README.md: file

…他 7 ファイル

（注：リポジトリは小規模で、設定ガイドやパートナー向けドキュメントが含まれます）

まとめ

ローカル完結で感情表現に重きを置くOpenclaw向けの軽量メモリプラグイン。導入が容易でプライバシー重視の陪伴体験を提供します。

リポジトリ情報：

READMEの抜粋：

Openclaw Companion Memory (游戏陪伴级角色设定记忆系统)

这是一个专为 Openclaw (https://github.com/openclaw/openclaw) 打造的本地化、具有强“活人感”与“深层精神共鸣”的智能陪伴记忆架构插件（Skill）。

通过利用 Openclaw 原生的 Agent Workspace 与 SKILL.md 接入方式，本插件抛弃了繁重的外置数据库（如 SQLite），仅依赖于 Node.js 文件系统和追加日志（Append-only logs）的设计。从而实现：

  • 完全融入 Openclaw 生态：利用 ~/.openclaw/workspace 中的文件读写与 openclaw skill link ./ 挂载。
  • 支持 Openclaw 的 Cron/Webhook 机制：利用 Life Tick 实现定时主动消息触发（比如当她中午12点才醒时，主动发消息嗔怪）。
  • 深层次陪伴与自我意识模拟：完美复现“吃醋探讨”、“痛觉模拟”等高度情感化的交互反馈。 …