feat: OpenClaw plugin for transparent exec rewriting

[aneym]

Summary

OpenClaw plugin that intercepts exec tool calls via before_tool_call hook and rewrites commands to RTK equivalents. This is the OpenClaw counterpart to hooks/rtk-rewrite.sh for Claude Code.

How it works

OpenClaw agents use an exec tool to run shell commands. The plugin hooks into before_tool_call, parses the command, and rewrites it using the same command→RTK mapping as the CC hook. The compressed output enters the context window instead of raw verbose output.

Files

File	Description
openclaw/index.ts	Plugin source (~90 lines) — rewrite rules, guards, hook registration
openclaw/openclaw.plugin.json	Plugin manifest with configSchema (enabled, verbose)
openclaw/README.md	Installation, config, comparison with CC hooks

Rewrite rules

Same coverage as hooks/rtk-rewrite.sh: git, gh, grep, find, ls, tsc, eslint, vitest, pytest, docker, kubectl.

Guards skip: commands already using rtk, piped/compound commands (|, &&, ;), heredocs.

Measured savings (OpenClaw + Opus)

Command	Raw chars	RTK chars	Savings
git log --stat -20	10,099	1,273	87%
ls -la	1,078	232	78%
git status	211	70	66%
grep (single file)	1,439	678	52%
find -name	489	253	48%

Test plan

• Installed on OpenClaw 2026.3.3, gateway loads plugin successfully
• git status, git log, ls, find, gh pr list — all rewritten and compressed
• Piped commands (cmd1 && cmd2) — correctly skipped (no rewrite)
• cat — correctly skipped (not in rewrite table)
• Commands already using rtk — correctly skipped
• Errors propagated correctly (e.g. docker daemon not running)
• Verbose mode logs rewrites to console

Future

rtk init --openclaw could auto-install this plugin, similar to rtk init --global for CC hooks. Happy to implement in a follow-up.

🤖 Generated with Claude Code

[pszymkowiak]

Hi! Thanks for the contribution! Since March 6, all PRs should target the develop branch instead of master (see CONTRIBUTING.md).

Could you update the base branch? Click Edit at the top right of this PR and change it from master to develop.

Thanks!

[pszymkowiak]

Thanks @aneym! Nice work getting OpenClaw integration working with measured savings.

One important design change needed: the plugin hardcodes rewrite rules in TypeScript, which means every new RTK command requires a manual plugin update. Instead, please delegate to rtk rewrite — this is the single source of truth for all rewrite logic.

See the OpenCode plugin (hooks/opencode-rtk.ts) for the pattern:

const result = await $`rtk rewrite ${command}`.quiet().nothrow()
const rewritten = String(result.stdout).trim()
if (rewritten && rewritten !== command) {
  command = rewritten
}

This way the plugin stays thin (~20 lines) and automatically benefits from new RTK commands without updates.

Thanks!

[DoiiarX]

is it still working on?