@spectyra/local-companion
v1.0.55
Published
Spectyra Local Companion — local-first LLM optimization runtime for OpenClaw and other tools
Maintainers
Readme
@spectyra/local-companion
OpenClaw / local-first companion — runs on your machine alongside of OpenClaw without sending your traffic through Spectyra’s cloud.
Anonymous and free for OpenClaw. No Spectyra account is required. Optional Spectyra account features are separate from this package.
Savings between 60% - 70% were observed during testing with OpenClaw.
Requirements
- Node.js 20+
- pnpm (recommended) or npm
Install
npm install -g @spectyra/local-companion
# or
pnpm add -g @spectyra/local-companionRun
Start the companion to see OpenClaw savings in real-time (launches in browser):
spectyra-companion start --openStop (ctrl-c process in terminal or cmd prompt) or run:
spectyra-companion stopStatus:
spectyra-companion statusFrom a clone of this repo:
cd tools/local-companion
pnpm install
pnpm run build
pnpm exec spectyra-companion startWhat runs locally
Typical local HTTP surface (paths may vary slightly by version; see /health after start):
| Path | Role |
|------|------|
| GET /health | Liveness |
| GET /dashboard | Small local dashboard (if enabled) |
| POST /v1/chat/completions | Chat completions proxy surface used by the agent stack |
Everything above is on your machine unless you configure upstream models yourself.
Anonymous usage telemetry
When OpenClaw free mode is on (default), the companion may send minimal anonymous telemetry (e.g. install ping, coarse usage events) to Spectyra so we can see aggregate adoption. No API keys, prompts, or tool payloads are included.
State file (installation id, etc.): ~/.spectyra/companion/state.json.
Antivirus / VirusTotal
Published npm artifacts are Node bundles (dist/*.cjs) plus package.json, README.md, and a tiny postinstall.cjs script. There is no Python in the package. Sandboxes sometimes flag minified JS, postinstall, or network-capable tools as generic “suspicious” behavior (VirusTotal and similar engines are heuristic). Inspect the tarball with npm pack --dry-run and compare hashes to this repo if you need to verify what you uploaded.
License
MIT — see the Spectyra repository LICENSE.
