必须在aionclaw初始化前明确数据库连接策略与权限边界,仅支持sqlite 3.24+、postgresql 12~16、mysql 8.0.28+;sqlite自动建库,postgresql/mysql需预建空库并授予connect、create及表级增删改查权限。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

当你准备在 AionClaw 网站部署或集成需要持久化存储的业务模块(例如用户行为日志、自定义技能状态、定时任务历史、多轮对话记忆等)时,必须在网站初始化前明确数据库连接策略与权限边界,否则后续运行中会出现任务中断、状态丢失或权限拒绝错误。
确认数据库类型与版本兼容性
打开 AionClaw 官方文档的「部署依赖」章节,核对当前安装包支持的数据库列表:仅限 SQLite 3.24+、PostgreSQL 12~16、MySQL 8.0.28+;【不支持 MariaDB、SQL Server 或任何云数据库托管实例的直连模式】。若你本地已装 MySQL 5.7,请先升级——旧版本无法解析 AionClaw 自动生成的 JSON 字段语法。
提前声明数据库路径或连接串
方法一:使用 SQLite(推荐新手) 直接在安装向导最后一步的「高级配置」面板勾选「启用本地状态持久化」→ 程序将自动创建 ./data/aionclaw.db 文件,无需手动建库。 方法二:使用 PostgreSQL/MySQL 必须在首次启动前,编辑 config.yaml 中的 database 配置块:填入 host、port、username、password、database 名称;【database 名必须已存在且为空库,AionClaw 不会自动建库】。这一步漏做会导致初始化失败并退出进程,无错误日志提示。
授予最小必要权限
第一步:用 DBA 账号登录目标数据库。 第二步:执行授权语句(以 PostgreSQL 为例): GRANT CONNECT, CREATE ON DATABASE your_db_name TO aionclaw_user; 第三步:切换到该库,执行: GRANT SELECT, INSERT, UPDATE, DELETE ON ALL TABLES IN SCHEMA public TO aionclaw_user; 注意:不能只给 USAGE 权限,否则 Hermes Agent 启动时无法写入 task_execution_log 表,所有定时任务将静默跳过。











