fleet-memory/hindsight-docs
Nicolò Boschi e22ae05f47
refactor(openclaw)!: read config from plugin config instead of process.env (#974)
* refactor(openclaw)!: read config from plugin config instead of process.env

The plugin loaded credentials and runtime settings from environment
variables (HINDSIGHT_API_LLM_*, HINDSIGHT_EMBED_API_*, HINDSIGHT_BANK_ID)
plus auto-detection of OPENAI_API_KEY / ANTHROPIC_API_KEY / GEMINI_API_KEY
/ GROQ_API_KEY. That tripped OpenClaw's install-scanner env-harvesting
rule and bypassed the framework's first-class SecretRef resolution.
Switch to reading from the plugin config exclusively, with secrets
configured via 'openclaw config set ... --ref-source env|file|exec'.

Combined with the daemon lifecycle extraction in #949, this closes the
remaining install-scanner findings the 0.5.x plugin was hitting. The
plugin source now contains neither process.env nor child_process; the
former moved to plugin config (resolved by OpenClaw before the plugin
loads), and the latter lives in @vectorize-io/hindsight-all under
node_modules where the scanner's directory walker skips it. The plugin
can be installed without --dangerously-force-unsafe-install.

BREAKING CHANGE: drops the llmApiKeyEnv plugin config field along with
the HINDSIGHT_API_LLM_*, HINDSIGHT_EMBED_API_*, and HINDSIGHT_BANK_ID
environment variables. Users must now configure llmProvider and
llmApiKey explicitly via 'openclaw config set'. Migration guide is in
hindsight-docs/docs-integrations/openclaw.md and the integration
changelog.

* chore(openclaw): pin published versions of hindsight-all and hindsight-client

Phase 2 (#949) introduced @vectorize-io/hindsight-all and
@vectorize-io/hindsight-client as plugin dependencies using 'file:'
workspace paths. Those paths resolve inside the monorepo but break when
the published tarball is installed outside it — 'openclaw plugins
install @vectorize-io/hindsight-openclaw' failed with 'Cannot find
module @vectorize-io/hindsight-all' because npm could not resolve the
file: path from the extracted extension directory.

Replace both with semver ranges targeting the published versions:

  @vectorize-io/hindsight-all   ^0.1.0
  @vectorize-io/hindsight-client ^0.5.0

Verified end-to-end: 'openclaw plugins install <local-tarball>' now
succeeds without --dangerously-force-unsafe-install and without the
workspace-symlink hack. npm pulls both dependencies from the registry
into the extracted extension's node_modules, the plugin loads cleanly,
and 'openclaw plugins doctor' reports no issues.
2026-04-10 18:27:28 +02:00
..
blog blog: Agno Persistent Memory (#951) 2026-04-09 14:27:08 -04:00
docs feat: add HINDSIGHT_API_DEFAULT_BANK_TEMPLATE env var (#966) 2026-04-10 16:41:28 +02:00
docs-integrations refactor(openclaw)!: read config from plugin config instead of process.env (#974) 2026-04-10 18:27:28 +02:00
examples fix(ci): resolve all CI failures (#847) 2026-04-02 17:17:42 +02:00
scripts fix(ci): resolve all CI failures (#847) 2026-04-02 17:17:42 +02:00
src refactor(openclaw)!: read config from plugin config instead of process.env (#974) 2026-04-10 18:27:28 +02:00
static blog: Agno Persistent Memory (#951) 2026-04-09 14:27:08 -04:00
versioned_docs Release v0.5.0 2026-04-08 17:56:47 +02:00
versioned_sidebars Release v0.5.0 2026-04-08 17:56:47 +02:00
.gitignore rename to hindsight (#2) 2025-11-25 19:28:26 +01:00
docusaurus.config.ts feat: add @vectorize-io/hindsight-all daemon lifecycle package (#949) 2026-04-10 15:51:44 +02:00
package.json feat: bank template import/export with Template Hub (#819) 2026-04-02 12:21:53 +02:00
README.md rename to hindsight (#2) 2025-11-25 19:28:26 +01:00
sidebars.ts feat: add @vectorize-io/hindsight-all daemon lifecycle package (#949) 2026-04-10 15:51:44 +02:00
tsconfig.json rename to hindsight (#2) 2025-11-25 19:28:26 +01:00
versions.json Release v0.5.0 2026-04-08 17:56:47 +02:00

Website

This website is built using Docusaurus, a modern static website generator.

Installation

npm install

Local Development

npm start

This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.

Build

npm run build

This command generates static content into the build directory and can be served using any static contents hosting service.

Deployment

Using SSH:

USE_SSH=true npm run deploy

Not using SSH:

GIT_USER=<Your GitHub username> npm run deploy

If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the gh-pages branch.