ClawDNA — 身份备份与同步

您已安装 ClawDNA 技能。ClawDNA 是一款命令行工具，用于对您的身份文件（SOUL.md、AGENTS.md、IDENTITY.md、MEMORY.md、TOOLS.md、USER.md）进行版本管理与同步，确保它们永不偏离预期状态或意外丢失。您的职责是主动协助用户使用 ClawDNA 命令保护其 agent 身份。

何时介入

在执行高风险变更前建议创建快照

在发生以下任一情况前，请建议用户运行 clawdna snapshot：

• 升级 OpenClaw 运行时或任何重大依赖项
• 编辑 SOUL.md、AGENTS.md 或 IDENTITY.md（核心人格文件）
• 安装或卸载修改 TOOLS.md 的技能/插件
• 更改通道配置或工作区结构
• 首次运行 clawdna memory distill

向用户的示例提示：

此变更可能影响您的身份文件。是否需要我先执行 clawdna snapshot --name "before-"？以便在必要时快速回滚。

当最近一次推送已过期时发出警告

若用户提及同步、备份或切换设备，或您有理由怀疑上一次 clawdna push 已超过 24 小时，请提醒用户：

距上次推送已有一段时间。请运行 clawdna push 将最新身份同步至 hub，或运行 clawdna diff 查看变更内容。

检测身份漂移

若您发现身份文件（如 SOUL.md、MEMORY.md 等）被直接编辑，且未随之执行快照或推送操作，请立即标记：

自上次快照以来，您的身份文件已发生变化。请运行 clawdna diff --local 审阅变更，再执行 clawdna push 完成同步。

引导恢复流程

若用户提及设置丢失、agent 异常或需在新设备上初始化，请按以下步骤引导其完成恢复：

1. 新设备：运行 clawdna clone --agent-id 从 hub 拉取完整身份
2. 回滚：运行 clawdna restore --bundle 恢复至指定快照
3. 诊断：运行 clawdna doctor 检查安装健康度及 hub 连通性

CLI 命令参考

核心命令

同步命令

管理命令

备份内容说明

ClawDNA 管理您 OpenClaw 工作区中的以下身份文件：

不备份的内容（密钥保护机制）

ClawDNA 的敏感信息清洗器会在每次推送、快照或导出前作为硬性拦截闸运行。若检测到以下内容，操作将被阻断：

• API 密钥（OpenAI、Anthropic 等）
• Bot Token（Telegram、Discord 等）
• JWT 或 Bearer Token
• 私钥文件头（如 -----BEGIN PRIVATE KEY-----）
• 匹配 ~/.clawdna/.secretsignore 中用户自定义规则的任意模式

openclaw.json 中的内联密钥将自动替换为 $ENV_VAR_NAME 引用格式。若在任意 Markdown 格式身份文件中检测到密钥，该操作将中止。

故障排查

“检测到密钥”错误

清洗器在您的身份文件中发现了密钥。这是预期行为 —— 密钥绝不可离开您的本地设备。

修复方法：从被标记的文件中移除密钥，并改用环境变量引用。清理完成后重试该命令。

若属误报，您可在 ~/.clawdna/.secretsignore 中添加例外匹配规则。

hub 不可达

clawdna push 或 clawdna pull 无法连接 hub。

诊断方法：运行 clawdna doctor —— 该命令会检查 hub 连通性与认证状态。

常见原因：

• hub token 缺失或已过期（检查 CLAWDNA_HUB_TOKEN 环境变量，或运行 clawdna env switch）
• 网络问题或防火墙阻止访问 hub URL
• hub URL 配置错误（检查 ~/.clawdna/config.json）

拉取时发生冲突（状态已分叉）

本地与 hub 均在上次同步后发生了变更。

修复方法：clawdna pull 将显示差异并提示您选择：以 hub 版本为准、以本地版本为准，或取消操作。请仔细审阅差异后再做决定。您也可先执行 clawdna snapshot 保存当前状态。

升级后身份发生变更

clawdna upgrade 检测到 OpenClaw 升级过程修改了核心身份文件。

修复方法：升级命令已提供自动回滚选项。若您当时拒绝，仍可手动执行：

clawdna restore --bundle ~/.clawdna/snapshots/pre-upgrade-.dna

Doctor 报告权限警告

配置文件权限应设为 600（仅所有者可读写），快照目录权限应设为 700。

修复方法：执行 chmod 600 ~/.clawdna/config.json 与 chmod 700 ~/.clawdna/snapshots/。