Stitch

README

# openclaw-stitch

A Claude Code skill for porting CC plugins to openclaw extensions.

Every developer who touches openclaw discovers the same six things in the same order. This writes them down so you don't have to.

## What it covers

- Hook conversion: `UserPromptSubmit` bash → `before_agent_start` JS
- Manifest conversion: `plugin.json` → `openclaw.plugin.json` (configSchema is required, even when empty)
- Tool surface delta: what CC tools exist in openclaw, what to drop, what to keep
- Skill porting: SKILL.md format is identical — audit the tool references
- Extension placement and config registration
- Multi-gateway deployments (unicorn + rumble)
- Common failure modes with fixes

## Usage

Install as a Claude Code skill. When you're porting a CC plugin, the skill loads automatically and gives you the translation layer.

```
~/.claude/skills/openclaw-porter/
├── SKILL.md       ← the skill
└── evals/
    └── evals.json ← 4 evals covering common porting scenarios
```

## The short version

```
UserPromptSubmit bash hook  →  api.on("before_agent_start")
stdout injection            →  return { prependContext: "..." }
plugin.json                 →  openclaw.plugin.json (add configSchema)
Read/Bash/Grep tools        →  drop
kg_search_* tools           →  keep
WebSearch                   →  check tools.deny first
```

Add to `plugins.allow`. Don't touch `plugins.entries`. Restart the gateway.

## Built with

Claude. Using Claude Code.

Yes we see it.