openclaw如何恢复误删配置 openclaw配置还原操作方法操作深度解析|Duuu笔记
若误删或损坏~/.openclaw/openclaw.json导致网关无法启动等故障，应立即还原配置：一、从本地备份解压覆盖；二、用openclaw onboard --reset-scope config+creds交互重建；三、用openclaw setup --dry-run生成默认模板并补全模型与token；四、通过trash-list和trash-restore找回刚删除文件。
如果您在使用 OpenClaw 时误删或损坏了关键配置文件（如
~/.
openclaw
/openclaw.json
），导致网关无法启动、模型无法加载或频道配对失败，则需立即执行配置还原操作。以下是多种可验证有效的恢复方法：
一、从本地备份快速还原主配置文件
该方法适用于已执行过手动或自动备份，且备份包中包含完整
openclaw.json
的场景。还原操作不修改工作区或技能数据，安全性高、耗时短。
1、打开终端，确认最近一次备份压缩包是否存在：
ls -lh ~/openclaw_backup/*/config.tar.gz
2、解压最新备份中的配置文件到临时目录：
mkdir -p /tmp/openclaw_restore && tar -xzf $(ls -t ~/openclaw_backup/*/config.tar.gz | head -n1) -C /tmp/openclaw_restore
3、覆盖当前损坏的配置文件：
cp /tmp/openclaw_restore/openclaw.json ~/.openclaw/
4、验证文件权限是否正确：
chmod 600 ~/.openclaw/openclaw.json
二、通过命令行重置向导重建基础配置
该方法适用于无可用备份、但配置结构未被彻底破坏的情况。openclaw onboard 向导可基于现有工作区与技能残留状态，智能跳过已存在项，仅重建缺失或无效的认证、网关与模型段落。
1、执行带重置作用域的交互式初始化：
openclaw onboard --reset-scope config+creds
2、当提示“Existing config detected”时，选择
Modify
而非 Reset，避免清空 workspace
3、按提示重新输入网关端口、绑定地址及令牌模式；若原为令牌认证，建议复用旧令牌值（可从日志或历史命令中检索）
4、在模型配置环节，选择
Custom Provider
并手动填入原 ollama-QwQ-32B 的 Base URL 与模型名称
HyperWrite
AI写作助手帮助你创作内容更自信
下载
三、直接编辑还原默认配置模板
该方法适用于 openclaw.json 完全丢失或内容为空，且无需保留历史自定义字段的紧急恢复。OpenClaw 提供内置默认模板，可作为最小可行配置启动服务。
1、生成默认配置骨架：
openclaw setup --dry-run > ~/.openclaw/openclaw.json
2、手动补全必要字段：使用文本编辑器打开该文件，在
"models"
节点下插入本地模型定义，例如：
{"provider": "ollama", "model": "qwq:32b", "base_url": "http://localhost:11434"}
3、确保
"gateway"
节点中
"auth_mode"
值为
"token"
，并设置有效
"token"
字段（可随机生成 32 位十六进制字符串）
4、保存后执行校验：
openclaw doctor --fix
四、利用 trash 命令找回刚删除的配置文件
该方法适用于在终端中执行 rm 命令误删 openclaw.json 后尚未清空系统回收站（trash）的情形。OpenClaw 默认使用系统 trash 工具而非直接 unlink，因此文件仍可检索。
1、列出最近被 trash 的文件：
trash-list | grep openclaw.json
2、若找到匹配项，记录其原始路径（如 /home/user/.openclaw/openclaw.json）
3、执行恢复：
trash-restore
匹配编号
4、检查恢复后文件完整性：
jq -e '.auth.profiles | keys' ~/.openclaw/openclaw.json >/dev/null
