Local OSS

setup

Interactive wizards for plain CLI and OpenClaw integration.

`reflexio setup`

Interactive wizards that write credentials and provider keys to ~/.reflexio/.env and — for the integration commands — install hooks into the host tool. Use init if you just want the CLI configured; use the integration commands when you also want Reflexio wired into OpenClaw.

All setup commands are interactive — they prompt for provider choice and API keys. Use them in a real terminal, not in a CI job.

`reflexio setup init`

Configure Reflexio without installing any integration. Writes REFLEXIO_URL / REFLEXIO_API_KEY / LLM provider keys / storage backend to ~/.reflexio/.env. Run this if you're using the reflexio CLI directly from your shell.

reflexio setup init [--skip-llm]

Prop

Type

What it asks

Storage

Choose one of:

Local SQLite - local Reflexio server, no extra credentials.
Local OSS with a custom URL - prompts for the OSS server URL and optional API key.

LLM provider

Pick from OpenAI, Anthropic, Gemini, DeepSeek, OpenRouter, MiniMax, DashScope, xAI, Moonshot, or ZAI. Writes the provider's API key env var (e.g. OPENAI_API_KEY) into the .env.

Skipped when --skip-llm is set.

Embedding provider

If the chosen LLM provider does not support embeddings (everything except OpenAI and Gemini), you are prompted to pick an embedding-capable provider separately.

`reflexio setup openclaw`

Install (or remove) the openclaw-smart integration for OpenClaw. Registers the reflexio-openclaw-smart plugin into openClaw, writes the openclaw CLI path and the OPENCLAW_SMART_USE_LOCAL_CLI=1 opt-in to ~/.reflexio/.env, and runs the plugin's first-run installer so the next session doesn't pay a cold-install cost.

reflexio setup openclaw [--uninstall] [--repair] [--purge] [--embedding=auto|local|openai|gemini]

Prop

Type

Prerequisites

openclaw CLI on your PATH (install from openclaw.ai). The setup wizard captures its absolute path and writes it to OPENCLAW_BIN so the reflexio backend's openclaw_provider LiteLLM plugin can spawn it for extraction.

What gets installed

The reflexio-openclaw-smart plugin into openClaw's plugin registry.
~/.reflexio/.env keys: OPENCLAW_BIN (absolute path) and OPENCLAW_SMART_USE_LOCAL_CLI=1.
~/.openclaw-smart/ state directory (sessions, install markers, logs).
A ~/.reflexio/openclaw-plugin-root symlink to the active plugin install so slash commands resolve to one stable path.

Skill commands

After install, the plugin exposes five user-invokable skills inside openClaw:

Skill	What it does
`reflexio`	Always-on contract: trust injected context, cite with `[oc:…]`, stay quiet
`learn`	Force-publish the current session for immediate extraction
`show`	Print currently-known skills + preferences for this project as markdown
`dashboard`	Open the local reflexio web UI (`http://localhost:3001`)
`restart`	Restart the local reflexio backend cleanly
`clear-all`	Delete all locally-stored skills + preferences (destructive, prompts first)

Next steps after install

reflexio services start (the SessionStart hook also auto-starts the backend).
openclaw gateway restart.
Start a conversation — openclaw-smart will capture and learn automatically.