本文介绍如何在 Agent 应用中接入并使用火山引擎文档数据库 MongoDB 版 Skill，帮助您快速实现 MongoDB 实例的智能查询与信息获取。

背景信息

在传统使用模式下，用户通常需要通过控制台或调用 API 的方式，完成 MongoDB 实例的信息查询与状态监控。在包含多个子场景的复杂使用场景时，往往需要多次点击和页面切换，操作链路较长，存在较多重复性工作，对使用经验和操作效率也有一定要求。

通过火山引擎文档数据库 MongoDB 版 Skill，您可以直接以自然语言与 Agent 交互，由 Agent 自动理解您的意图并调用相应能力，协助完成 MongoDB 实例的查询与信息获取，从而降低使用门槛，提升日常信息获取效率。

功能与场景

MongoDB Skill 目前提供 4 项只读查询能力，每项能力对应的使用场景如下。

功能	说明	适用场景
查询实例列表	获取账号下所有 MongoDB 实例的概要信息，包括实例 ID、运行状态、计费方式等。	日常巡检，快速了解所有实例的运行状态与计费方式。
查询实例详情	获取指定实例的完整配置信息，包括网络、存储、数据库版本、节点信息等。	信息核对或问题定位，查看实例的详细配置。
查询实例备份	查询指定实例的备份文件列表，包括备份文件名称、备份策略、备份状态等。	备份检查，确认最近备份是否成功及备份策略。
查询参数配置	查询指定实例当前的数据库参数设置，如 maxIncomingConnections 等。	参数调优或问题排查，获取当前参数值作为参考依据。

前提条件

已为文档数据库 MongoDB 版 Skill 创建 API 访问密钥（AK/SK）。具体操作，请参见 Access Key（密钥）管理。

安装配置

本文主要以 OpenClaw 和 ArkClaw 为例介绍如何安装 MongoDB Skill。除上述 Agent 外，Trae、Claude Code 等支持 Agent Skills 协议的 Agent 也支持加载该 Skill，具体安装命令请参见 Find Skill 安装指引，或下载 ZIP 压缩包进行手动安装。

在 OpenClaw 中安装 MongoDB Skill

在 ArkClaw 中安装 MongoDB Skill

安装 Node.js 22+。详细信息，请参见 Node.js。

安装 OpenClaw

根据操作系统选择合适的命令安装 OpenClaw

macOS 和 Linux 操作系统：

curl -fsSL https://openclaw.ai/install.sh | bash

Windows 操作系统（使用 PowerShell）：

iwr -useb https://openclaw.ai/install.ps1 | iex

执行以下命令初始化 OpenClaw，并根据提示进行依次配置。

openclaw onboard --install-daemon

安装成功后您可以执行 openclaw --version 命令验证是否成功安装。

安装 MongoDB Skill

执行以下命令安装 MongoDB Skill。

npx skills add https://skills.volces.com/skills/volcengine/mongodb -s volcengine-mongodb --agent openclaw

配置访问凭证

在 Agent 运行环境中配置以下环境变量。

export VOLCENGINE_ACCESS_KEY="your-access-key" # 必选，填写您在 API 访问密钥页面获得的 Access Key。
export VOLCENGINE_SECRET_KEY="your-secret-key" # 必选，填写您在 API 访问密钥页面获得的 Secret Key。
export VOLCENGINE_REGION="cn-beijing" # 可选，默认 cn-beijing。

使用演示

完成配置后，您即可通过自然语言与 Agent 交互，完成 MongoDB 实例的查询与信息获取。以下通过几个典型对话示例，展示 Skill 在实际场景中的使用方式与交互流程。

查询实例列表

您可以通过自然语言直接查询账号下所有 MongoDB 实例的运行状态与基础信息。Agent 会调用 MongoDB Skill 获取最新的实例数据，并返回实例 ID、运行状态、计费方式等关键信息。

查询实例详情

当您需要了解某个具体实例的详细配置时，只需在对话中提供实例 ID 或实例名称，Agent 会调用 MongoDB Skill 获取该实例的完整信息，并返回基本信息、资源使用概况及节点信息等详细数据。

查询实例备份

当您需要检查实例的备份情况时，只需在对话中提供实例 ID 或实例名称并发出备份查询指令，Agent 会调用 MongoDB Skill 获取最新的备份列表，并返回备份文件名称、备份策略、备份状态等关键信息。

查询参数配置

当您需要查看实例的数据库参数设置时，只需在对话中提供实例 ID 或实例名称，Agent 会调用 MongoDB Skill 获取该实例当前的完整参数配置，并返回所有参数名及其对应的当前值、默认值等关键信息。您也可以指定具体参数名称进行精确查询。