openclaw storage¶

管理在 storage.locations 下配置的命名目标位置。有关配置、加密和提供商契约，请参阅 存储位置。

openclaw storage list
openclaw storage init archive
openclaw storage test archive

三个命令都接受 --json，包括放在子命令之前：

openclaw storage list --json
openclaw storage --json init archive
openclaw storage test archive --json

列表¶

storage list 显示每个已配置的位置、其提供商、可用时的显示目标，以及其探测状态。 探测会读取位置标记，并检查访问权限和加密密钥。它 不会初始化位置或写入测试对象。报告容量的提供商会在 JSON 输出中包含可用字节数和总字节数。

初始化¶

storage init <name> 通过仅创建操作写入位置的标识和加密标记。使用相同的加密配置重复执行时， 会验证现有标记；它不会替换该标记。错误的口令会导致失败。

对于 filesystem 位置，配置的绝对路径必须已经存在 并且是一个目录。OpenClaw 从不创建此根目录。在初始化其位置之前，请确认 外部磁盘已挂载。

初始化是显式的，因此断开的磁盘或空挂载点不会 静默成为新的目标位置。如果运行时操作报告缺少 标记，请重新连接磁盘或检查存储桶和前缀。仅当位置是新的时才初始化该位置。例如：

存储位置 "r2test" (r2://bucket/prefix) 没有初始化标记。如果这是一个新位置，请运行 openclaw storage init r2test；否则请重新连接磁盘或检查存储桶和前缀。

测试¶

storage test <name> 在位置根目录写入一个小型、唯一的 .openclaw-probe-<uuid> 对象，通过 已配置的加密层将其读回，验证每个字节，然后删除 该对象。它要求位置已初始化，并且从不初始化位置。 在文件系统位置上不会创建探测目录。

成功的 JSON 结果包含 state: "ok" 和 sizeBytes。写入失败、 读回验证失败或清理失败都会导致命令失败。如果清理期间提供商不可达， 请在删除任何遗留探测对象之前重新连接它。

存储位置可能包含凭据和私人对话。除非目标位置已经受到保护，并且你有意 选择 encryption: "none"，否则请使用加密。