CHIS / CHISF

A lightweight skill to standardize how we install/manage OpenClaw skills.

Core idea

• chis [workdir] [version] = install a skill from ClawHub.
• chisf [workdir] [version] = force-install when the package is flagged/requires overwrite.
• clawhub inspect = inspect before install (recommended for validation).
• Always run installs with explicit workdir and skills dir to avoid path confusion.

Default workdir in examples: /Users/zququ/.openclaw/workspace.

Default command mapping

1) Standard install

clawhub install <slug> --workdir /Users/zququ/.openclaw/workspace --dir skills --version <version>

• Omit --version for latest.
• If no version argument, installs latest available.

2) Force install

clawhub install <slug> --force --workdir /Users/zququ/.openclaw/workspace --dir skills --version <version>

Use this when:

• package is flagged as suspicious
• overwrite behavior is required

3) Inspect before install (recommended)

clawhub inspect <slug>

4) Verify

clawhub list --workdir /Users/zququ/.openclaw/workspace --dir skills

CHIS aliases

Use these shortcuts in practice:

• chis → same as standard install in default workspace.
• chisf → same as force install in default workspace.
• If needed, set your session path context and explicitly pass an alternate path:
• chis --workdir /alt/path
• chisf --workdir /alt/path

Failure handling

1. If Rate limit exceeded: retry after a few minutes.
2. If command fails due to path mismatch: ensure you are checking with same --workdir and --dir skills used during install.
3. If package not found: confirm correct slug via clawhub search .

Safe defaults for this environment

• Use:
• --workdir /Users/zququ/.openclaw/workspace
• --dir skills

• Already-known working example:

clawhub install proactive-agent --force --workdir /Users/zququ/.openclaw/workspace --dir skills

Notes

• CHISF is a human-facing label I use for force-install style operations.
• Keep all install actions explicit and repeatable; never rely on default working dir.
• Failure handling
• If install fails, run clawhub inspect --workdir /Users/zququ/.openclaw/workspace --dir skills for a quick pre-check.
• If it still fails due to environment mismatch, re-run with explicit --workdir /Users/zququ/.openclaw/workspace and --dir skills (never rely on implicit defaults).
• For suspected API/service issues (e.g., rate limit exceeded), prefer 10–20 minute pause and retry.
• If rate limit persists, use the local fallback installer: /Users/zququ/.local/bin/clawhub-install-safe --force (or without --force when not needed) before switching to another approach.
• Keep the same --workdir and --dir skills/registry context when re-running.