openclaw - 💡(How to fix) Fix [Bug]: openclaw skills install --force --version does not fully replace existing workspace skill [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openclaw/openclaw#60699Fetched 2026-04-08 02:48:11
View on GitHub
Comments
0
Participants
1
Timeline
0
Reactions
0
Participants

Code Example

openclaw skills install <slug> --version <new-version> --force

---

openclaw skills install claude-to-free --version 1.0.5 --force

---

clawhub inspect claude-to-free --version 1.0.2 --file SKILL.md
clawhub inspect claude-to-free --version 1.0.5 --file SKILL.md
RAW_BUFFERClick to expand / collapse

When a skill already exists under workspace/skills/<slug>, running:

openclaw skills install <slug> --version <new-version> --force

does not fully refresh the local install.

Repro

  1. Have an existing installed skill in workspace/skills/claude-to-free/
  2. Run:
openclaw skills install claude-to-free --version 1.0.5 --force
  1. Inspect:
    • workspace/skills/claude-to-free/_meta.json
    • workspace/skills/claude-to-free/.clawhub/origin.json
    • workspace/skills/claude-to-free/SKILL.md

Expected

  • existing install is fully replaced
  • _meta.json shows 1.0.5
  • .clawhub/origin.json shows installedVersion: 1.0.5
  • installed files match 1.0.5

Actual

  • local metadata stayed on the older version (1.0.2)
  • file content could still reflect newer changes
  • result is an internally inconsistent local install

Control checks

These worked correctly:

clawhub inspect claude-to-free --version 1.0.2 --file SKILL.md
clawhub inspect claude-to-free --version 1.0.5 --file SKILL.md

Clean installs into fresh temp dirs also respected the requested version.

So this looks like an OpenClaw workspace install/update issue, not a registry/version-selection issue.

Why it matters

Users can think they installed one version while local metadata still reports another. Debugging gets confusing fast.

extent analysis

TL;DR

The issue can be mitigated by manually updating the local metadata files after running the openclaw skills install command with the --force flag.

Guidance

  • Verify that the --force flag is correctly updating the skill files, but not the metadata, by checking the file contents and metadata versions after running the command.
  • Manually update the _meta.json and .clawhub/origin.json files to reflect the new version number (1.0.5 in this case) after installation.
  • Consider adding a step to the openclaw skills install process to automatically update the local metadata files when the --force flag is used.
  • Check the OpenClaw documentation to see if there are any known issues or workarounds for this problem.

Example

# Manually update the metadata files after installation
openclaw skills install claude-to-free --version 1.0.5 --force
# Update _meta.json
jq '.version = "1.0.5"' workspace/skills/claude-to-free/_meta.json > temp.json && mv temp.json workspace/skills/claude-to-free/_meta.json
# Update .clawhub/origin.json
jq '.installedVersion = "1.0.5"' workspace/skills/claude-to-free/.clawhub/origin.json > temp.json && mv temp.json workspace/skills/claude-to-free/.clawhub/origin.json

Notes

This workaround assumes that the issue is specific to the openclaw skills install command and not a more general problem with the OpenClaw workspace or registry.

Recommendation

Apply workaround: manually update the local metadata files after running the openclaw skills install command with the --force flag, as this will ensure that the local install is consistent with the expected version.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING