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(勾选 ZCode)、OpenViking 凭据。在 OpenViking 凭据配置中,选择连接至「火山引擎 OpenViking 云服务 [api.vikingdb.cn-beijing.volces.com]」,并填入 API KEY:
{{OPENVIKING_API_KEY}}
步骤2:验证
- 重启 ZCode。
- 确认
~/.zcode/cli/config.json包含hooks.enabled: true、hooks.events下的 OpenViking 条目,以及mcp.servers.openviking。 - 运行
node ~/.openviking/agent-integrations/zcode/scripts/ov-memory-doctor.mjs,检查安装状态和服务端连接。
步骤3:开始使用
在 ZCode 中新开一个会话,发送:
按 https://docs.openviking.net/agents/zh/onboarding.md 带我完成 OpenViking 首次使用。
Agent 会检查连接,并带你完成首次使用。
故障排查
| 问题 | 处理 |
|---|---|
| Hook 未执行 | 重新执行安装并重启 ZCode |
| MCP 工具未出现 | 检查 ~/.zcode/cli/config.json 中 mcp.servers.openviking 的绝对路径命令 |
| 重复捕获 | 先运行 curl -fsSL https://openviking.ai/install | bash -s -- --uninstall --yes --harness zcode,再重新安装 |
| 需要日志 | 设置 OPENVIKING_DEBUG=1,查看 ~/.openviking/logs/zcode-hooks.log |
参考
- 手动配置文档:ZCode
- 源码:examples/agent-hook-plugin