OCSmartTools

Provider-agnostic tool orchestration plugin for OpenClaw.

OCSmartTools helps reduce latency and token cost by routing multi-step work through deterministic tool flows (tool_dispatch / tool_batch) and shaping large outputs.

Highlights

• Works with existing OpenClaw installs (openclaw >= 2026.2.19)
• Zero-touch startup (auto-bootstrap on install)
• Tools added:
  • tool_search
  • tool_dispatch
  • tool_batch
  • tool_result_get
• Built-in metrics for success/failure/timeout, latency, and estimated savings
• Skill-compatible (including browser/Playwright-style workflows)
• Auto-managed routing guidance for research/report/coding/data tasks (no per-prompt guardrails needed)
• Strict routing is default-on for new installs
• Auto fallback for blocked pages: web_fetch -> browser snapshot path

Install

openclaw plugins install ocsmarttools --pin
openclaw plugins enable ocsmarttools
openclaw gateway restart

Quick Start

/ocsmarttools status
/ocsmarttools strict on
/ocsmarttools stats

What these do:

• status: shows current mode, strict-routing state, and key limits
• strict on: enables strict plugin-managed routing guidance
• stats: shows usage, failures, latency, and savings

Core Commands (Chat)

• /ocsmarttools help -> simple command guide
• /ocsmarttools status -> current state and limits
• /ocsmarttools strict <on|off|status> -> strict routing control
• /ocsmarttools sync -> re-apply managed routing block in AGENTS.md
• /ocsmarttools stats -> metrics summary
• /ocsmarttools stats reset -> reset metrics window
• /ocsmarttools setup [safe|standard] -> apply recommended defaults
• /ocsmarttools mode <safe|standard> -> change mode only
• /ocsmarttools config -> show effective config
• /ocsmarttools config keys -> list editable keys
• /ocsmarttools config set <key> <value> -> update one key
• /ocsmarttools config reset [key] -> reset one key or all
• /ocsmarttools version -> installed plugin version

Core Commands (CLI)

• openclaw ocsmarttools help
• openclaw ocsmarttools status
• openclaw ocsmarttools strict <on|off>
• openclaw ocsmarttools sync
• openclaw ocsmarttools stats
• openclaw ocsmarttools stats-reset
• openclaw ocsmarttools setup [safe|standard]
• openclaw ocsmarttools mode <safe|standard>
• openclaw ocsmarttools config
• openclaw ocsmarttools config-keys
• openclaw ocsmarttools config-set <key> <value>
• openclaw ocsmarttools config-reset [key]
• openclaw ocsmarttools version

Config

Config path:

• plugins.entries.ocsmarttools.config

High-impact keys:

• strictRouting (true|false)
• maxResultChars (result shaping threshold)
• maxSteps, maxForEach (batch limits)
• invokeTimeoutMs (per-dispatch timeout)
• toolSearch.useLiveRegistry (true|false)

Example:

/ocsmarttools config set strictRouting true
/ocsmarttools config set maxResultChars 120000
/ocsmarttools config set invokeTimeoutMs 30000

Modes

• standard (default): balanced, zero-touch
• safe: requires sandbox and blocks control-plane dispatch
• strictRouting=true: enforces plugin-managed routing guidance and keeps routing block synced

Web fetch fallback defaults:

• webFetchFallback.enabled=true
• webFetchFallback.browserTarget=auto
• webFetchFallback.snapshotFormat=ai
• webFetchFallback.snapshotLimit=12000

Auto Trigger Intents

When tools are needed, routing is auto-biased toward tool_dispatch / tool_batch for these intent families:

• research/evidence (sources, benchmarks, case studies, latest/news)
• reporting/writing (reports, briefs, proposals, plans, emails, docs/specs)
• coding/engineering (build, debug, fix, test, refactor, deploy, migration)
• data/extraction (scrape/fetch/parse/aggregate/rank/CSV/JSON/ETL)
• risk/compliance (security/privacy/legal/audit requests)

Skills and Blocked Sites

Skills in OpenClaw are instruction layers, not separate execution engines. OCSmartTools can still dispatch/batch the underlying tools used by skills.

For websites that block plain fetch, OCSmartTools now tries browser fallback automatically. If that also fails, it returns a native-handoff recommendation so OpenClaw can continue with browser tools or skill-guided Playwright/stealth workflows.

Safety Notes

• OCSmartTools does not bypass OpenClaw policy.
• Control-plane tools (gateway, cron) are blocked by default in dispatch/batch.
• Large result handles are in-memory and expire by TTL.

Troubleshooting

• If plugin commands do not appear, restart gateway:
  • openclaw gateway restart
• If strict policy blocks tools, verify tools.allow/tools.deny in OpenClaw config.
• If discovery seems stale, run:
  • /ocsmarttools sync
  • /ocsmarttools stats

Development

npm install
npm run typecheck
npm run release:check

Version and release notes:

• Version source of truth: package.json
• Release notes: CHANGELOG.md