机缘

配置环境变量（最关键一步）
这一步能确保新程序的所有数据都写到 D 盘，避免占用 C 盘空间。

右键“此电脑” → “属性” → “高级系统设置” → “环境变量”。

在“系统变量”区域新建以下变量：

变量名 建议值 作用说明
OPENCLAW_STATE_DIR D:\OpenClawData 最重要，覆盖默认数据目录
OPENCLAW_WORKSPACE D:\OpenClawData\workspace 指定工作区目录
💡 可选的其他变量：
也可按需添加 OPENCLAW_HOME（D:\OpenClawData）、OPENCLAW_CONFIG_PATH（D:\OpenClawData\openclaw.json）或在终端临时设置 $env:OPENCLAW_HOME。

设置完成后重启电脑，确保变量生效。

**

💡 最佳实践提醒 每当更换电脑或操作系统，建议先通过环境变量锁定数据路径，再安装或首次运行 OpenClaw，这样所有数据都会直接生成在指定位置，免去后续迁移。

**

OpenClaw 迁移至 D 盘操作指南

好的，以下是根据您的要求整理后的清理步骤，采用清晰的结构化格式：

---

清理 OpenClaw 安装残留的完整步骤

1. 卸载全局包

打开 命令提示符 或 PowerShell（无需管理员权限），依次执行：

npm uninstall -g openclaw

若系统安装了 Yarn，需额外执行：

yarn global remove openclaw

---

2. 强制清除全局模块残留

在 PowerShell 中执行：

Remove-Item -Recurse -Force "$env:APPDATA\npm\node_modules\openclaw" -ErrorAction SilentlyContinue

---

3. 删除用户数据目录

在 PowerShell 中执行：

Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw" -ErrorAction SilentlyContinue

注意：若需保留旧数据，请提前备份至其他位置（如 D 盘）。

---

4. 清理快捷方式与缓存

• 手动操作：
  删除桌面、开始菜单中的 OpenClaw 快捷方式。
• 清理临时文件（PowerShell 执行）：

  Remove-Item -Recurse -Force "$env:TEMP\openclaw*" -ErrorAction SilentlyContinue
  Remove-Item -Recurse -Force "$env:LOCALAPPDATA\Temp\openclaw*" -ErrorAction SilentlyContinue
  

---

5. 补充说明

若曾通过安装程序（.exe）安装过 OpenClaw：

1. 前往 设置 → 应用 确认卸载；
2. 手动删除以下目录中的残留文件夹：
   • C:\Program Files\OpenClaw
   • C:\Program Files (x86)\OpenClaw

---

完成以上步骤后，C 盘残留已彻底清除，可进行全新安装。

OpenClaw 迁移至 D 盘操作指南

第一步：安装程序本体

1. 在命令行执行以下命令（确保已安装 Node.js）：

   npm install -g openclaw --prefix D:\OpenClaw
   

2. 若需初始化，运行：

   openclaw onboard --install-daemon
   

---

第二步：配置环境变量

1. 右键“此电脑” → “属性” → “高级系统设置” → “环境变量”。
2. 在 系统变量 中新建以下变量：

   变量名	建议值	作用说明
   OPENCLAW_STATE_DIR	D:\OpenClawData	核心数据存储目录
   OPENCLAW_WORKSPACE	D:\OpenClawData\workspace	工作区目录

3. 可选 按需添加：
   • OPENCLAW_HOME=D:\OpenClawData
   • OPENCLAW_CONFIG_PATH=D:\OpenClawData\openclaw.json
4. 重启电脑使配置生效。

---

第三步：恢复旧数据

1. 解压与定位
   • 若旧数据为压缩包（如 openclaw-state.tgz），解压至 D:\OpenClawData\。
   • 若旧数据已在 D:\OpenClawData，检查根目录是否包含：
     • openclaw.json（主配置）
     • agents/（智能体配置）
     • workspace/（工作区文件）
     • credentials/（凭证文件）
2. 创建符号链接
   以管理员身份运行 PowerShell：

   New-Item -ItemType Junction -Path "$env:USERPROFILE\.openclaw" -Target "D:\OpenClawData"
   

---

第四步：验证与清理

1. 验证状态

   openclaw doctor      # 检查并修复问题
   openclaw restart     # 重启网关
   openclaw status      # 确认状态为 "running"
   

2. 目录结构

   D:\OpenClaw\        ← 软件本体
   D:\OpenClawData\    ← 全部数据
   C:\Users\[用户名]\.openclaw → 指向 D:\OpenClawData 的符号链接
   

3. 清理冗余文件
   删除 C:\Users\[用户名]\.openclaw 的旧数据及 D:\OpenClawData 中的临时文件（如 workspace.tar.gz）。

---

常见问题排查

• 环境变量未生效
  重启电脑或在新终端会话中测试。
• 数据异常
  检查 D:\OpenClawData\agents 下的配置文件完整性，必要时重新配置密钥。
• 权限问题
  为 D:\OpenClawData 授予当前用户 完全控制权。
• 网关启动失败
  卸载后重装网关组件：

  openclaw uninstall-gateway
  openclaw install-gateway
  

---

核心操作总结

1. 安装：通过 npm 指定安装路径至 D:\OpenClaw。
2. 定向：设置环境变量 OPENCLAW_STATE_DIR 指向 D:\OpenClawData。
3. 链接：创建符号链接将默认访问路径重定向至 D 盘数据目录。