# Send Hypabase Memory to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "hypabase-memory",
    "name": "Hypabase Memory",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/harshidwasekar/hypabase-memory",
    "canonicalUrl": "https://clawhub.ai/harshidwasekar/hypabase-memory",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/hypabase-memory",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=hypabase-memory",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "claw.json"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "hypabase-memory",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-01T21:20:27.568Z",
      "expiresAt": "2026-05-08T21:20:27.568Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=hypabase-memory",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=hypabase-memory",
        "contentDisposition": "attachment; filename=\"hypabase-memory-0.2.4.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "hypabase-memory"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/hypabase-memory"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/hypabase-memory",
    "downloadUrl": "https://openagent3.xyz/downloads/hypabase-memory",
    "agentUrl": "https://openagent3.xyz/skills/hypabase-memory/agent",
    "manifestUrl": "https://openagent3.xyz/skills/hypabase-memory/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/hypabase-memory/agent.md"
  }
}
```
## Documentation

### Hypabase Memory

Persistent memory for agents. Stores preferences, decisions, facts, and events as a connected knowledge graph. Recalled by who, what, when, or why.

### Setup

Add the MCP server to your OpenClaw config (~/.openclaw/openclaw.json):

{
  "mcpServers": {
    "hypabase-memory": {
      "command": "uvx",
      "args": ["--from", "hypabase", "hypabase-memory"],
      "env": { "HYPABASE_DB_PATH": "hypabase.db" }
    }
  }
}

uvx handles all Python dependencies automatically. Requires uv.

### Quick start

Store a memory — one verb, roles for the participants:

remember(penman='(prefers :subject Alice :object Python :memory_type semantic)')

Recall it:

recall(entity="Alice")                              # everything about Alice
recall(entity="Alice", action="assign", role="subject")  # what Alice assigned
recall(entity=["Alice", "Bob"])                     # memories involving both
recall(mood="planned")                              # all plans

### When to Remember

Store a memory when the user:

Makes a decision or states a preference
Shares a fact about themselves, their team, or a project
Assigns a task or delegates work
Describes an event, meeting, or outcome
Explains a procedure or workflow

### PENMAN Notation

Every memory is a verb with participants in role slots:

(verb :role "entity" :role "entity" ...)

Examples:

(prefers :subject Alice :object Python :memory_type semantic)

(assigned :subject Alice :object "billing task" :recipient Bob
 :instrument Jira :locus Monday :tense past :memory_type episodic)

(has :subject "quick sort" :attribute "time complexity"
 :value "O(n log n)" :memory_type semantic)

Multiple atoms in a single call:

(deployed :subject Alice :object API :locus Monday :tense past)
(reviewed :subject Bob :object API :locus Tuesday :tense past)

One action per memory. When a sentence contains multiple actions, decompose into separate atoms. Shared entities link them in the graph.

"Alice told Bob to migrate the database":

(told :subject Alice :recipient Bob :object "database migration" :tense past)
(migrate :subject Bob :object database :mood planned)

Any role slot can hold a nested atom:

(believes :subject Alice :object (is :subject deadline :value Friday))

### Entity Naming

Same string after lowercasing = same entity. Different strings = different entities until consolidate() merges them.

Pick one canonical name per entity and reuse it.
Use full descriptive names: "machine learning" not "ML", "JavaScript" not "JS".
Call consolidate() periodically to merge similar names via semantic similarity.

### remember(penman, source?, confidence?)

Store memories as PENMAN atoms.

penman (required): One or more PENMAN atoms.
source (optional): Provenance source. Default: "memory".
confidence (optional): 0.0–1.0. Default: 1.0.

### recall(entity?, action?, role?, memory_type?, mood?, negated?, since?, before?, limit?, min_strength?)

Query memories. At least one parameter required.

entity: Name or list of names.
action: Filter by verb.
role: Filter by role (subject/object/instrument/recipient/source/locus/attribute/value).
memory_type: episodic / semantic / procedural.
mood: actual / planned / uncertain / normative / conditional.
negated: true = only negated, false = only positive.
since / before: ISO date strings.
limit: Max results (default: 10).
min_strength: Minimum memory strength threshold.

### consolidate(entity?)

Merge similar entities and compress repeated memories.

### forget(older_than_days?, min_strength?, entity?)

Expire old or low-strength memories (soft delete).

### Roles

Eight roles. Fill in what applies, skip what doesn't.

PENMAN roleRecall roleMeaningExample:subjectsubjectWho or what it's aboutAlice:objectobjectWhat is acted onthe proposal:instrumentinstrumentTool, method, or meansSlack:recipientrecipientWho receives or benefitsBob:originsourceWhere it came fromthe old system:locuslocusWhere, when, or contextsprint review:attributeattributeA named propertytime complexity:valuevalueThe specific valueO(n log n)

### Memory types

TypeUse forDecay rateepisodicEvents, meetings, conversationsFastsemanticFacts, preferences, definitionsSlowproceduralHow-to, workflows, processesSlowest

### Moods

MoodWhen to useactualSomething that happened or is true (default)plannedSomething intended to happenuncertainSomething that might be truenormativeSomething that should or shouldn't beconditionalSomething that depends on a condition

### Modifiers

ModifierValuesDefault:tensepast, present, future--:negatedtrue, falsefalse:importance0.0 to 1.0--:causeNested atom: why it happened--:purposeNested atom: what for--:conditionNested atom: if/when/unless--

### Environment variables

HYPABASE_DB_PATH -- SQLite database path (default: hypabase.db)
HYPABASE_EMBEDDER -- Embedder for semantic search:

fastembed (default) -- BAAI/bge-small-en-v1.5 via ONNX
openai -- text-embedding-3-small (requires OPENAI_API_KEY)
sentence-transformers -- all-MiniLM-L6-v2
none -- disable embeddings
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: harshidwasekar
- Version: 0.2.4
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-01T21:20:27.568Z
- Expires at: 2026-05-08T21:20:27.568Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/hypabase-memory)
- [Send to Agent page](https://openagent3.xyz/skills/hypabase-memory/agent)
- [JSON manifest](https://openagent3.xyz/skills/hypabase-memory/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/hypabase-memory/agent.md)
- [Download page](https://openagent3.xyz/downloads/hypabase-memory)