人工智能AI Agent即时通讯后端本地部署语音【免费下载链接】openclaw-cn中文社区版OpenClaw同原版保持定期更新已内置钉钉、企业微信、飞书、QQ、微信以及国内网络环境优化。你的专属个人AI助手。支持所有操作系统和平台。项目地址https://gitcode.com/gh_mirrors/op/openclaw-cn点击查看免费下载导读clawdbot reset中文社区版 OpenClaw-cn 亦提供openclaw-cn reset是一条用于重置本地配置与运行时状态、但保留 CLI 本体安装的维护命令适合在网关异常、配置损坏、需要清除凭据与会话或希望彻底回到出厂状态重新引导时使用。读完本文你将掌握 reset 的三种重置范围config/configcredssessions/full、交互式与全自动非交互式用法、--dry-run预演机制以及命令底层对路径安全、网关服务停止和旧版目录兼容的具体实现原理。何时需要执行 resetreset面向想清空本地状态但继续使用 CLI的场景与uninstall卸载网关服务与数据、进一步移除 CLI形成两级维护手段。典型使用场景包括配置损坏或想重新开始openclaw.json中的网关、渠道或模型配置已不可恢复希望删掉后通过onboard重新初始化凭据失效或泄漏OAuth 令牌oauth.json需要清除强制重新授权会话数据清理各 Agent 的会话记录占用了本地磁盘需要删除以获得干净的上下文迁移前清理从旧版本.clawdbot/.moltbot/.moldbot目录结构向新目录迁移之前清空遗留数据。与原文档一致reset 的核心承诺是只清数据、不动 CLI重置完成后CLI 可执行文件、npm 包或安装目录都不会被移除你仍然可以立即运行onboard重新配置。基础用法与命令参数原文档给出的三行命令即覆盖了 reset 的核心用法clawdbot reset clawdbot reset --dry-run clawdbot reset --scope configcredssessions --yes --non-interactive第一行以交互式向导运行第二行只打印将要执行的操作而不真正删除第三行则跳过一切提示在脚本/CI 中全自动执行。在 src/cli/program/register.maintenance.ts 中reset子命令被注册在维护命令组下与doctor、dashboard、uninstall并列完整参数如下参数取值说明默认值--scope scopeconfig、configcredssessions、full界面亦显示中文别名配置 / 配置凭据会话 / 全部重置范围交互式运行时弹出选择器默认选中configcredssessions非交互式运行时必须显式传入--yes布尔开关跳过删除前的确认提示false--non-interactive布尔开关禁用所有提示必须与--yes配合且--scope也必须显式给出false--dry-run布尔开关只打印将要执行的操作不删除任何文件false从 src/commands/reset.ts 可以看到非交互模式有两条硬性校验缺少--yes时直接报错Non-interactive mode requires --yes.并以退出码 1 结束缺少--scope时报错Non-interactive mode requires --scope.。这是为了杜绝脚本环境中的静默误删任何自动化调用都必须显式声明范围并确认。三种重置范围scope的含义ResetScope在 src/commands/reset.ts 中被定义为config | configcredssessions | full三种取值删除对象逐级扩大1.config仅配置只删除当前生效的配置文件默认~/.openclaw/openclaw.json其余一切保留。执行后立即返回不再提示后续步骤。适合只想丢弃配置、保留会话与凭据的场景。2.configcredssessions配置 凭据 会话推荐默认依次删除配置文件openclaw.json及其旧名clawdbot.json/moltbot.json/moldbot.json中的当前生效者OAuth 凭据目录默认~/.openclaw/credentials内含oauth.json所有 Agent 的会话目录——listAgentSessionDirs 会扫描状态目录下的agents/*/sessions子目录并逐一删除。该范围保留工作区workspace目录与认证档案auth profiles删除后命令会提示下一步openclaw-cn onboard --install-daemon。这是交互式向导的默认选择也是绝大多数重新来过场景的最优解。3.full完整重置删除最彻底包括整个状态目录默认~/.openclaw含会话、日志、缓存若配置文件不在状态目录内例如通过OPENCLAW_CONFIG_PATH指向了别处则额外删除该配置文件若凭据目录不在状态目录内例如通过OPENCLAW_OAUTH_DIR自定义则额外删除凭据目录所有工作区目录——collectWorkspaceDirs 会收集agents.defaults.workspace、每个agents.list条目的workspace若两者皆未配置则回退到默认 Agent 工作区目录。full之后同样提示执行openclaw-cn onboard --install-daemon重新引导。值得注意的细节是full范围通过 isPathWithin 判断配置与凭据是否已包含在状态目录内避免重复删除而configcredssessions范围则不做此判断始终显式删除这三类对象因此它比full更精准不碰工作区但比config更彻底清凭据与会话。交互式流程与脚本化非交互式流程交互式默认未加--non-interactive时reset 分两步引导范围选择器若未通过--scope指定使用 clack/prompts按Esc/CtrlC取消时打印Reset cancelled.并以退出码 0 正常结束确认提示删除前再次用确认组件询问Proceed with scope reset?取消同样安全退出见 src/commands/reset.ts。非交互式脚本/CIclawdbot reset --scope full --yes --non-interactive三个要素缺一不可显式--scope、--yes、--non-interactive。这种写法确保无人值守环境下不会出现卡在提示或未经确认即删除两种极端。原文档中的--scope configcredssessions --yes --non-interactive即为此类标准形态。干跑模式--dry-run--dry-run适用于任何范围。删除动作在 removePath 中统一处理干跑时只打印[dry-run] remove 路径真实执行时调用fs.rm(target, { recursive: true, force: true })并打印Removed 路径。干跑模式下连停止网关服务这一前置动作也只会打印[dry-run] stop gateway service见 src/commands/reset.ts因此你可以放心先预演一遍完整删除清单再决定是否真正执行。底层实现原理路径解析与安全防护目标路径如何确定reset 要删除的路径全部来自 src/config/paths.ts 的解析逻辑并支持环境变量覆盖状态目录默认~/.openclaw新目录若不存在则回退探测旧目录~/.clawdbot、~/.moltbot、~/.moldbot可用OPENCLAW_STATE_DIR旧名CLAWDBOT_STATE_DIR覆盖resolveStateDir配置文件默认$STATE_DIR/openclaw.json兼容旧名clawdbot.json/moltbot.json/moldbot.json可用OPENCLAW_CONFIG_PATH覆盖resolveConfigPath凭据目录默认$STATE_DIR/credentials可用OPENCLAW_OAUTH_DIR覆盖resolveOAuthDir。这套解析同时照顾了中文社区版与上游旧版的目录命名是重置总能找到正确目标的根基。拒绝删除危险路径removePath 内置了 isUnsafeRemovalTarget 防护当目标路径是文件系统根目录如/或用户主目录时命令会拒绝执行并打印Refusing to remove unsafe path: 路径。结合环境变量可能把状态目录指向任意位置这道防线防止了极端误配下把整个家目录删掉的灾难。删除前自动停止网关服务当范围不是config即会删除状态/凭据时reset 会先停止正在运行的网关服务stopGatewayIfRunning先通过isLoaded()探测服务是否已加载避免对未运行的服务做无谓操作已加载则调用stop()停止。网关服务的实现是平台自适应的见 src/daemon/service.tsmacOS 使用 LaunchAgentLinux 使用 systemdWindows 使用计划任务Scheduled Task。另外当环境变量OPENCLAW_NIX_MODE1Nix 模式时网关服务由外部管理reset 会跳过停止网关的步骤见 src/commands/reset.ts。先停服务再删文件是为了避免正在运行的网关进程继续向已被删除的会话/凭据文件写入防止边删边写造成数据残留或进程异常。重置后的下一步重新引导无论是configcredssessions还是fullreset 完成后都会提示执行openclaw-cn onboard --install-daemononboard命令注册于 src/cli/program/register.onboard.ts其中--install-daemon以及相反的--no-install-daemon用于决定是否顺带安装网关系统服务src/cli/program/register.onboard.ts。也就是说reset 清空的是历史状态而 onboard 负责从零重建——重新生成配置文件、完成设备配对/认证并按需把网关安装回系统服务。这条reset → onboard的组合拳正是把一台状态混乱的 OpenClaw-cn 恢复为可用状态的标准恢复路径。与 uninstall 的边界reset 与 uninstall 的取舍reset 常与uninstall混淆二者在 src/cli/program/register.maintenance.ts 中同组注册但职责分明reset只清配置/状态/凭据/会话/工作区CLI 本体与可执行文件原样保留重置后可立即onboard重建uninstall通过--service、--state、--workspace、--app、--all分别卸载网关服务、删除状态与配置、删除工作区目录、删除 macOS 应用并可组合出完全移除同样支持--yes、--non-interactive、--dry-run。一句话总结想继续用 CLI 就选reset想彻底离开就选uninstall。二者都内置干跑模式与安全路径防护可在执行前完整预演适合在生产或长期运行的设备上放心维护本地数据。小结clawdbot reset/openclaw-cn reset是 OpenClaw-cn 维护命令组中最常用的软重置工具三种 scope 覆盖从只清配置到连工作区一起清空的粒度需求--dry-run、--yes、--non-interactive组合让它在交互终端和无人值守脚本中同样安全底层路径解析兼容新旧目录与环境变量覆盖配合拒绝删除根目录/主目录的防线与删除前自动停止网关服务的流程保证了操作的可预测性。掌握reset与onboard --install-daemon的配合你就能在任何时候把本地实例干净、可控地恢复到初始可用状态。赞分享人工智能AI Agent即时通讯后端本地部署语音【免费下载链接】openclaw-cn中文社区版OpenClaw同原版保持定期更新已内置钉钉、企业微信、飞书、QQ、微信以及国内网络环境优化。你的专属个人AI助手。支持所有操作系统和平台。项目地址https://gitcode.com/gh_mirrors/op/openclaw-cn点击查看免费下载相关推荐OpenClaw openclaw uninstall 命令全解安全卸载 Gateway 服务与本地状态数据OpenClaw openclaw uninstall 命令全解安全卸载 Gateway 服务与本地状态数据 本文围绕 openclaw uninstallAI 应用AI Agent交互助手后端即时通讯网关OpenClaw goplaces 技能实战Google Places API CLI 的安装、配置与查询命令全解OpenClaw goplaces 技能实战Google Places API CLI 的安装、配置与查询命令全解 OpenClaw 以「技能Skill」AI 应用AI Agent交互助手后端即时通讯网关MoviePilot CLI 完全指南本地源码模式的一体化安装、配置与运维命令手册MoviePilot CLI 完全指南本地源码模式的一体化安装、配置与运维命令手册 MoviePilot 是 NAS 媒体库自动化管理工具。 moviepil后端AI AgentMCP 服务AI 技能上一篇OpenJSCAD.org社区生态全面介绍从论坛到开源贡献的完整路径下一篇MixedQuantSparseFlashMlaMetadata 算子解析CANN ops-transformer 中混合量化稀疏 MLA 的 AI CPU 负载均衡前置算子创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考