@lucasmontano/claude-code-delegate

An OpenClaw plugin that delegates coding tasks to a locally-running Claude Code CLI session.

When enabled, it registers a claude_code tool that your OpenClaw agent can call to spawn Claude Code as a subprocess, pass it a task, and return the structured result.

Prerequisites

• OpenClaw >= 2026.1.0
• Claude Code CLI installed and authenticated:

  npm install -g @anthropic-ai/claude-code

Install

openclaw plugins install @lucasmontano/claude-code-delegate

Then restart the gateway for the plugin to load.

How it works

1. Your OpenClaw agent decides a task is best handled by Claude Code and calls the claude_code tool.
2. The plugin spawns claude -p "<task>" --output-format json as a subprocess.
3. Claude Code runs autonomously (up to maxTurns turns) in the workspace directory.
4. The JSON result is parsed and returned to the agent, including metadata like turn count, cost, and duration.

The tool is automatically hidden in sandboxed contexts for safety.

Configuration

All options are optional. Configure them under plugins.entries.claude-code-delegate in your OpenClaw config:

| Option | Type | Default | Description | | --- | --- | --- | --- | | claudePath | string | PATH lookup | Absolute path to the claude binary | | model | string | — | Model override (e.g. "sonnet", "opus") | | maxTurns | number | 10 | Max agentic turns per invocation | | timeoutMs | number | 300000 | Subprocess timeout in ms (5 min) | | maxStdoutBytes | number | 1048576 | Max stdout bytes before killing the subprocess (1 MB) | | workingDirectory | string | workspace | Default working directory for Claude Code | | skipPermissions | boolean | true | Run with --permission-mode bypassPermissions to skip interactive prompts |

Tool parameters

The claude_code tool accepts:

| Parameter | Required | Description | | --- | --- | --- | | task | yes | A clear, self-contained description of the coding task | | workingDirectory | no | Relative subdirectory within the workspace (must not escape it) | | maxTurns | no | Override max turns for this invocation | | timeoutMs | no | Override timeout for this invocation |

Management

openclaw plugins list                          # verify it's loaded
openclaw plugins info claude-code-delegate     # show details
openclaw plugins update claude-code-delegate   # update to latest
openclaw plugins uninstall claude-code-delegate # remove

License

MIT