← Back to Skills Marketplace
2908
Downloads
9
Stars
4
Active Installs
6
Versions
Install in OpenClaw
/install vta-memory
Description
Reward and motivation system for AI agents. Dopamine-like wanting, not just doing. Part of the AI Brain series.
Usage Guidance
This skill appears internally consistent and runs entirely on local files, but review these before installing: 1) It reads conversation transcripts (~/.openclaw/agents/<id>/sessions) and writes summaries and logs into ~/.openclaw/workspace/memory — sensitive conversation content will be processed and stored locally. 2) It generates VTA_STATE.md (first‑person motivation text) which OpenClaw auto-injects into sessions and will change agent behavior; test it in a non-production agent first. 3) install.sh can register cron agent-turns via the openclaw CLI to run decay/encoding periodically — run install.sh without --with-cron initially to inspect behavior, and only enable cron after confirming you accept automated runs. 4) Inspect workspace sync/backup settings (if your workspace is backed up to cloud or shared) because processed transcripts and logs are stored in cleartext. If you want to proceed: run in a sandbox/test agent, audit the generated files (reward-state.json, brain-events.jsonl, VTA_STATE.md) and confirm no network calls are being made from your environment.
Capability Analysis
Type: OpenClaw Skill
Name: vta-memory
Version: 1.2.0
The skill bundle contains several vulnerabilities that could be exploited by a malicious actor. The `generate-dashboard.sh` script is vulnerable to Cross-Site Scripting (XSS) as it directly injects user-controlled data (e.g., agent name from `IDENTITY.md`, memory summaries, emotion triggers, reward sources from JSON state files) into the generated HTML without proper escaping. Additionally, the `sync-motivation.sh` script creates `VTA_STATE.md` by directly embedding user-controlled content (from `seeking`, `anticipating`, and `recentRewards.source` fields in `reward-state.json`) which, when auto-injected into agent sessions, presents a prompt injection vulnerability. Finally, the `prompts/encode-rewards.md` instructs the agent to construct and execute shell commands with arguments derived from conversation analysis, posing a risk of arbitrary command execution if the agent can be tricked into generating malicious arguments via prompt injection. These are vulnerabilities, not evidence of intentional malicious behavior by the skill itself.
Capability Assessment
Purpose & Capability
The name/description (VTA reward/motivation) match what the repository implements: local state file, reward logging, seeking/anticipation, scheduled decay, and a dashboard. Required binaries (jq, awk, bc) are used throughout the scripts and are appropriate.
Instruction Scope
Instructions and scripts read session transcripts (~/.openclaw/agents/$AGENT_ID/sessions) to extract reward signals, write multiple JSON/MD files into ~/.openclaw/workspace/memory, and generate VTA_STATE.md which OpenClaw auto-injects into future sessions. This is coherent with purpose but has privacy/behavior implications: it ingests conversation history and summarizes it into content that influences agent behavior (first‑person narrative).
Install Mechanism
There is no remote install that downloads arbitrary code; included install.sh and local scripts are executed. install.sh optionally uses the local 'openclaw' CLI to register cron jobs; if openclaw is absent it prints the commands for manual setup. No external download URLs or extractable archives are present.
Credentials
No environment variables or external credentials are requested. The workspace and agent transcript paths accessed are proportional to the stated goal (detecting rewards from conversation).
Persistence & Privilege
The skill writes VTA_STATE.md into the workspace which OpenClaw will auto-inject into sessions — deliberately influencing agent outputs. Cron jobs for periodic processing are optional (install.sh only registers them when run with --with-cron). The skill does not declare always:true; autonomous agent invocation is possible via cron or agent-turns but not inherently granted by the skill itself.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install vta-memory - After installation, invoke the skill by name or use
/vta-memory - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.0
feat: add event logging for brain analytics
v1.2.3
Fix: Dashboard generator was using wrong variable for amygdala data (VTA_FILE defined twice, AMYGDALA_FILE was missing)
v1.2.1
- Added brain dashboard generation script (generate-dashboard.sh) for a unified view of all installed brain skills.
- Updated documentation to include dashboard usage and features.
- Dashboard auto-detects other brain modules and reads avatar/name from IDENTITY.md.
- Scripts and install flow now prompt users about the dashboard after installation.
- Minor improvements to install and sync scripts to regenerate and update the dashboard as needed.
v1.1.0
Version 1.1.0 adds new capabilities for anticipation resolution, reward preprocessing, and internal state management:
- Added resolve-anticipation.sh to mark anticipation events as fulfilled.
- Added update-watermark.sh for updating internal processing watermarks.
- Added preprocess-rewards.sh to extract reward signals from transcripts.
- Included prompts/encode-rewards.md for reward encoding guidance.
- Updated documentation to reflect new scripts and features.
v1.0.0
V1.0.0: Full reward/motivation system - drive, rewards, seeking, anticipation, auto-injection
v0.1.0
Initial placeholder - reward/motivation system under development
Metadata
Frequently Asked Questions
What is Vta Memory?
Reward and motivation system for AI agents. Dopamine-like wanting, not just doing. Part of the AI Brain series. It is an AI Agent Skill for Claude Code / OpenClaw, with 2908 downloads so far.
How do I install Vta Memory?
Run "/install vta-memory" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Vta Memory free?
Yes, Vta Memory is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Vta Memory support?
Vta Memory is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Vta Memory?
It is built and maintained by ImpKind (@impkind); the current version is v1.2.0.
More Skills