w4ngyu/openclaw-superpowers
GitHub: w4ngyu/openclaw-superpowers
将 Claude Code Superpowers 技能集成为 OpenClaw 原生插件,提供自动/手动技能选择与上下文注入能力。
Stars: 1 | Forks: 0
# openclaw-superpowers(OpenClaw 插件版 Superpowers)
把 **Claude Code Superpowers** 以 **OpenClaw 原生插件**的方式接入:
- 自动:根据你的提问自动选择合适的 workflow skill,并(可选)把对应 `SKILL.md` 注入到本次运行 的 `prependContext`
- 手动:
- 工具(给 LLM 调用):`superpowers({ skill, mode, maxChars })`
- 命令(确定性、不依赖 LLM):`/superpowers [summary|full]`
## 依赖 / 版本要求
- OpenClaw `2026.3.x`(或更高版本且插件 API 兼容)
## 安装
二选一即可:
### 方法 A:直接 clone 到 OpenClaw 扩展目录(推荐)
```
mkdir -p ~/.openclaw/extensions
cd ~/.openclaw/extensions
git clone https://github.com/w4ngyu/openclaw-superpowers.git superpowers
```
验证文件存在:
```
ls -la ~/.openclaw/extensions/superpowers/openclaw.plugin.json
ls -la ~/.openclaw/extensions/superpowers/dist/index.js
find ~/.openclaw/extensions/superpowers/skills -maxdepth 2 -name SKILL.md | wc -l
```
### 方法 B:直接复制文件夹
将此仓库文件夹复制到:
- `~/.openclaw/extensions/superpowers/`
## 安装
```
New-Item -ItemType Directory -Force "$env:USERPROFILE\.openclaw\extensions" | Out-Null
cd "$env:USERPROFILE\.openclaw\extensions"
git clone https://github.com/w4ngyu/openclaw-superpowers.git superpowers
```
验证文件存在:
```
Test-Path "$env:USERPROFILE\.openclaw\extensions\superpowers\openclaw.plugin.json"
Test-Path "$env:USERPROFILE\.openclaw\extensions\superpowers\dist\index.js"
```
## 启用插件(不要手写改配置)
```
openclaw plugins enable superpowers
openclaw config validate
openclaw plugins list
```
如果你更新了插件代码,需要 **重启 Gateway** 才会加载新代码。
- 如果你运行的是 Gateway 服务单元:`openclaw gateway restart`
- 如果你的 Gateway 由其他进程监管(phoenix/leader-manager/等),请通过该监管程序重启。
## 可选配置(按需)
所有配置都在 `plugins.entries.superpowers.config` 下。
示例:
```
# 关闭每次运行的提示文本(如果启用则保持自动注入)
openclaw config set plugins.entries.superpowers.config.showTip false
# 禁用自动选择(仅在用户明确提及 skill 名称时注入)
openclaw config set plugins.entries.superpowers.config.autoSelect false
# 完全禁用 skill 文本注入(保留 tool + command)
openclaw config set plugins.entries.superpowers.config.injectSkillText false
# 调整注入大小限制
openclaw config set plugins.entries.superpowers.config.maxInjectedChars 12000
```
验证配置合法:
```
openclaw config validate
```
## 使用方式
### 1)自动(推荐)
正常提问即可。插件会自动选一个 skill 并注入 workflow 指导。
### 2)手动(命令,确定性)
在任意 OpenClaw 对话入口(WebUI / Telegram / Discord)发送:
- `/superpowers systematic-debugging summary`
- `/superpowers test-driven-development full`
### 3)手动(工具,给 LLM 调用)
让智能体调用:
- `superpowers({ skill: "systematic-debugging", mode: "summary" })`
## 疑难解答 / FAQ
### 插件找不到 / 没有加载(Plugin not found / not loaded)
- 确认扩展目录下的文件夹名必须是 `superpowers`:
- macOS: `~/.openclaw/extensions/superpowers/`
- Windows: `%USERPROFILE%\.openclaw\extensions\superpowers\`
- 确认该目录下存在 `openclaw.plugin.json`
- 执行:
```
openclaw plugins list
openclaw config validate
```
### skills 缺失(Skills missing)
- 确认插件目录内存在 `skills//SKILL.md`
### 本地 `gateway closed (1006 abnormal closure …)`(常见是代理导致)
常见原因:代理环境变量影响本地 WS 连接(`ALL_PROXY/HTTP_PROXY/HTTPS_PROXY`)。
尝试:
```
env -u ALL_PROXY -u HTTP_PROXY -u HTTPS_PROXY openclaw gateway health
```
尝试:
```
$env:ALL_PROXY=""
$env:HTTP_PROXY=""
$env:HTTPS_PROXY=""
openclaw gateway health
```
### 太吵(每次都提示 / 重复提示)
- 设置 `showTip=false`:
```
openclaw config set plugins.entries.superpowers.config.showTip false
```
## 一键安装脚本(可选)
- macOS:`scripts/install-macos.sh`
- Windows:`scripts/install-windows.ps1`
它们会:
1. 备份已有 `~/.openclaw/extensions/superpowers`(带时间戳)
2. 复制当前仓库内容到目标目录
3. 执行 `openclaw plugins enable superpowers` + `openclaw config validate`
## 许可证 / 致谢
- 本项目基于上游 Superpowers(MIT License,见 `LICENSE`)。
- 本仓库仅增加 OpenClaw 插件封装与安装文档(细节见 `NOTICE.md`)。
- 二次分发请保留许可证与版权声明(MIT 要求)。
标签:AI编程辅助, Claude Code, DNS 反向解析, GNU通用公共许可证, LLM插件, Node.js, OpenClaw, Prompt注入, 上下文管理, 动态上下文, 大语言模型工具, 威胁情报, 开发者工具, 技能路由, 提示词工程, 效率工具, 数据可视化, 智能体技能, 策略决策点, 自动化攻击, 防御加固