diff --git a/docs/agent-创建规范-实现计划.md b/docs/agent-创建规范-实现计划.md
index 71e6e7a..01261b1 100644
--- a/docs/agent-创建规范-实现计划.md
+++ b/docs/agent-创建规范-实现计划.md
@@ -85,8 +85,9 @@ Task D（红线+索引）  ┘
 ## 数据库规范
 - **默认库：** `{{AGENT_ID}}` —— 这就是我自己的库
 - **账号：** `agent_{{AGENT_ID}}`
-- **密码：** 环境变量 `DB_PASSWORD_{{AGENT_NAME}}`
-- **连接：** `mysql -h 127.0.0.1 -u agent_{{AGENT_ID}} -p"${DB_PASSWORD_{{AGENT_NAME}}}" {{AGENT_ID}}`
+- **连接（推荐）：** `~/.openclaw/scripts/db-conn.sh {{AGENT_ID}}`（交互式）或 `~/.openclaw/scripts/db-conn.sh {{AGENT_ID}} --sql "select database()"`
+- **口令：** 由该脚本自动从 `~/.openclaw/.env` 读取（键名 `DB_PASSWORD_{{AGENT_NAME}}`），口令不会出现在命令行中
+
 - **禁止：** 使用 root、使用 `docker exec`、访问其他 agent 的库、跨库写入
 - **建表前**先确认字段与索引；**破坏性语句**（DROP / TRUNCATE / 无条件 DELETE）必须先请示