openclaw storage

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

openclaw storage listopenclaw storage init archiveopenclaw storage test archive

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

openclaw storage list --jsonopenclaw storage --json init archiveopenclaw 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"，否则请使用加密。