fleet-memory/hindsight-integrations/nemoclaw
Ben d284de28c7
feat(nemoclaw): add hindsight-nemoclaw setup CLI package (#630)
* feat(nemoclaw): add hindsight-nemoclaw setup CLI package

Automates the full NemoClaw sandbox setup:
- Installs @vectorize-io/hindsight-openclaw plugin
- Configures external API mode in ~/.openclaw/openclaw.json
- Reads current openshell sandbox policy, merges Hindsight egress rule, re-applies
- Restarts the OpenClaw gateway

Options: --dry-run, --skip-policy, --skip-plugin-install
36 unit tests passing

* docs: add NEMOCLAW.md setup guide

* feat(nemoclaw): add README, docs page, and release pipeline

* revert: remove release.yml changes from nemoclaw PR
2026-03-20 15:16:55 +01:00
..
src feat(nemoclaw): add hindsight-nemoclaw setup CLI package (#630) 2026-03-20 15:16:55 +01:00
NEMOCLAW.md feat(nemoclaw): add hindsight-nemoclaw setup CLI package (#630) 2026-03-20 15:16:55 +01:00
package-lock.json feat(nemoclaw): add hindsight-nemoclaw setup CLI package (#630) 2026-03-20 15:16:55 +01:00
package.json feat(nemoclaw): add hindsight-nemoclaw setup CLI package (#630) 2026-03-20 15:16:55 +01:00
README.md feat(nemoclaw): add hindsight-nemoclaw setup CLI package (#630) 2026-03-20 15:16:55 +01:00
tsconfig.json feat(nemoclaw): add hindsight-nemoclaw setup CLI package (#630) 2026-03-20 15:16:55 +01:00
vitest.config.ts feat(nemoclaw): add hindsight-nemoclaw setup CLI package (#630) 2026-03-20 15:16:55 +01:00

hindsight-nemoclaw

One-command setup for Hindsight persistent memory on NemoClaw sandboxes.

NemoClaw runs OpenClaw inside an OpenShell sandbox with strict network egress policies. This package automates the full setup: installing the hindsight-openclaw plugin, configuring external API mode, merging the Hindsight egress rule into your sandbox policy, and restarting the gateway.

Quick Start

npx @vectorize-io/hindsight-nemoclaw setup \
  --sandbox my-assistant \
  --api-url https://api.hindsight.vectorize.io \
  --api-token <your-api-key> \
  --bank-prefix my-sandbox

Get an API key at Hindsight Cloud.

Documentation

Full setup guide, pitfalls, and troubleshooting:

NemoClaw Integration Documentation

Or see NEMOCLAW.md in this directory for a step-by-step walkthrough.

CLI Reference

hindsight-nemoclaw setup [options]

Options:
  --sandbox <name>       NemoClaw sandbox name (required)
  --api-url <url>        Hindsight API URL (required)
  --api-token <token>    Hindsight API token (required)
  --bank-prefix <prefix> Memory bank prefix (default: "nemoclaw")
  --skip-policy          Skip sandbox network policy update
  --skip-plugin-install  Skip openclaw plugin installation
  --dry-run              Preview changes without applying
  --help                 Show help

What It Does

  1. Preflight — verifies openshell and openclaw are installed
  2. Install plugin — runs openclaw plugins install @vectorize-io/hindsight-openclaw
  3. Configure plugin — writes external API mode config to ~/.openclaw/openclaw.json
  4. Apply policy — reads current sandbox policy, merges Hindsight egress rule, re-applies via openshell policy set
  5. Restart gateway — runs openclaw gateway restart

License

MIT