{"_id":"@astramindapp/mind-claw","name":"@astramindapp/mind-claw","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@astramindapp/mind-claw","version":"0.1.0","description":"MINDClaw — OpenClaw with MIND baked in. Persistent knowledge graph memory by default. One install, one command, fully wired.","license":"MIT","type":"module","bin":{"mindclaw":"bin/mindclaw.mjs"},"scripts":{"test":"node --test src/lib/*.test.mjs 2>/dev/null || echo 'no tests yet'","lint":"node --check bin/mindclaw.mjs && find src -name '*.mjs' -exec node --check {} +"},"keywords":["mindclaw","openclaw","mind","mindapp","knowledge-graph","ai-memory","persistent-memory","obsidian-alternative","personal-ai","agent","mcp","model-context-protocol"],"author":{"name":"Astra AI","email":"hello@theastraway.com"},"homepage":"https://www.m-i-n-d.ai/mindclaw.html","repository":{"type":"git","url":"git+https://github.com/theastraway/mindclaw.git"},"bugs":{"url":"https://github.com/theastraway/mindclaw/issues"},"dependencies":{"openclaw":"^2026.5.3","@astramindapp/openclaw-mind":"^0.1.0"},"engines":{"node":">=18"},"gitHead":"d5b908deb758fb002f7b878253c38661d2338009","_id":"@astramindapp/mind-claw@0.1.0","_nodeVersion":"25.6.1","_npmVersion":"11.9.0","dist":{"integrity":"sha512-1LkLLxPGE6KLceURc1K3ge0W4BQ/BlB5UPPyoTnMXyu4x6CUDv31vg3K9GVg/ztU9E28HU7dF6gDp9GrmN/vxQ==","shasum":"d77aae6820a61b0a6c0ef3ed801e12438e54dc65","tarball":"https://registry.npmjs.org/@astramindapp/mind-claw/-/mind-claw-0.1.0.tgz","fileCount":35,"unpackedSize":113392,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIFzP2F6Qm/rYJDzji9JuXRxpCM3E5KxU92tn+VoPsaNxAiBQW2gbrYIOxmd0pN8v8r9c9Q29BYtxj4kpK2ZCiSijTg=="}]},"_npmUser":{"name":"theastraway","email":"anthony@theastraway.com"},"directories":{},"maintainers":[{"name":"theastraway","email":"anthony@theastraway.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mind-claw_0.1.0_1777911963771_0.3649651394291209"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-04T16:26:03.630Z","0.1.0":"2026-05-04T16:26:03.926Z","modified":"2026-05-04T16:26:04.197Z"},"maintainers":[{"name":"theastraway","email":"anthony@theastraway.com"}],"description":"MINDClaw — OpenClaw with MIND baked in. Persistent knowledge graph memory by default. One install, one command, fully wired.","homepage":"https://www.m-i-n-d.ai/mindclaw.html","keywords":["mindclaw","openclaw","mind","mindapp","knowledge-graph","ai-memory","persistent-memory","obsidian-alternative","personal-ai","agent","mcp","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/theastraway/mindclaw.git"},"author":{"name":"Astra AI","email":"hello@theastraway.com"},"bugs":{"url":"https://github.com/theastraway/mindclaw/issues"},"license":"MIT","readme":"# MINDClaw\n\n**OpenClaw with MIND baked in.** One install, one command. Persistent knowledge graph memory wired into every agent turn.\n\n```bash\ncurl -fsSL https://www.m-i-n-d.ai/install/mindclaw.sh | bash\n```\n\nOr with npm directly:\n\n```bash\nnpm install -g @astramindapp/mind-claw\nmindclaw init\n```\n\n## What MINDClaw is\n\nMINDClaw is a free, open-source distribution of [OpenClaw](https://github.com/openclaw/openclaw) with the [MIND](https://www.m-i-n-d.ai) knowledge-graph memory layer pre-installed and pre-configured.\n\nYou get:\n\n- The OpenClaw runtime, installed automatically on first run.\n- The `@astramindapp/openclaw-mind` plugin — 11 tools, 4 skills, lifecycle hooks for auto-recall and auto-capture.\n- The 16 MIND Front Layer typed-document templates (SOUL, IDENTITY, BELIEFS, USER, AGENTS, TOOLS, SENSES, SKILLS, BEHAVIOR, LESSON, DECISION, POLICY, WORKFLOW, PREFERENCE, GOAL, RELATIONSHIP) seeded into your knowledge graph on first run.\n- The `HOW_TO_THINK`, `HOW_TO_REMEMBER`, and `TAGGING_SYSTEM` operating manuals seeded alongside the templates so any agent can ask MIND how to think in MIND-shaped nouns.\n\nIn other words: stock OpenClaw plus everything you'd otherwise spend an hour wiring up by hand.\n\n## How it works\n\nThe `mindclaw` CLI is a slim wrapper around the upstream `openclaw` runtime. It owns first-run onboarding and a few native commands; everything else forwards verbatim, so muscle memory carries over.\n\nNative commands:\n\n| Command | What it does |\n|---|---|\n| `mindclaw` | First-run wizard, then start an interactive session |\n| `mindclaw init` | Re-run onboarding (replaces existing config) |\n| `mindclaw seed-templates` | Bootstrap the 16 typed-doc templates into your KG |\n| `mindclaw status` | Show MIND connection + plugin state |\n| `mindclaw upgrade` | Open Stripe checkout for the $10/mo Claw tier |\n\nAnything else is forwarded to `openclaw`. Examples:\n\n```bash\nmindclaw run \"Plan my Tuesday\"\nmindclaw plugins list\nmindclaw mind search \"what did we decide about pricing?\"\n```\n\n## Pricing\n\n| Tier | Price | What you get |\n|---|---|---|\n| **Free** | $0 forever | 50 credits/mo for premium MIND features, 10 MB KG storage, all 16 typed templates |\n| **Claw** | $10/mo | MCP-host access, 500 MB KG storage, 300 credits/mo, BYO LLM (you pay for inference yourself) |\n\nNeed more? The Starter ($49), Professional ($199), Business ($599), and Scale ($1499) tiers on [m-i-n-d.ai](https://www.m-i-n-d.ai) all work seamlessly with MINDClaw.\n\n## First-run wizard\n\nOn first launch, `mindclaw` asks how you want to connect:\n\n1. **Paste an existing MIND API key** — fastest path if you already have an account.\n2. **Create a free account** — registers a new MIND tenant via the public registration endpoint, issues an API key, and seeds the templates. No card required.\n3. **Create an account and upgrade to Claw** — same as #2, then opens Stripe checkout for the $10/mo tier in your browser.\n\nIn all three paths the wizard:\n\n- Writes the OpenClaw plugin config to `~/.openclaw/plugins/openclaw-mind.yaml`.\n- Writes `MIND_API_KEY` and `MIND_BASE_URL` to `~/.openclaw/.env`.\n- Runs `mindclaw seed-templates` automatically.\n- Saves wrapper state to `~/.mindclaw/state.json` (so `mindclaw status` works).\n\nRe-run the wizard any time with `mindclaw init`.\n\n## What gets seeded into your knowledge graph\n\nWhen you run `mindclaw seed-templates` (or first-run, automatically), MINDClaw seeds the following into your MIND tenant:\n\n- **The 16 Front Layer typed-document templates** — augmented markdown specs that tell an agent when and how to create a SOUL doc vs. a BELIEFS doc vs. a POLICY doc, with frontmatter slots and storage protocol.\n- **`HOW_TO_THINK.md`** — the six-step loop every agent should follow when its memory layer is MIND.\n- **`HOW_TO_REMEMBER.md`** — anatomy of a good memory, what belongs in MIND, and what doesn't.\n- **`TAGGING_SYSTEM.md`** — the topic / project / kind axis system that makes retrieval reliable.\n\nAfter seeding, any agent can ask MIND `\"what should I fill out for a BELIEFS document?\"` and the spec comes back from the user's own knowledge graph.\n\n## Why a distribution, not just a plugin\n\nThe MIND plugin for OpenClaw already exists. MINDClaw goes further: it ships the runtime, the plugin, the templates, the tagging docs, and the onboarding wizard as one package. New users go from `curl … | bash` to a working agent with persistent memory in under two minutes — no API key copy-paste, no config file editing, no plugin install step.\n\n## Configuration\n\nThe wrapper writes sensible defaults into `~/.openclaw/plugins/openclaw-mind.yaml`. To override anything, edit that file:\n\n```yaml\napiKey: ${MIND_API_KEY}\nbaseUrl: https://www.m-i-n-d.ai\nautoCapture: true\nautoRecall: true\ntopK: 10\nqueryMode: hybrid\nenableMindsense: true\nenableLifeIntegration: true\nenableCrmLogging: true\n```\n\nOr set env vars: `MIND_API_KEY`, `MIND_BASE_URL`. The plugin reads both.\n\n## Privacy and security\n\n- The `mindclaw` CLI is open source under MIT. No telemetry, no tracking.\n- Your MIND API key is stored locally in `~/.mindclaw/state.json` and `~/.openclaw/.env`, both with `0600` permissions.\n- All HTTP calls go to `https://www.m-i-n-d.ai` (or your `MIND_BASE_URL` override). No third parties.\n- Your knowledge graph is yours. Export it any time from the MIND web app.\n\n## Project layout\n\n```\nmindclaw/\n├── bin/mindclaw.mjs         CLI entry point\n├── src/\n│   ├── onboard.mjs           First-run wizard\n│   ├── install.mjs           Ensure runtime + plugin are installed\n│   ├── seed.mjs              Bootstrap templates into the user's KG\n│   ├── status.mjs            Health check\n│   ├── upgrade.mjs           $10 tier checkout\n│   └── lib/                  state, log, MIND API client, OpenClaw config\n├── templates/\n│   ├── front-layer/          16 typed-document templates\n│   ├── HOW_TO_THINK.md\n│   ├── HOW_TO_REMEMBER.md\n│   └── TAGGING_SYSTEM.md\n├── docs/mindclaw.html        Landing page\n├── install.sh                One-line installer\n└── backend-changes/          Backend changes the wrapper depends on\n```\n\n## Patents pending\n\nMIND's core technology is protected by multiple pending US patent applications.\n\n## License\n\nMIT. Built by [Astra AI](https://www.m-i-n-d.ai).\n","readmeFilename":"README.md","_rev":"1-3d11a5b338a22cc0acbd3a113b2f1643"}