上下文和指令（待定）

添加元数据以指导处理：--reason 和 --instruction 将在未来支持。

异步处理控制

添加资源可能耗时较长（例如几分钟），语义处理可以是异步的。使用 --wait 等待处理完成。

# 等待直到语义处理完成
ov add-resource ./docs --wait

# 带超时等待（单位：秒）
ov add-resource https://example.com/docs --wait --timeout 60

# 发送后即忘（默认，不带 --wait）
ov add-resource ./docs

如果你使用发送后即忘模式，命令将在资源在服务器上完全下载/上传后返回，然后 CLI 将返回导入资源的根 URI。要检查资源的状态，可以使用 ov ls 或 ov tree 来列出根 URI 或 viking://resources/ 下的资源。

指定目标路径

默认情况下，资源被导入到 viking://resources/ 下。使用 --to 或 --parent 来指定目标 URI。

# 数据将被导入为 viking://resources/2026/2026-01-01/，该路径在导入前不应存在
ov add-resource /User/volcengine/Photo/Travels/2026/2026-01-01/ --to "viking://resources/2026/2026-01-01/"

# 数据将被导入到 viking://resources/2026 下，该路径应存在且是一个目录
ov add-resource /User/volcengine/Photo/Travels/2026/2026-01-02/ --parent "viking://resources/2026/"

CLI 输出

返回导入资源的根 URI，例如：

root_uri  viking://resources/2026/2026-01-01

CLI 前提条件

• CLI 配置在：~/.openviking/ovcli.conf
• 服务器能够访问要导入的 URL
• CLI 能够读取要导入的本地文件/目录。

OpenViking (OV) add-memory

ov add-memory 命令添加持久化记忆——将文本和结构化对话转换为 OpenViking 上下文数据库中可搜索、可检索的记忆。使用 ov add-memory --help 获取最新用法。

使用场景

• 在学到值得跨会话记住的内容之后
• 持久化对话见解、决策或发现
• 从交互中构建知识库
• 当智能体希望存储上下文以备将来检索时

输入模式

在纯文本模式和多轮对话模式之间明智选择。多轮对话模式可以包含更复杂的见解，让 openviking 处理记忆提取。

模式 1：用于压缩记忆的纯文本

一个简单的字符串被存储为一条 user 消息：

ov add-memory "用户的名字是 Bob，他于 2025-01-08 参加了全球黑客马拉松，并获得了冠军。"

模式 2：用于更丰富上下文的多轮对话

一个 {role, content} 对象的 JSON 数组，用于存储完整的对话交换：

ov add-memory '[
  {"role": "user", "content": "我喜欢旅行。给我一些从北京到上海的交通选择。"},
  {"role": "assistant", "content": "你可以乘坐火车、大巴或飞机。火车最快，但需要提前预订。大巴更便宜，但需要等待。飞机最贵，但一天中的任何时间都可以到达。"},
  {"role": "user", "content": "我更喜欢火车。我喜欢在火车上观光。你能给我火车时刻表吗？"},
  < ... 更多关于时刻表和购票需要记忆的对话 ... >
]'

输出

返回提取的记忆数量：

memories_extracted   1

智能体最佳实践

如何编写好的记忆

1. 具体明确 —— 包含具体细节，而非模糊的总结
2. 包含上下文 —— 说明为何重要，何时适用
3. 使用结构化格式 —— 将“是什么”与“为什么”分开

批量处理相关事实

在一次调用中分组相关的记忆，而不是多次小调用：

ov add-memory '[
  {"role": "user", "content": "关于 ov_cli Rust crate 的关键事实"},
  {"role": "assistant", "content": "1. 运行速度比 python cli 快\n2. 使用 HttpClient 连接 openviking 服务器\n3. 输出格式支持表格和 JSON 模式\n4. 配置位于 ~/.openviking/ovcli.conf"}
]'

前提条件

• CLI 已配置：~/.openviking/ovcli.conf

OpenViking (OV) add-skill

ov add-skill 命令向 OpenViking 添加智能体能力——支持 SKILL.md 文件、MCP 工具定义和原始技能内容。技能会自动处理并组织在 viking://agent/skills/ 命名空间下，使其可被智能体发现和使用。

使用场景

• 添加自定义智能体能力和工作流
• 导入 MCP（模型上下文协议）工具
• 在智能体会话间持久化技能定义
• 构建可重用的智能体能力库
• 当智能体需要使用自定义逻辑扩展其工具集时

输入格式

模式 1：SKILL.md 文件

从带有 YAML 前置元数据的单个 SKILL.md 文件导入：

# 从单个 SKILL.md 文件添加
ov add-skill ./skills/my-skill/SKILL.md

# 从包含 SKILL.md 的目录添加（包含辅助文件）
ov add-skill ./skills/my-skill/

CLI 选项

异步处理控制

语义处理是异步进行的。使用 --wait 阻塞直到完成：

# 等待直到语义处理完成
ov add-skill ./skills/my-skill/ --wait

# 带超时等待（单位：秒）
ov add-skill ./skills/my-skill/ --wait --timeout 60

# 发送后即忘（默认，不带 --wait）
ov add-skill ./skills/my-skill/

CLI 输出

返回已添加技能的 URI，例如：

uri  viking://agent/skills/my-skill/

SKILL.md 格式

技能使用带有 YAML 前置元数据的 Markdown：

---
name: skill-name
description: 技能的简要描述
allowed-tools:
  - Tool1
  - Tool2
tags:
  - tag1
  - tag2
---

包含辅助文件

当从目录添加时，目录中的所有文件都作为辅助文件包含：

# 目录结构：
# ./skills/code-runner/
#   ├── SKILL.md
#   ├── helper.py
#   └── templates/
#       └── script.py

ov add-skill ./skills/code-runner/
# helper.py 和 templates/ 都被包含

CLI 前提条件

• CLI 已配置：~/.openviking/ovcli.conf
• 技能文件（SKILL.md）应采用正确的 markdown 格式。

每周安装量

49

代码仓库

volcengine/openviking

GitHub 星标数

19.4K

首次出现

2026年3月10日

安全审计

Gen Agent Trust HubWarnSocketPassSnykWarn

安装于

kimi-cli49

gemini-cli49

amp49

cline49

github-copilot49

codex49