install
source · Clone the upstream repo
git clone https://github.com/openclaw/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/8co/opentangl-plugin" ~/.claude/skills/openclaw-skills-opentangl-plugin && rm -rf "$T"
OpenClaw · Install into ~/.openclaw/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/8co/opentangl-plugin" ~/.openclaw/skills/openclaw-skills-opentangl-plugin && rm -rf "$T"
manifest:
skills/8co/opentangl-plugin/SKILL.mdsource content
OpenTangl Plugin for OpenClaw
This is an OpenClaw plugin (not a plain skill). It registers native tools into the OpenClaw agent runtime so you can operate OpenTangl entirely from chat.
Once installed, your agent gains 11 tools covering the full OpenTangl lifecycle: reading the queue, proposing tasks, running autopilot, executing workflows, auditing cross-repo wiring, and managing the merge pipeline.
Install
openclaw plugins install opentangl-plugin
Then restart your gateway:
openclaw gateway restart
Configure
Add to your OpenClaw config file:
{ plugins: { entries: { opentangl: { enabled: true, config: { // Required: path to your OpenTangl workspace // (the directory containing projects.yaml and tasks/) workdir: "/path/to/your/opentangl-workspace", // Optional: override the CLI path if not in PATH // bin: "/usr/local/bin/opentangl", // Optional: timeout in ms (default 120000; increase for autopilot) // timeout: 300000, }, }, }, }, }
To enable the mutating tools (they are off by default for safety):
{ tools: { allow: [ "opentangl_propose", "opentangl_autopilot", "opentangl_run_workflow", "opentangl_next", "opentangl_wire", "opentangl_merge", "opentangl_prune", "opentangl_resume", ], }, }
Prerequisites
- OpenTangl installed and configured (
+projects.yaml
with API key).env
,node
,git
in PATHgh
orOPENAI_API_KEY
in the environmentANTHROPIC_API_KEY
What you get
Always-on tools (read-only)
| Tool | What it does |
|---|---|
| Task queue with dependency status |
| Registered projects and resolved paths |
| Recent workflow executions |
Optional tools (enable via tools.allow
)
tools.allow| Tool | What it does |
|---|---|
| Analyze codebase → propose tasks ( or ) |
| Full autopilot: propose + write + verify + commit + PR |
| Run a workflow YAML ( or mode) |
| Execute the next eligible queue task |
| Read-only cross-repo wiring audit |
| Merge pipeline: CI wait, diff review, merge/escalate |
| Remove terminal tasks, commit cleaned queue |
| Resume a failed workflow execution by ID |
Example session
You: What's in the task queue? Agent: [opentangl_queue] → 3 pending, 1 running, 2 completed You: Propose some tasks for the api project Agent: [opentangl_propose mode=preview projects=api] → shows proposed tasks You: Queue them Agent: [opentangl_propose mode=queue projects=api] → appended 4 tasks You: Run the next one Agent: [opentangl_next] → executes task, commits changes You: Run the merge pipeline Agent: [opentangl_merge] → opens PRs, waits for CI, merges
Related
- OpenTangl skill (
) — onboarding guide for setting up OpenTangl from scratchopentangl - OpenTangl docs — https://opentangl.com