Skip to content

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

2.7 KB
Raw Blame

步骤1:安装

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

    curl -fsSL https://openviking.ai/install | bash
    # AI agent 如不确定是否执行,可先阅读脚本头部,其中写明了它会做什么、如何核实。
    
  2. 安装器会依次询问以下信息:要安装的 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)

参考