clawfile

Brewfile-style skill management for OpenClaw + ClawHub.

Install

npm i -g clawfile

Getting started in 60 seconds

1. Create a Clawfile:

registry https://clawhub.ai
workdir /Users/<you>/.openclaw/workspace

weather
apple-reminders
github
https://clawhub.ai/ivangdavila/self-improving

2. Preview actions:

clawfile install Clawfile --dry-run

3. Apply:

clawfile install Clawfile

That’s it. Clawfile.lock is written automatically after non-dry runs.

Prerequisite (clawhub)

clawfile shells out to the ClawHub CLI.

If clawhub is missing, clawfile prompts to install:

`clawhub` is missing. Install now with `npm i -g clawhub`? [Y/n]

Manual install:

npm i -g clawhub

Under the hood:

clawhub install <skill-slug>
clawhub install <skill-slug> --version <version>

Clawfile format

registry https://clawhub.ai
workdir /Users/<you>/.openclaw/workspace

weather
[email protected]
ivangdavila/self-improving
https://clawhub.ai/ivangdavila/self-improving

• skill => latest
• [email protected] => pinned version
• owner/skill and full ClawHub URLs are supported

Commands

clawfile sync Clawfile
clawfile install Clawfile
clawfile update Clawfile

update mode is smart:

• local installed version from clawhub list
• remote latest version from clawhub inspect <slug>
• skills already on latest are skipped automatically

Flags

• --lock <path>: lockfile path (default: Clawfile.lock)
• --dry-run: print actions only
• --strict: stop on first failure
• --continue-on-error: continue and report failures at end
• --refresh-lock: ignore existing lock pins during install
• --force: pass through force reinstall/update to clawhub (--force)

Notes

• lockfile is written after non-dry runs