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:安装
由于 Claude Code 安全策略限制,可能无法自动完成配置,推荐在终端中手动执行以下步骤。
在终端执行如下安装命令:
curl -fsSL https://openviking.ai/install | bash # AI agent 如不确定是否执行,可先阅读脚本头部,其中写明了它会做什么、如何核实。安装器会依次询问以下信息:要安装的 harness(勾选 Claude Code)、OpenViking 凭据、是否开启 Statusline 状态栏。
在 OpenViking 凭据配置中,选择连接至「火山引擎 OpenViking 云服务 [api.vikingdb.cn-beijing.volces.com]」,并填入 API KEY:
{{OPENVIKING_API_KEY}}OpenViking StatusLine 是输入框下方的一行状态提示栏,用于实时展示 OpenViking 记忆插件的运行状态。可根据个人需要选择「开启」或「跳过」。状态提示栏示例如下:
OV ✓ │ Fable 5 · ctx 42% │ ↪ 6 mem (0.92) · 50ms │ ✎ 573/20k · 2 arch
步骤2:验证
重启 Claude Code。
执行
/plugins命令,确认 installed 列表中显示openviking-memory已安装,且openvikingMCP 已连接:User ❯ openviking-memory Plugin · openviking · ✔ enabled └ openviking MCP · ✔ connected执行
/mcp,确认 OpenViking 显示为 connected。工具数量随服务端版本变化:Built-in MCPs (always available) ❯ plugin:openviking-memory:openviking · ✔ connected执行
/openviking-memory:ov命令,确认服务状态正常:OpenViking Memory Status ✅ Status: OpenViking server is healthy and running
步骤3:开始使用
在 Claude Code 中新开一个会话,发送:
按 https://docs.openviking.net/agents/zh/onboarding.md 带我完成 OpenViking 首次使用。
Agent 会检查连接,并带你完成首次使用。
故障排查
| 问题 | 处理 |
|---|---|
| 插件未激活 | 重跑安装,或检查 ~/.openviking/ovcli.conf |
| 召回为空 | curl "$(jq -r '.url' ~/.openviking/ovcli.conf)/health" |
| 401 / 403 | 检查鉴权凭据 |
| 需要日志 | OPENVIKING_DEBUG=1,看 ~/.openviking/logs/cc-hooks.log |