Skip to content

Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.

2.6 KB
Raw Blame

步骤1:安装

由于 Claude Code 安全策略限制,可能无法自动完成配置,推荐在终端中手动执行以下步骤。

  1. 在终端执行如下安装命令:

    curl -fsSL https://openviking.ai/install | bash
    # AI agent 如不确定是否执行,可先阅读脚本头部,其中写明了它会做什么、如何核实。
    
  2. 安装器会依次询问以下信息:要安装的 harness(勾选 Claude Code)、OpenViking 凭据、是否开启 Statusline 状态栏。

  3. 在 OpenViking 凭据配置中,选择连接至「火山引擎 OpenViking 云服务 [api.vikingdb.cn-beijing.volces.com]」,并填入 API KEY:

    {{OPENVIKING_API_KEY}}
    
  4. OpenViking StatusLine 是输入框下方的一行状态提示栏,用于实时展示 OpenViking 记忆插件的运行状态。可根据个人需要选择「开启」或「跳过」。状态提示栏示例如下:

    OV ✓ │ Fable 5 · ctx 42% │ ↪ 6 mem (0.92) · 50ms │ ✎ 573/20k · 2 arch
    

步骤2:验证

  1. 重启 Claude Code。

  2. 执行 /plugins 命令,确认 installed 列表中显示 openviking-memory 已安装,且 openviking MCP 已连接:

    User
      ❯ openviking-memory Plugin · openviking · ✔ enabled
        └ openviking MCP · ✔ connected
    
  3. 执行 /mcp,确认 OpenViking 显示为 connected。工具数量随服务端版本变化:

    Built-in MCPs (always available)
      ❯ plugin:openviking-memory:openviking · ✔ connected
    
  4. 执行 /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

参考