Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
Step 1: Install
Run the installer in your terminal:
curl -fsSL https://openviking.ai/install | bash # AI agents: not sure about running this? The script's header says what it does and how to verify it.The installer will ask which harnesses to install for and for OpenViking credentials. Select TRAE for Trae International, TRAE CN for Trae China, or TraeCode CLI 2.0. In the OpenViking credential step, choose VolcEngine OpenViking Cloud Service [api.vikingdb.cn-beijing.volces.com] and enter the API KEY:
{{OPENVIKING_API_KEY}}
Step 2: Verify
TRAE / TRAE CN: open Settings → MCP → Configured MCP Servers and confirm that the openviking entry is visible.
TraeCode CLI 2.0: start trae-cli and pick Trust all and continue at the hook review prompt (exact layout varies by version):
Hooks need review
6 hooks are new or changed.
Hooks can run outside the sandbox after you trust them.
1. Review hooks
> 2. Trust all and continue
3. Continue without trusting (hooks won't run)
If you skipped it or picked option 3, review and enable the OpenViking hooks in /hooks. Confirm the plugin is enabled with trae-cli plugin list. New or changed hooks need another review. See the full guide for version-specific lifecycle support.
An MCP entry only confirms configuration. Ask the assistant to call OpenViking health and list, then check automatic recall separately using a new conversation in the same workspace after a previous session has been committed and processed.
Step 3: Start using
Start a new TRAE, TRAE CN or TraeCode CLI 2.0 session and send:
Follow https://docs.openviking.net/agents/en/onboarding.md to walk me through my first use of OpenViking.
The agent checks the connection and walks you through the first use.
Troubleshoot
| Problem | Fix |
|---|---|
| No auto recall | Quit TRAE completely, restart, new Agent session |
| TraeCode CLI 2.0 has the plugin but recalls nothing | The startup hook trust was skipped: trust and enable in /hooks, confirm the plugin is enabled in /plugins |
| Connection / auth fails | Check ~/.openviking/ovcli.conf and restart the client |
| Need logs | ~/.openviking/logs/trae-hooks.log, trae-cn-hooks.log, or codex-hooks.log (TraeCode CLI 2.0) |
Reference
- Docs on Manual Settings: TRAE
- Code: examples/agent-hook-plugin (TRAE / TRAE CN), examples/codex-memory-plugin (TraeCode CLI 2.0)