← Back to Skills Marketplace
200
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install workspace-manage
Description
用于管理和维护 OpenClaw 工作区的结构。当用户提到工作区混乱、需要整理文件夹、或者希望建立标准目录结构时使用。提供自动归档、分类、清理和健康审计功能。
Usage Guidance
Before installing or running this skill: (1) Inspect the scripts locally and back up your ~/.openclaw/workspace directory. (2) Run pipeline.sh with --dry-run (or call the individual scripts in preview mode) to see proposed changes; do not rely on SKILL.md's assertion of default dry-run because pipeline.sh will run cleanup with --execute by default unless you pass --dry-run. (3) Be aware the sync step can upload files to Google Drive if you have the 'gog' CLI installed and authenticated — disable or review config/sync-config.json if you don't want uploads. (4) Ensure required helper tools (trash-put, gog, jq) are intentionally installed or remove calls to them; trash-put is used for safe deletion fallback. (5) Consider running the skill on a test workspace first and verify config/patterns.json protected paths include any sensitive locations. If you want this skill but prefer safer defaults, change pipeline.sh to default to dry-run and set sync_human/sync_agent to false in config/sync-config.json.
Capability Analysis
Type: OpenClaw Skill
Name: workspace-manage
Version: 1.0.0
The workspace-manager skill bundle is a legitimate utility designed to organize and maintain the OpenClaw environment. It utilizes a series of shell and Python scripts (e.g., scripts/organize.sh, scripts/cleanup.py) to categorize files, perform health audits, and safely remove temporary data using the system trash. While it includes a cloud synchronization feature (scripts/sync.sh) that can upload workspace data to Google Drive, this functionality is explicitly documented, requires the user to manually install and authenticate the 'gog' CLI, and is disabled by default for sensitive agent directories. The code follows security best practices, such as using dry-run modes, protecting core configuration files (MEMORY.md, SOUL.md), and avoiding destructive 'rm' commands.
Capability Assessment
Purpose & Capability
The name/description align with the bundled scripts: organize, audit, cleanup, archive and optional cloud sync. However the package does not declare binaries it actually uses (e.g., trash-put, gog, jq) in metadata, which is an omission and reduces clarity about required runtime tools.
Instruction Scope
SKILL.md instructs the agent to run the included scripts (good), but there is a behavioral mismatch: SKILL.md emphasizes 'default dry-run' for destructive operations, yet pipeline.sh will call cleanup.py with --execute by default (i.e., perform deletions) unless the user explicitly supplies --dry-run. The scripts traverse and modify the entire workspace path (~/.openclaw/workspace by default) and can move/delete (via trash) many files; archive.sh and cleanup.py prompt for confirmation but pipeline may invoke them non-interactively. The sync step can upload workspace files to Google Drive if 'gog' is installed and authenticated.
Install Mechanism
No install spec (instruction-only) — lowest install risk. Files are shipped as scripts (no remote downloads). No install-time network fetches or extract operations were found.
Credentials
The skill requests no environment variables or declared credentials, yet sync.sh can upload data to Google Drive using the gog CLI (requires user authentication outside the skill). The scripts also call external tools (trash-put, jq) without declaring them. The optional sync defaults (sync_human: true) would upload Workspace_Human content if 'gog' is present and authenticated, which may include sensitive files unless the user configures sync-config.json carefully.
Persistence & Privilege
always:false and no attempt to modify other skills or system-wide agent settings. The skill creates/changes files only under the workspace directory and writes logs there — expected behavior for a workspace manager.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install workspace-manage - After installation, invoke the skill by name or use
/workspace-manage - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
## [1.0.0] - 2026-03-19
### Added
- SKILL.md — Complete skill with Pipeline + Tool Wrapper design patterns
- 标准目录结构 — 双 workspace 架构：
- Workspace_Human/ — 人类文件（input, output, backup, temp）
- Workspace_Agent/ — Agent 文件（memory, skills, subagents, shared_context, artifacts, cache, logs, skills_custom, prompts, kb）
- Pipeline 总控 (pipeline.sh) — 5 步流水线：Audit → Organize → Clean → Archive → Sync，支持 --all / --dry-run / 单步选择
- 健康审计 (health-check.sh) — 0-100 健康评分：断链、空目录、大文件、畸形命名检测
- 规范化 (standardize.sh) — 确保标准目录完整，检测根目录散落文件
- 整理 (organize.sh) — 将 artifacts/ 文件自动分类到 Workspace_Human/output/
- 清理 (cleanup.py) — 安全清理，默认 dry-run，用 trash-put 代替 rm
- 归档 (archive.sh) — 交互式归档，按 YYYY-MM/ 组织
- 同步 (sync.sh) — 可选扩展，通过 gog CLI 同步到 Google Drive，未安装则自动跳过
- 配置文件 (patterns.json, sync-config.json)
### 安全特性
- 所有删除操作通过 trash-put 完成（可恢复）
- 默认 dry-run 模式
- 核心配置文件和 Workspace_Human/ 受保护永不删除
Metadata
Frequently Asked Questions
What is workspace-manager?
用于管理和维护 OpenClaw 工作区的结构。当用户提到工作区混乱、需要整理文件夹、或者希望建立标准目录结构时使用。提供自动归档、分类、清理和健康审计功能。 It is an AI Agent Skill for Claude Code / OpenClaw, with 200 downloads so far.
How do I install workspace-manager?
Run "/install workspace-manage" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is workspace-manager free?
Yes, workspace-manager is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does workspace-manager support?
workspace-manager is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created workspace-manager?
It is built and maintained by musenlinc (@mslchy); the current version is v1.0.0.
More Skills