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(勾选 Codex)、OpenViking 凭据。在 OpenViking 凭据配置中,选择连接至「火山引擎 OpenViking 云服务 [api.vikingdb.cn-beijing.volces.com]」,并填入 API KEY:
{{OPENVIKING_API_KEY}}
步骤2:验证
启动 Codex。首次启动会显示类似下面的 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。在/plugins中确认openviking-memory已启用。新增或变更的 hooks 需要重新检查。确认 OpenViking MCP 工具可用,让 Codex 调用
health和list。这一步验证工具连接;自动召回还需开启UserPromptSubmit,对话采集需开启Stop。在已有记忆的工作目录中询问之前保存的信息,检查 hook 输出或调试日志。召回内容类似:
• UserPromptSubmit hook (completed) hook context: <openviking-context source="auto-recall" format="digest"> OpenViking memory digest:新账号可能还没有 profile 或相关记忆可注入。会话提交时机和完整验证步骤见下方文档。
步骤3:开始使用
在 Codex 中新开一个会话,发送:
按 https://docs.openviking.net/agents/zh/onboarding.md 带我完成 OpenViking 首次使用。
Agent 会检查连接,并带你完成首次使用。
故障排查
| 问题 | 处理 |
|---|---|
| 鉴权失败 | 检查 ~/.openviking/ovcli.conf 的 api_key,重启 Codex |
| 连接失败 | curl "$(jq -r '.url' ~/.openviking/ovcli.conf)/health" |
6 hooks need review,或 Hook 不生效 |
/hooks 里信任并开启,/plugins 里确认插件已启用 |
| 需要日志 | OPENVIKING_DEBUG=1,看 ~/.openviking/logs/codex-hooks.log |
参考
- 手动配置文档:Codex
- 原理博客:OpenViking for coding agents
- 源码:examples/codex-memory-plugin