Skip to content

feat: add OpenClaw platform support#438

Open
ProgramCaiCai wants to merge 1 commit intoobra:mainfrom
ProgramCaiCai:feat/openclaw-support
Open

feat: add OpenClaw platform support#438
ProgramCaiCai wants to merge 1 commit intoobra:mainfrom
ProgramCaiCai:feat/openclaw-support

Conversation

@ProgramCaiCai
Copy link

@ProgramCaiCai ProgramCaiCai commented Feb 8, 2026

Summary

This PR adds OpenClaw platform support for obra/superpowers by introducing an OpenClaw-specific installation entrypoint and documentation.

Scope

  • Added .openclaw/INSTALL.md with OpenClaw install instructions and an automated install script (clone + symlink/copy into OpenClaw workspace skills/).
  • Added docs/README.openclaw.md with full OpenClaw usage and platform-specific behavior notes.
  • Updated README.md Installation section to include OpenClaw alongside Codex and OpenCode.
  • Did not modify any existing skill content under skills/.

About OpenClaw

OpenClaw is a local-first assistant runtime with native tools, skill discovery, and session orchestration. It is designed to run agentic workflows with explicit control and can be used across desktop/server environments.

Testing

Validated in an OpenClaw environment that 13 superpowers skills can be discovered, loaded, and triggered via the OpenClaw skill system.

Summary by CodeRabbit

  • Documentation
    • Added comprehensive OpenClaw integration documentation with installation workflows, skill discovery, and troubleshooting guides.
    • Introduced detailed reference guide covering OpenClaw concepts, YAML configuration for skills, and update procedures.
    • Updated README with OpenClaw integration section and links to dedicated documentation.

@coderabbitai
Copy link

coderabbitai bot commented Feb 8, 2026

📝 Walkthrough

Walkthrough

Three documentation files added to introduce OpenClaw integration for Superpowers. Includes installation workflow, setup instructions, comprehensive usage guide, and a README reference link. No code or logic changes.

Changes

Cohort / File(s) Summary
OpenClaw Documentation
.openclaw/INSTALL.md, docs/README.openclaw.md
New installation workflow and comprehensive usage guide for integrating Superpowers into OpenClaw. Covers prerequisites, installation methods (symlink vs. copy), skill discovery, YAML frontmatter configuration, updating, troubleshooting, and verification steps.
README Integration
README.md
Added OpenClaw integration section with usage snippet and link to detailed installation documentation, mirroring existing integration patterns.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Poem

🐰 A burrow of docs now stands so tall,
OpenClaw skills answer the call,
Install with ease, symlink or clone,
Our Superpowers now find their home! ✨

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately describes the main change: adding OpenClaw platform support through new documentation and installation guidance.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Fix all issues with AI agents
In `@docs/README.openclaw.md`:
- Around line 13-15: The install instruction currently fetches from an unpinned
ref "refs/heads/main"; update the quick-install URL in the README.openclaw.md to
reference a specific, versioned ref (a released tag or commit SHA) instead of
"refs/heads/main" so installs are reproducible and avoid unreviewed
changes—replace the URL string
"https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.openclaw/INSTALL.md"
with one that uses a concrete tag or commit SHA and add a short note beside it
indicating the chosen tag/sha and how to update it for newer releases.

In `@README.md`:
- Around line 69-77: Update the OpenClaw install instruction to reference a
specific release tag or commit SHA instead of the mutable refs/heads/main URL;
locate the README section under the "OpenClaw" heading and replace the fetch URL
string
"https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.openclaw/INSTALL.md"
with a versioned URL that includes either a release tag (e.g., refs/tags/vX.Y.Z)
or a commit SHA so the INSTALL.md fetched is immutable and reproducible.
🧹 Nitpick comments (1)
.openclaw/INSTALL.md (1)

30-32: Add a safety guard before rm -rf.

Since this is a copy-paste script, it’s worth preventing accidental deletes if variables are empty or altered.

🔒 Safer shell guard
 mkdir -p "$WORKSPACE_SKILLS_DIR"
-rm -rf "$TARGET_DIR"
+case "$TARGET_DIR" in
+  "$WORKSPACE_SKILLS_DIR"/*) rm -rf "$TARGET_DIR" ;;
+  *) echo "Refusing to remove unexpected path: $TARGET_DIR" >&2; exit 1 ;;
+esac

Comment on lines +13 to +15
```
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.openclaw/INSTALL.md
```
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

Prefer a versioned install URL instead of main.

Using refs/heads/main makes the instructions non-reproducible and exposes users to unreviewed changes. Use a tag/commit SHA in the quick-install snippet.

✅ Suggested doc tweak
-Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.openclaw/INSTALL.md
+Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/tags/<release>/.openclaw/INSTALL.md
🤖 Prompt for AI Agents
In `@docs/README.openclaw.md` around lines 13 - 15, The install instruction
currently fetches from an unpinned ref "refs/heads/main"; update the
quick-install URL in the README.openclaw.md to reference a specific, versioned
ref (a released tag or commit SHA) instead of "refs/heads/main" so installs are
reproducible and avoid unreviewed changes—replace the URL string
"https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.openclaw/INSTALL.md"
with one that uses a concrete tag or commit SHA and add a short note beside it
indicating the chosen tag/sha and how to update it for newer releases.

Comment on lines +69 to +77
### OpenClaw

Tell OpenClaw:

```
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.openclaw/INSTALL.md
```

**Detailed docs:** [docs/README.openclaw.md](docs/README.openclaw.md)
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

Pin the install instructions to a release tag/commit.

The fetch URL points at refs/heads/main, which can change over time and weakens reproducibility/security. Prefer a versioned tag or commit SHA in the docs, then update the tag as part of releases.

✅ Suggested doc tweak
-Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.openclaw/INSTALL.md
+Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/tags/<release>/.openclaw/INSTALL.md
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
### OpenClaw
Tell OpenClaw:
```
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.openclaw/INSTALL.md
```
**Detailed docs:** [docs/README.openclaw.md](docs/README.openclaw.md)
### OpenClaw
Tell OpenClaw:
🤖 Prompt for AI Agents
In `@README.md` around lines 69 - 77, Update the OpenClaw install instruction to
reference a specific release tag or commit SHA instead of the mutable
refs/heads/main URL; locate the README section under the "OpenClaw" heading and
replace the fetch URL string
"https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.openclaw/INSTALL.md"
with a versioned URL that includes either a release tag (e.g., refs/tags/vX.Y.Z)
or a commit SHA so the INSTALL.md fetched is immutable and reproducible.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants