d284de28c7
* 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
60 lines
2.1 KiB
Markdown
60 lines
2.1 KiB
Markdown
# hindsight-nemoclaw
|
|
|
|
One-command setup for [Hindsight](https://hindsight.vectorize.io) persistent memory on [NemoClaw](https://nemoclaw.ai) sandboxes.
|
|
|
|
NemoClaw runs [OpenClaw](https://openclaw.ai) 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
|
|
|
|
```bash
|
|
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](https://ui.hindsight.vectorize.io/signup).
|
|
|
|
## Documentation
|
|
|
|
Full setup guide, pitfalls, and troubleshooting:
|
|
|
|
**[NemoClaw Integration Documentation](https://vectorize.io/hindsight/sdks/integrations/nemoclaw)**
|
|
|
|
Or see [NEMOCLAW.md](./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`
|
|
|
|
## Links
|
|
|
|
- [Hindsight Documentation](https://vectorize.io/hindsight)
|
|
- [NemoClaw](https://nemoclaw.ai)
|
|
- [OpenClaw](https://openclaw.ai)
|
|
- [GitHub Repository](https://github.com/vectorize-io/hindsight)
|
|
|
|
## License
|
|
|
|
MIT
|