重置

可以使用 openclaw reset 指令重置 OpenClaw。

重置本地配置/状态（保留 CLI 已安装）。

执行 openclaw reset --help 指令查看使用指南。

admin@192 workspace % openclaw reset --help

🦞 OpenClaw 2026.5.7 (eeef486) — Your AI assistant, now without the $3,499 headset.

Usage: openclaw reset [options]

Reset local config/state (keeps the CLI installed)

Options:
  --dry-run          Print actions without removing files (default: false)
  -h, --help         Display help for command
  --non-interactive  Disable prompts (requires --scope + --yes) (default: false)
  --scope <scope>    config|config+creds+sessions|full (default: interactive prompt)
  --yes              Skip confirmation prompts (default: false)

Docs: docs.openclaw.ai/cli/reset

openclaw reset 命令详解

根据你提供的 --help 输出和文档内容，这是一个用于清除本地配置和状态的命令，但不会卸载 CLI 本身。下面逐项解读。

核心用途

当你需要将 OpenClaw 恢复到"干净"状态时使用，比如：

• 配置搞乱了，想重新开始
• 想清除登录凭据或会话记录
• 排查问题时需要重置环境

--scope — 重置范围（最关键的选项）

这是决定"删什么"的参数，有三个级别：

如果省略 --scope，命令会进入交互式提示，让你手动选择要删除哪些内容。

其他选项

--dry-run

openclaw reset --dry-run

只预览，不执行。 它会打印出"如果真执行了会删哪些文件"，但实际上一个文件都不动。适合在正式 reset 前确认影响范围，相当于一个安全检查。

--yes

跳过所有确认提示。默认情况下，执行 reset 会弹出"你确定吗？"的确认，加上 --yes 就直接执行不问了。

--non-interactive

禁用所有交互式提示。但有个硬性前提：必须同时指定 --scope 和 --yes，否则会报错。这个选项主要用于脚本/自动化场景，确保命令不会因为等待用户输入而挂起。

-h, --help

显示帮助信息，就是你执行的那条。

典型用法解读

# 最安全的做法：先备份，再重置
openclaw backup create
openclaw reset

# 只看会删什么，不真删
openclaw reset --dry-run

# CI/CD 脚本中，只重置配置，静默执行
openclaw reset --scope config --yes --non-interactive

# 脚本中清除凭据和会话
openclaw reset --scope config+creds+sessions --yes --non-interactive

# 脚本中彻底重置
openclaw reset --scope full --yes --non-interactive

执行流程逻辑（推断）

根据帮助信息和文档描述，命令的决策流程大致是：

openclaw reset
  │
  ├─ 有 --scope？
  │   ├─ 无 → 进入交互式提示，让用户选择 scope
  │   └─ 有 → 使用指定的 scope
  │
  ├─ 有 --dry-run？
  │   └─ 是 → 仅打印待删除文件列表，然后退出
  │
  ├─ 有 --yes？
  │   ├─ 无 → 显示确认提示，等待用户确认
  │   └─ 有 → 跳过确认
  │
  ├─ 有 --non-interactive？
  │   ├─ 有 → 校验是否同时设置了 --scope 和 --yes
  │   │       ├─ 缺失 → 报错退出
  │   │       └─ 齐全 → 静默执行
  │   └─ 无 → 正常执行（可能有交互提示）
  │
  └─ 执行删除操作

注意事项

1. 务必先备份：文档明确建议在 reset 前运行 openclaw backup create，因为删除后无法通过该命令恢复。
2. CLI 本身不会被卸载：命令只清除配置/状态/凭据，openclaw 命令行工具仍然可用。
3. 脚本中必须三个一起用：--scope + --yes + --non-interactive，缺一不可，这是为了防止自动化脚本意外卡住。

关于源码部分，你提供的 GitHub 链接我无法访问（网页获取失败），以上分析完全基于你贴出的 --help 输出和文档内容。如果你能提供具体的源码片段，我可以进一步解读内部实现逻辑。

--dry-run

执行 openclaw reset --dry-run 指令。

重置范围

执行重置

执行结果：

admin@192 workspace % openclaw reset --dry-run     

🦞 OpenClaw 2026.5.7 (eeef486)
   The only open-source project where the mascot could eat the competition.

│
◇  Reset scope
│  Full reset
│
◇  Proceed with full reset?
│  Yes
Recommended first: openclaw backup create
[dry-run] stop gateway service
[dry-run] remove ~/.openclaw
[dry-run] remove ~/.openclaw/workspace
Next: openclaw onboard --install-daemon

完整的 --dry-run 输出解析

终于看到全貌了。full reset 实际会执行 四步操作：

逐步拆解

[dry-run] stop gateway service        ← 第1步：停止网关服务
[dry-run] remove ~/.openclaw           ← 第2步：删除主配置目录
[dry-run] remove ~/.openclaw/workspace ← 第3步：删除工作区目录

注意第 2 步已经删除了 ~/.openclaw，第 3 步又单独列出 ~/.openclaw/workspace，可能是为了在非 full 模式下单独控制工作区的保留/删除，dry-run 阶段统一列出了所有将被影响的路径。

前后两条建议信息

Recommended first: openclaw backup create   ← 开始前：建议先备份
Next: openclaw onboard --install-daemon     ← 结束后：建议重新初始化

这揭示了完整的重置生命周期：

# 重置前
openclaw backup create          # 1. 备份当前状态

# 执行重置
openclaw reset --scope full --yes  # 2. 清除一切

# 重置后
openclaw onboard --install-daemon  # 3. 重新初始化 + 安装守护进程

openclaw reset 不只是"删文件"，它还会告诉你重置之后该做什么。--install-daemon 说明网关服务是以守护进程形式运行的，reset 停掉了它，需要重新安装。

结合之前的 scope 对比

这正好印证了之前交互界面中 config+creds+sessions 的括号说明 (keeps workspace + auth profiles)。

小结

你现在拿到了完整的 dry-run 预览。如果确认要执行，把 --dry-run 换成正式命令即可：

# 安全做法
openclaw backup create
openclaw reset --scope full --yes
openclaw onboard --install-daemon