本文将引导您完成 OpenClaw 接入火山引擎云数据库 PostgreSQL 版的全部配置步骤。
OpenClaw 是一款开源轻量化 AI 智能体工具,代码与数据在本地部署不上传云端,用户可以在本地轻松运行。工具依托各类 Skill 技能拓展实际业务能力,支持对接主流大语言模型和搭配丰富的功能插件,用户只需配置对应技能,通过自然语言即可下发指令自动完成各类工作,既能实现文件处理、脚本运行、日常办公自动化,也可依托云管、运维类 Skill 统一管理服务器、数据库等云资源,完成资源查询、批量运维、日常巡检等操作。 在开始操作前,请确保您已完成以下准备工作:
- 已获取火山引擎账号的访问密钥,便于 OpenClaw 能够通过 API 与火山引擎服务进行交互。
- 在 API 访问密钥页面创建或获取一对有效的 Access Key ID 和 Secret Access Key。
- 已有云数据库 PostgreSQL 版实例的相关权限,且已为实例创建数据库账号。
若您需要对实例中库表进行管理,数据库账号也应授予相应权限(例如:SELECT、INSERT、SHOW 等)。
您有两种方式安装部署 OpenClaw,选择其中一种即可。
火山引擎提供了官方的一键部署方案,能够帮助您在云服务器(ECS)上快速完成 OpenClaw 的安装与基础配置。
如果您希望在本地计算机(macOS, Windows, Linux)上安装,请按照以下步骤操作。
- 安装 OpenClaw:打开您的终端或命令提示符,根据您的操作系统选择并执行对应的命令。
- 对于 Windows 系统 (使用 PowerShell):
- 完成初始配置:安装脚本运行后,会引导您完成一些基础配置,例如设置大语言模型的 API Key。请根据终端中的提示信息完成这些步骤。成功安装后,OpenClaw 的核心服务便已在您的设备上运行。
成功安装 OpenClaw 后,还需要进行一些关键配置,才能使其具备连接和管理云数据库 PostgreSQL 版资源的能力。
确保您的 OpenClaw 所在环境中已安装 Python,并安装 uv 工具(一个快速的 Python 包安装器)。
- 安装火山引擎 RDS PostgreSQL Skill
执行以下命令,下载 RDS PostgreSQL Skill 并将其复制到 OpenClaw 的 Skill 目录下。
完成上述步骤后,您可以打开 OpenClaw 的 Web 控制台(Console)。在 Skill 管理或插件页面,您应该能看到名为 volcengine-rds-postgresql 的 Skill 已被成功加载。
为 OpenClaw 配置访问火山引擎所需的访问密钥。环境变量通常存储在 ~/.openclaw/.env 文件中(如果您使用一键部署方式,路径可能为 /root/.openclaw/.env) ,请编辑该文件,并添加以下两行:
说明
请将占位符替换为您在准备工作中获取的真实密钥信息。
为了让新配置的环境变量生效,您需要重启 OpenClaw 服务。具体的重启方式取决于您的安装方式(例如,通过 systemctl、docker restart 或其自带的管理命令)。重启后,Skill 即可使用配置的密钥进行鉴权。
配置完成后,您便可以开始通过自然语言与 OpenClaw 交互,管理您的云数据库 PostgreSQL 版实例。
- 查询数据库表:您可以直接向 OpenClaw 发出指令,对数据库进行查询。例如:“帮我查一下 demo 数据库中有几张表”或“帮我查询 sys_user 表中 ID 为 4 的用户信息”。
- 定时任务:结合 OpenClaw 的任务调度能力,您可以设置定时任务,让它在指定时间自动执行数据备份或性能监控等操作。