@clawmover/cli 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenClaw Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,288 @@
+# @clawmover/cli
+
+OpenClaw 数据备份和恢复命令行工具。
+
+## 功能特性
+
+- 🔄 **自动备份**: 将 OpenClaw 数据备份到远程服务器
+- 📥 **数据恢复**: 从服务器快速恢复数据到本地
+- 🔒 **数据加密**: 使用 data-secret-key 加密所有备份数据
+- ⚡ **增量备份**: 基于 restic 的增量备份，节省存储空间
+- 🏷️ **标签管理**: 使用标签组织和筛选备份
+- ⚖️ **冲突处理**: 多种策略处理文件冲突
+- 📊 **进度显示**: 实时显示备份和恢复进度
+- 🔍 **详细日志**: 完整的操作日志记录
+
+## 安装
+
+```bash
+npm install -g @clawmover/cli
+```
+
+或从源码安装:
+
+```bash
+git clone https://github.com/clawmover/clawmover-cli.git
+cd clawmover-cli
+npm install
+npm run build
+npm link
+```
+
+## 配置
+
+工具会自动读取 OpenClaw 配置文件，你也可以通过命令行参数覆盖:
+
+```bash
+# 查看配置文件路径
+openclaw config file
+```
+
+## 使用方法
+
+### 备份数据
+
+基本备份命令:
+
+```bash
+clawmover backup
+```
+
+指定实例 ID 和密钥:
+
+```bash
+clawmover backup --instance-id your-instance-id --data-secret-key your-secret-key
+```
+
+高级选项:
+
+```bash
+clawmover backup \
+  --instance-id your-instance-id \
+  --data-secret-key your-secret-key \
+  --tags production,daily \
+  --conflict-strategy smart \
+  --skip-temp \
+  --skip-cache \
+  --log-level debug
+```
+
+**参数说明:**
+
+- `--instance-id <id>`: 实例 ID (覆盖配置文件)
+- `--data-secret-key <key>`: 数据密钥 (覆盖配置文件)
+- `--tags <tags>`: 逗号分隔的标签列表
+- `--conflict-strategy <strategy>`: 冲突处理策略 (smart|interactive|overwrite)，默认: smart
+- `--skip-temp`: 跳过临时文件
+- `--skip-cache`: 跳过缓存文件
+- `--storage-path <path>`: 自定义存储路径
+- `--log-level <level>`: 日志级别 (debug|info|warn|error)
+
+### 恢复数据
+
+基本恢复命令:
+
+```bash
+clawmover restore
+```
+
+指定快照 ID:
+
+```bash
+clawmover restore --snapshot-id abc123
+```
+
+按标签筛选:
+
+```bash
+clawmover restore --tags core,imessage-db
+```
+
+高级选项:
+
+```bash
+clawmover restore \
+  --instance-id your-instance-id \
+  --data-secret-key your-secret-key \
+  --snapshot-id abc123 \
+  --tags core \
+  --conflict-strategy interactive \
+  --target-path /tmp/restore \
+  --log-level info
+```
+
+**参数说明:**
+
+- `--instance-id <id>`: 实例 ID (覆盖配置文件)
+- `--data-secret-key <key>`: 数据密钥 (覆盖配置文件)
+- `--snapshot-id <id>`: 要恢复的快照 ID (默认: 最新)
+- `--tags <tags>`: 逗号分隔的标签，用于筛选快照
+- `--conflict-strategy <strategy>`: 冲突处理策略 (smart|interactive|overwrite)，默认: smart
+- `--target-path <path>`: 恢复的目标目录
+- `--log-level <level>`: 日志级别 (debug|info|warn|error)
+
+## 冲突处理策略
+
+### Smart (智能处理，推荐)
+
+- **配置文件**: 询问用户如何处理
+- **数据库**: 自动备份旧版本
+- **附件**: 重命名本地文件
+- **普通文件**: 比较修改时间，保留较新的
+
+### Interactive (交互式处理)
+
+每个冲突都会询问用户选择:
+- 备份现有文件并覆盖
+- 重命名现有文件
+- 跳过此文件
+- 直接覆盖
+
+### Overwrite (自动覆盖)
+
+直接覆盖所有冲突文件，不进行备份
+
+## 备份计划
+
+工具会自动生成备份计划，包含以下数据类型:
+
+1. **Core 数据** (必需)
+   - OpenClaw 核心配置和数据
+   - 标签: `core`
+
+2. **iMessage 数据库** (可选)
+   - 如果配置了 `imessageDb`
+   - 标签: `imessage-db`, `core`
+
+3. **iMessage 附件** (可选)
+   - 如果配置了 `imessageAttachments`
+   - 标签: `imessage-attachments`, `core`
+
+4. **Sandbox 数据** (可选)
+   - 沙箱环境数据
+   - 标签: `sandbox`
+
+5. **缓存数据** (可选)
+   - 应用缓存
+   - 标签: `cache`
+
+6. **临时文件** (可选)
+   - 临时文件
+   - 标签: `temp`
+
+## 标签系统
+
+使用标签可以更好地组织和筛选备份:
+
+```bash
+# 创建带标签的备份
+clawmover backup --tags production,daily
+
+# 恢复特定标签的数据
+clawmover restore --tags production
+
+# 查看特定实例的所有备份
+clawmover list --instance-id your-instance-id
+```
+
+自动添加的标签:
+- `instance:<instanceId>`: 实例 ID
+- `date:<YYYY-MM-DD>`: 备份日期
+
+## 日志和调试
+
+设置日志级别:
+
+```bash
+# 详细调试信息
+clawmover backup --log-level debug
+
+# 只显示错误
+clawmover backup --log-level error
+```
+
+日志文件默认保存在 `./logs/clawmover.log`。
+
+## 开发
+
+### 项目结构
+
+```
+@clawmover/cli/
+├── src/
+│   ├── commands/          # 命令执行层
+│   ├── services/          # 核心服务层
+│   ├── integrations/      # 外部集成层
+│   ├── system/            # 系统服务层
+│   ├── types/             # 类型定义
+│   ├── utils/             # 工具函数
+│   └── index.ts           # 入口文件
+├── tests/                 # 测试文件
+├── package.json
+├── tsconfig.json
+└── README.md
+```
+
+### 构建
+
+```bash
+npm run build
+```
+
+### 测试
+
+```bash
+# 运行所有测试
+npm test
+
+# 监视模式
+npm run test:watch
+
+# 覆盖率报告
+npm run test:coverage
+```
+
+### 代码质量
+
+```bash
+# Lint
+npm run lint
+
+# 自动修复
+npm run lint:fix
+
+# 格式化代码
+npm run format
+```
+
+## 故障排除
+
+### 备份失败
+
+1. 检查网络连接
+2. 验证 `data-secret-key` 是否正确
+3. 查看日志文件获取详细错误信息
+
+### 恢复失败
+
+1. 确认快照 ID 存在
+2. 检查目标目录权限
+3. 验证 `data-secret-key` 是否与备份时相同
+
+### 找不到 OpenClaw 配置
+
+运行以下命令检查配置文件位置:
+
+```bash
+openclaw config file
+```
+
+## 许可证
+
+MIT
+
+## 支持
+
+如有问题或建议，请访问:
+- GitHub Issues: https://github.com/clawmover/clawmover-cli/issues
+- 文档: https://github.com/clawmover/clawmover-cli#readme