SkillHub

openclaw-workspace-doctor

v1.0.0

检测并修复OpenClaw工作目录嵌套问题

Sourced from ClawHub, Authored by maxkandel99-arch

Installation

Please help me install the skill `openclaw-workspace-doctor` from SkillHub official store. npx skills add maxkandel99-arch/openclaw-workspace-doctor

检测并修复OpenClaw工作目录嵌套问题。

触发条件

用户提到以下任意关键词时激活： - 工作目录异常 - 嵌套目录 - .openclawworkspace - workspace问题 - 路径错误 - openclaw doctor - openclaw init - 工作目录健康 - 工作目录医生

功能

1. 检测嵌套目录

扫描 .openclawworkspace 递归嵌套目录

2. 校验工作目录

  • 检查配置文件中的工作目录
  • 检查当前工作目录
  • 验证路径有效性

3. 修复功能（需用户确认）

  • 删除嵌套目录
  • 修复配置文件中的工作目录路径
  • 支持演练模式（DryRun）

使用方法

方式一：在线使用（推荐）

  1. 访问 GitHub 仓库获取脚本： https://github.com/maxkandel99-arch/workspace-health

  2. 下载 scripts 目录下的脚本：

  3. detect-nested-workspace.ps1
  4. validate-workspace.ps1

  5. fix-nested-workspace.ps1

  6. 运行检测：

.detect-nested-workspace.ps1
.validate-workspace.ps1
.fix-nested-workspace.ps1 -DryRun:$true  # 演练模式

方式二：直接询问

直接告诉AI你的问题，如： - "我的OpenClaw工作目录好像出问题了" - "检测一下工作目录健康"

AI会引导你完成诊断和修复。

安全说明

  • 修复操作前默认使用演练模式
  • 删除操作前会提示用户确认
  • 建议修复前备份配置文件
  • 修复后需要重启OpenClaw Gateway

常见问题

Q: 什么是嵌套目录？ A: 当OpenClaw的工作目录路径指向另一层workspace时，会形成嵌套，可能导致配置读取错误。

Q: 如何判断是否需要修复？ A: 运行 validate-workspace.ps1 脚本，它会检测并报告问题。