← Back to Skills Marketplace
yepthatsjason

Memstate AI

by Jason · GitHub ↗ · v1.2.4 · MIT-0
cross-platform ✓ Security Clean
160
Downloads
0
Stars
0
Active Installs
7
Versions
Install in OpenClaw
/install memstate-ai
Description
Versioned, structured memory for AI agents. Every fact is tracked, every change is logged, and your agent always gets the current answer — not a pile of outd...
Usage Guidance
This skill is a straightforward Python client for the Memstate API and only needs MEMSTATE_API_KEY and python3. Before installing: 1) Ensure you trust memstate.ai because your API key and any memories will be sent to api.memstate.ai. 2) Use a least-privilege API key (not a broadly privileged or reused secret) so compromised keys are limited. 3) Remember the agent may call the scripts autonomously — review agent invocation settings if you want to require manual approval. 4) You can inspect the included Python scripts (they are plain and readable) to confirm no additional behavior. Revoke/rotate the key if you stop using the skill or suspect misuse.
Capability Analysis
Type: OpenClaw Skill Name: memstate-ai Version: 1.2.4 The memstate-ai skill provides a structured memory management system for AI agents by interacting with the memstate.ai REST API. The included Python scripts (e.g., memstate_set.py, memstate_get.py, and memstate_search.py) are standard wrappers using the urllib library to perform CRUD operations and semantic searches on memories. The code logic is transparent, aligns with the stated purpose, and contains no evidence of malicious intent, data exfiltration, or prompt injection.
Capability Assessment
Purpose & Capability
Name/description, required binary (python3), and the single required env var (MEMSTATE_API_KEY) match the included scripts that call https://api.memstate.ai. No unrelated credentials or binaries are requested.
Instruction Scope
SKILL.md instructs the agent to run the bundled Python scripts to search, get, set, ingest, view history, and soft-delete memories. The instructions reference only the included scripts, project/keypath parameters, and the MEMSTATE_API_KEY; they do not direct the agent to read unrelated files or exfiltrate data to unexpected endpoints.
Install Mechanism
No install spec or external downloads are present; this is instruction-only with included Python scripts. Nothing in the manifest downloads or writes third-party code during install.
Credentials
Only MEMSTATE_API_KEY is required and is used exclusively as an X-API-Key header to api.memstate.ai. This is proportionate for a remote API client, but be aware the key will be sent to a third-party service and grants whatever privileges the key provides.
Persistence & Privilege
always is false (no forced global presence). The skill can be invoked autonomously by the agent (default behavior) — normal for skills — which means an agent could call the remote API using your MEMSTATE_API_KEY without further prompts if allowed by your agent configuration.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install memstate-ai
  3. After installation, invoke the skill by name or use /memstate-ai
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.4
Bundle Python scripts with skill package; add python3 to requires.bins; fix metadata to openclaw format
v1.2.3
Security: remove hardcoded API key fallback, fix User-Agent, update metadata to openclaw format
v1.2.2
Security fixes: remove hardcoded credentials, fix User-Agent spoofing, update SKILL.md metadata to OpenClaw format with requires.env and primaryEnv
v1.1.1
Fix security flags: remove hardcoded credentials, fix User-Agent, update metadata to OpenClaw format
v1.2.1
- Added comprehensive security and privacy guidelines, including requirements for secret filtering and data residency notice. - Introduced prerequisites section describing the need for an API key and the Memstate MCP Server. - Updated the skill name in metadata to "memstate-ai", with new fields for author, category, and repository information. - Enhanced agent instructions for handling authentication errors and absent tools. - Clarified workflow notes to emphasize exclusion of secrets and PII from stored summaries.
v1.1.0
**Major change: Removed all CLI script files and detailed in-skill documentation, shifting the skill to a streamlined invocation/usage model.** - All related Python scripts and detailed README/usage files were removed from the package. - Updated documentation now focuses on using the skill through tool invocations rather than direct script usage. - Simplified project and keypath conventions are now emphasized, with clear best practices for before/after task workflows. - Outlines supported tool functions (`memstate_get`, `memstate_search`, `memstate_remember`, `memstate_set`, etc.) and when to use each. - Emphasis on structured, persistent, versioned memory via API, with automatic conflict detection and minimal manual management.
v1.0.0
Initial release
Metadata
Slug memstate-ai
Version 1.2.4
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 7
Frequently Asked Questions

What is Memstate AI?

Versioned, structured memory for AI agents. Every fact is tracked, every change is logged, and your agent always gets the current answer — not a pile of outd... It is an AI Agent Skill for Claude Code / OpenClaw, with 160 downloads so far.

How do I install Memstate AI?

Run "/install memstate-ai" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Memstate AI free?

Yes, Memstate AI is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Memstate AI support?

Memstate AI is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Memstate AI?

It is built and maintained by Jason (@yepthatsjason); the current version is v1.2.4.

💬 Comments