← Back to Skills Marketplace
1258
Downloads
1
Stars
2
Active Installs
15
Versions
Install in OpenClaw
/install org-memory
Description
Extends the org-cli skill so the agent also persists its own memory (knowledge, observations, daily notes) to an org workspace.
Usage Guidance
This plugin appears to implement the advertised functionality (storing agent memory in a separate org workspace) and uses only the 'org' CLI and local files. Before installing: 1) Confirm you have the 'org-cli' skill and that ORG_CLI_BIN points to a trusted 'org' binary. 2) Ensure the ORG_MEMORY_* env vars point to directories you want the agent to read/write. 3) Be cautious about the optional migration: it reads ~/.openclaw/workspace/MEMORY.md and can write ~/.openclaw/openclaw.json to disable the default memory plugin — only allow that after backing up openclaw.json and explicitly consenting. 4) Note the small inconsistencies (SKILL.md mentions an install download and extra scope vars that are not declared); if you need high assurance, review the plugin files locally (index.ts, lib.ts) or ask the maintainer to clarify the migration UI and confirm no automatic config changes will be made. If you are uncomfortable with a plugin that can be instructed to modify OpenClaw config, do not enable migration or do not install.
Capability Analysis
Type: OpenClaw Skill
Name: org-memory
Version: 1.0.2
The skill provides a framework for the agent to maintain its own long-term memory using an external 'org' CLI binary. While the code follows standard patterns, it includes high-risk instructions in 'references/memory-architecture.md' that direct the AI agent to modify its own core configuration file (~/.openclaw/openclaw.json) to disable default plugins. Furthermore, the skill relies on executing a binary defined by environment variables (ORG_CLI_BIN) via execFile, which, combined with the instructions to modify system-level configs, represents a significant capability for system alteration that warrants caution.
Capability Assessment
Purpose & Capability
Name/description match the implemented behavior: the plugin runs the 'org' CLI against an agent-specific directory and roam DB and exposes tools to read/add/append agent memory. Required binaries/env vars (org, ORG_MEMORY_DIR, ORG_MEMORY_ROAM_DIR, ORG_MEMORY_DB, ORG_CLI_BIN) are appropriate for the stated purpose. Minor inconsistency: SKILL.md metadata and reference docs mention ORG_CLI_DIR/ORG_CLI_DB in the declared read/write scope, but those env vars are not listed in requires.env; code itself uses only ORG_MEMORY_* and ORG_CLI_BIN.
Instruction Scope
Runtime instructions and code read agent memory files (memory.org, daily/*.org) and inject them into session context — this is expected. However the included 'Memory migration' doc outlines a migration that would read ~/.openclaw/workspace/MEMORY.md and write to $ORG_MEMORY_DIR and also update ~/.openclaw/openclaw.json to disable the default memory plugin. Although the doc says 'Never start migration automatically' and requires explicit user confirmation, these steps would modify OpenClaw global config and read/write files outside the declared ORG_MEMORY_* workspace, which is outside the core scope and is sensitive.
Install Mechanism
Registry shows no install spec, which is low-risk. SKILL.md metadata contains an 'install' suggestion to download from the project's GitHub releases — GitHub releases is a reasonable source. There is a small inconsistency between registry install metadata (none) and the SKILL.md install entry; nothing here points to unusual or untrusted download hosts.
Credentials
The required env vars are proportional to the skill's function (workspace directory, roam dir, DB, and org binary). No cloud credentials or unrelated secrets are requested. Caveat: the migration instructions involve reading/writing ~/.openclaw files (MEMORY.md, openclaw.json) which are not declared env vars — this expands the I/O surface beyond the declared workspace and should be explicitly consented to by the user.
Persistence & Privilege
The skill is not 'always' and does not auto-enable itself; tool registration is optional. However, the documented migration flow instructs updating ~/.openclaw/openclaw.json to disable the default memory plugin — a modification of the agent's global configuration. Even if only executed with user confirmation, this capability to modify OpenClaw configuration and other users' workspace files is a sensitive privilege and increases risk.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install org-memory - After installation, invoke the skill by name or use
/org-memory - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
org-memory 1.0.2
- Added `ORG_CLI_BIN` to required environment variables in metadata for clearer configuration.
- Updated docs in SKILL.md to reflect new environment requirements and clarify configuration details.
- No changes to core functionality; this is a metadata and documentation update.
v1.0.1
- Updated plugin metadata and dependencies in package.json and package-lock.json.
- No user-facing changes to skill behavior or documentation.
- Internal version bump from 1.0.0 to 1.0.1 for maintenance.
v1.0.0
org-memory 1.0.0
- Adds a dedicated agent memory workspace, with `@a`-prefixed shortcuts for persisting agent knowledge, observations, and notes.
- Agent-side actions mirror `org-cli` commands, targeting the agent's org-mode workspace and org-roam graph.
- When active, graph-structured agent knowledge uses org-roam instead of memory-wiki.
- Provides session-start hooks to load agent memory and daily notes.
- Updates logging to distinguish agent writes (`org-memory:` prefix) from user workspace changes.
- Revises configuration: new env vars for agent directories; requires `org-cli` skill as a dependency.
- Documentation updated; two references removed, one added ("memory-architecture.md").
v0.6.1
org-memory 0.6.1
- Improved TypeScript support and code reliability with updates to main and test files.
- Updated dependency versions in package.json and package-lock.json.
- Minor adjustments to plugin metadata for compatibility and stability.
- No user-facing changes to behavior or SKILL.md documentation.
v0.5.3
org-memory 0.5.3
- Added support for ORG_MEMORY_AGENT_ROAM_DIR and ORG_MEMORY_HUMAN_ROAM_DIR environment variables.
- Updated documentation to reflect new environment variable requirements.
- Updated plugin configuration files for enhanced org-roam directory handling.
- Dependency versions updated in package files.
v0.5.2
org-memory 0.5.2
- Expanded environment variable support in skill metadata: now recognizes additional variables such as ORG_MEMORY_USE_FOR_AGENT, ORG_MEMORY_USE_FOR_HUMAN, ORG_MEMORY_ORG_BIN, and ORG_MEMORY_INBOX_FILE.
- Defined explicit read/write data scopes and migration support in plugin configuration.
- Documentation (SKILL.md, references) and package files updated to reflect and support broader environment and migration scenarios.
- No interface or behavioral changes for users; all updates are related to improved configuration, setup, and migration capabilities.
v0.5.1
**Short summary:**
Introduces new, concise input prefixes and expands task and knowledge management features.
- Added support for shorthand input prefixes (e.g., `t:`, `d:`, `k:`) for faster and more flexible commands.
- Implemented support for task rescheduling using the `s:` prefix.
- Extended the alias system for TODOs, Notes, "Done", and agent memory, covering more natural language variations.
- Updated documentation for all new prefixes and input patterns.
- Added initial automated tests (index.test.ts) for improved reliability.
v0.4.0
Initial Openclaw plugin implementation for org-memory.
- Added plugin entrypoint and manifest files for Openclaw platform compatibility.
- Included plugin/index.ts, openclaw.plugin.json, package.json, and package-lock.json in the repository.
- No changes to org-memory functionality or usage instructions.
v0.3.1
org-memory 0.3.1 changelog:
- Added in-depth reference documentation: knowledge-management.md, memory-architecture.md, task-management.md.
- Clarified and restructured SKILL.md for improved onboarding and environment setup.
- Unified and simplified shortcut actions and command safety instructions in the documentation.
- Updated install metadata and refined environment variable requirements.
- Removed the legacy README.md file—key docs now live under references/.
v0.2.1
org-memory 0.2.1
- Added recommendations to run `org index` after initializing org directories for proper CUSTOM_ID auto-assignment and support for file-less commands.
- Updated usage instructions: headlines now receive auto-assigned `custom_id` on creation; follow-up commands referencing headlines should use this `custom_id`.
- Clarified difference between `org note` (for LOGBOOK metadata) and `org append` (for headline body content), with usage examples.
- Task management docs now begin with a recommended `org today` query for actionable tasks.
- Improved setup, initialization, and command usage explanation throughout documentation for clarity and accuracy.
v0.1.4
org-memory 0.1.4 changelog:
- Shortcut actions now require a confirmation line in the format: `org-memory: <action> <file-path>` after every write.
- Clarified that confirmations should be printed directly after acting on 'Remember' or 'Note' patterns, instead of asking for confirmation.
- Examples added for the new confirmation line to guide correct output.
v0.1.3
org-memory 0.1.3
- No file changes detected in this release.
- Documentation, usage instructions, and configuration details remain unchanged.
- No new features, bug fixes, or updates introduced in this version.
v0.1.2
No user-visible changes in this release (version 0.1.2).
v0.1.1
No changes detected in this version.
- No file changes were found between versions.
- No new features, bug fixes, or documentation changes to report.
v0.1.0
Initial release of org-memory skill.
- Provides structured knowledge base and task management using org-mode files and the `org` CLI.
- Supports querying, updating, linking, and searching both org files and org-roam databases.
- Defines shortcut patterns ("Remember:", "Note:") for quickly capturing agent and human data.
- Ensures search-before-create discipline to prevent duplicate nodes in the knowledge graph.
- Includes guidance for setup, environment configuration, and command usage for both knowledge and task management.
- Supports batch operations for atomic multi-step updates.
Metadata
Frequently Asked Questions
What is org-memory?
Extends the org-cli skill so the agent also persists its own memory (knowledge, observations, daily notes) to an org workspace. It is an AI Agent Skill for Claude Code / OpenClaw, with 1258 downloads so far.
How do I install org-memory?
Run "/install org-memory" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is org-memory free?
Yes, org-memory is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does org-memory support?
org-memory is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created org-memory?
It is built and maintained by DCPRevere (@dcprevere); the current version is v1.0.2.
More Skills