Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
Python agent-contextagent-memoryagent-pluginsagentic-ragcontext-databasedsh-pluginknowledge-basememorymemory-managementself-evolvingvector-database
步骤1:安装
在终端执行如下安装命令:
curl -fsSL https://openviking.ai/install | bash # AI agent 如不确定是否执行,可先阅读脚本头部,其中写明了它会做什么、如何核实。安装器会依次询问以下信息:要安装的 harness(Trae 国际版勾选 TRAE,Trae 中国版勾选 TRAE CN,或勾选 TraeCode CLI 2.0)、OpenViking 凭据。在 OpenViking 凭据配置中,选择连接至「火山引擎 OpenViking 云服务 [api.vikingdb.cn-beijing.volces.com]」,并填入 API KEY:
{{OPENVIKING_API_KEY}}
步骤2:验证
TRAE / TRAE CN:在「设置 → MCP → 已配置的 MCP Servers」中确认能够看到 openviking 条目即表示接入成功。
TraeCode CLI 2.0:启动 trae-cli,在 hook 审阅提示中选 Trust all and continue(具体界面随版本变化):
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)
如果跳过了提示或选了第 3 项,在 /hooks 中检查并开启 OpenViking hooks。执行 trae-cli plugin list 确认插件已启用。新增或变更的 hooks 需要重新检查;不同版本支持的会话生命周期见完整文档。
MCP 条目可见只说明配置存在。让助手调用 OpenViking 的 health 和 list 验证连接;自动召回需另行检查:等之前的会话提交并处理完成后,在同一工作目录中新建会话,询问已保存的信息。
步骤3:开始使用
在 TRAE、TRAE CN 或 TraeCode CLI 2.0 中新开一个会话,发送:
按 https://docs.openviking.net/agents/zh/onboarding.md 带我完成 OpenViking 首次使用。
Agent 会检查连接,并带你完成首次使用。
故障排查
| 问题 | 处理 |
|---|---|
| 没有自动召回 | 完全退出 TRAE,重启,再建会话 |
| TraeCode CLI 2.0 装了插件但不召回 | 启动时的 Hook 信任被跳过:/hooks 里信任并开启,/plugins 里确认插件已启用 |
| 连接 / 鉴权失败 | 检查 ~/.openviking/ovcli.conf,重启客户端 |
| 需要日志 | ~/.openviking/logs/trae-hooks.log、trae-cn-hooks.log 或 codex-hooks.log(TraeCode CLI 2.0) |
参考
- 手动配置文档:TRAE
- 源码:examples/agent-hook-plugin(TRAE / TRAE CN)、examples/codex-memory-plugin(TraeCode CLI 2.0)