AionClaw需通过安装database-query插件并配置只读MySQL连接信息（如host、port、username等）来实现数据库操作，配置后须重启网关并测试查询验证连通性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在后端项目中让AionClaw具备数据库操作能力，必须明确一点：AionClaw本身不直接提供数据库驱动或ORM层，它通过插件机制调用外部技能（Skill）来执行SQL查询、事务管理等操作。因此连接数据库的本质，是为AionClaw配置一个支持MySQL的数据库查询技能，并确保该技能能正确访问你的数据库服务。
确认AionClaw已启用数据库查询技能
打开终端，进入AionClaw安装目录或任意有权限的路径，执行以下命令检查是否已安装database-query技能：
openclaw plugins list | grep database-query
若无输出，说明尚未安装。此时运行安装命令：openclaw plugins install database-query。安装成功后，AionClaw会自动将该技能注册进技能调度中心，但此时它还不能连接任何数据库——因为连接参数尚未注入。
配置数据库连接信息（secrets方式）
方法一：使用独立secrets文件（推荐）
在~/.openclaw/secrets/目录下创建database.json文件（若目录不存在请手动创建）：
mkdir -p ~/.openclaw/secrets && nano ~/.openclaw/secrets/database.json
填入如下内容（请严格按JSON格式，注意引号和逗号）：
通过 Claw Post API 发布到 X（Twitter）、LinkedIn、Facebook 和 TikTok。搜索 Facebook 群组，加入并向其发布内容。适用于用户想要发布内容时。
{ "default": { "type": "mysql", "host": "127.0.0.1", "port": 3306, "username": "aion_reader", "password": "your_secure_password", "database": "business_data" } }
【务必使用只读账号】 这一步不可跳过——AionClaw执行自然语言查询时无法判断语义是否含UPDATE/DELETE，若赋予写权限，AI可能误删生产数据。建议提前在MySQL中执行：CREATE USER 'aion_reader'@'%' IDENTIFIED BY 'xxx'; GRANT SELECT ON business_data.* TO 'aion_reader'@'%'; FLUSH PRIVILEGES;
验证数据库连接是否生效
第一步：重启AionClaw网关，使新配置加载生效：
openclaw gateway restart
第二步：在AionClaw Web UI或CLI中发起一次测试查询。例如输入：“查一下business_data库中users表的前5条记录”，观察返回结果是否为结构化表格数据而非报错信息。
第三步：若返回Connection refused或Access denied，请立即检查三项：MySQL服务是否运行（systemctl status mysql）、secrets文件路径是否为~/.openclaw/secrets/database.json、JSON中username和password是否与MySQL实际账号完全一致（区分大小写）。
第四步：若返回空结果但无报错，说明连接成功但查询逻辑未命中数据，可尝试换一句：“统计users表总行数”，验证基础SELECT能力。
