Openclaw 中轻松使用知识库--向量数据库VikingDB-火山引擎

文档中心

向量数据库VikingDB

请输入

知识库最佳实践

Openclaw 中轻松使用知识库

一、背景介绍

为了降低使用门槛，Viking 知识库提供了 CLI 命令行工具，将知识库的创建、文档管理、检索问答等核心操作封装为统一的 CLI 接口。在此基础上，Viking 进一步将 CLI 能力封装为 Agent Skill，接入 Agent 后，直接用自然语言描述需求，Agent 会自动调用对应的 viking-cli 完成操作。

如需直接通过命令行使用 Viking CLI，可参考：Viking CLI 使用文档

二、准备工作

2.1 权限申请

在火山云控制台为你的账号授予以下两个权限：

VikingdbFullAccess：知识库操作权限
TOSFullAccess：对象存储权限（用于将本地文件上传至知识库）

2.2 安装 CLI 与 Skill

在 agent 对话框中发送以下 Prompt，即可完成一键安装与鉴权：

将 your_ak / your_sk 替换为你在火山云控制台申请的真实密钥。出于安全考虑，更推荐直接在终端中运行 viking-cli auth 完成鉴权配置，避免将密钥明文输入到对话框中。

请帮我通过以下两条命令安装 Viking CLI 及对应 Skill：

1. 安装 CLI：curl -fsSL http://viking-skills.tos-cn-beijing.volces.com/viking-cli/install.sh | bash
2. 安装 Skill：npx skills add https://skills.volces.com/skills/volcengine/viking -s byted-viking-cli --agent openclaw

安装完成后，请将以下内容写入 ~/.viking/config 文件完成鉴权配置：

VIKING_CLOUD=volcengine
VIKING_PROJECT=default
VIKING_REGION=cn-beijing
VIKING_AK=your_ak
VIKING_SK=your_sk

以 Openclaw 为例：

三、Viking CLI 功能及示例 prompt

功能	示例 Prompt
创建个人知识库	帮我创建一个 Viking 知识库创建完成后默认命名为 `viking_cli_{userid}`，后续操作不指定知识库名称时自动使用该默认值
创建指定名称的知识库	帮我创建一个名为 viking_cli_test 的 Viking 知识库
查看知识库详情	查看知识库 viking_cli_test 的信息
列出所有知识库	列出我所有的 Viking 知识库
删除知识库	删除知识库 viking_cli_test
添加在线文档	把 https://xxx/report.pdf 添加到 Viking 知识库
添加本地文件	把 /Users/xxx/report.pdf 添加到 Viking 知识库
批量添加本地目录	把 /Users/xxx/docs 目录下的所有文件添加到 Viking 知识库
列出知识库中的文档	列出知识库 viking_cli_test 中的所有文档
查看文档详情	查看知识库中文档 doc_001 的详情
更新文档	更新知识库中文档 doc_001 的名称
删除文档	删除知识库中的文档 doc_001
知识库检索	在 Viking 知识库中搜索关于 API 鉴权的内容
基于知识库问答	基于 Viking 知识库分析一下 2025 Q1 财报的亮点

四、在 Openclaw 中的使用示例

4.1 创建知识库并查看知识库信息

4.2 上传文档到知识库

通过 url 上传图片

通过 url 上传 pdf 文档

4.3 基于知识库问答

最近更新时间：2026.04.24 18:15:41

这个页面对您有帮助吗？

有用

无用

向量数据库VikingDB

一、背景介绍 #

二、准备工作 #

2.1 权限申请 #

2.2 安装 CLI 与 Skill #

三、Viking CLI 功能及示例 prompt #

四、在 Openclaw 中的使用示例 #

4.1 创建知识库并查看知识库信息 #

4.2 上传文档到知识库 #

4.3 基于知识库问答 #