io.github.smurfy92/openclaw-control-mcp
NPM · OPENCLAW-CONTROL-MCP · SCANNED SEP 20
MCP server bridging Claude Code to the OpenClaw gateway management plane via JSON-RPC.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security98
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- No install/post-install scripts declared.Pass
- 31 of 98 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency48
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 5 days ago).Pass
- Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability72
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 19777 tokens (~138/item across 143 items; 143 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management93
- Stability observed for 28 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage93
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 80% of tool parameters carry a description.Partial
Tool Safety75
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- 0 of 19 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "openclaw_device_pair_remove" implies "remove" and declares no destructiveHint at all, which the MCP spec reads as destructive by default. See how to fix → Fail
- An AI judge read all 143 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
How do I install the io.github.smurfy92/openclaw-control-mcp server?
io.github.smurfy92/openclaw-control-mcp runs locally as an npm package, launched with npx -y openclaw-control-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
npm · openclaw-control-mcp
claude mcp add smurfy92-openclaw-control-mcp -- npx -y openclaw-control-mcp
{
"mcpServers": {
"smurfy92-openclaw-control-mcp": {
"command": "npx",
"args": [
"-y",
"openclaw-control-mcp"
]
}
}
} {
"servers": {
"smurfy92-openclaw-control-mcp": {
"command": "npx",
"args": [
"-y",
"openclaw-control-mcp"
]
}
}
} codex mcp add smurfy92-openclaw-control-mcp -- npx -y openclaw-control-mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"smurfy92-openclaw-control-mcp": {
"type": "local",
"command": [
"npx",
"-y",
"openclaw-control-mcp"
],
"enabled": true
}
}
} openclaw mcp add smurfy92-openclaw-control-mcp --command npx --arg -y --arg openclaw-control-mcp
mcp_servers:
smurfy92-openclaw-control-mcp:
command: "npx"
args: ["-y", "openclaw-control-mcp"] {
"McpServers": {
"smurfy92-openclaw-control-mcp": {
"Transport": "stdio",
"Command": "npx",
"Arguments": [
"-y",
"openclaw-control-mcp"
]
}
}
} assistant mcp add smurfy92-openclaw-control-mcp -t stdio -c npx -a -y openclaw-control-mcp
{
"mcpServers": {
"smurfy92-openclaw-control-mcp": {
"command": "npx",
"args": [
"-y",
"openclaw-control-mcp"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 19 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 87 to 90. That category is still filling its 30-day observation window: 26 days of observed history at the previous scan, 27 at this one. The score rises as the window fills, whether or not the server changes.
- 17 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 80 to 83. That category is still filling its 30-day observation window: 24 days of observed history at the previous scan, 25 at this one. The score rises as the window fills, whether or not the server changes.
- 16 Sept 26 −3
- Stability: pass → 0.80 functional
- 15 Sept 26 +1
- Stability: 0.97 → pass security
- 12 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 87 to 90. That category is still filling its 30-day observation window: 26 days of observed history at the previous scan, 27 at this one. The score rises as the window fills, whether or not the server changes.
- 10 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 80 to 83. That category is still filling its 30-day observation window: 24 days of observed history at the previous scan, 25 at this one. The score rises as the window fills, whether or not the server changes.
- 9 Sept 26 −3
- Stability: pass → 0.80 functional
- 8 Sept 26 +1
- Stability: 0.97 → pass security
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 20 Sept 2026 · Analysed npm/openclaw-control-mcp@0.6.0
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | npm |
Background: How many MCP packages publish verified provenance →
Dependencies 98 packages
| Packages resolved | 98 |
|---|---|
| Stale | 31 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
openclaw_sessions_patch ~182
Update session metadata (title, displayName, tags, etc.). Wraps `sessions.patch`. Pass id + only the fields you want to change. Schema is intentionally permissive — gateway accepts any subset of session fields.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | Session id. Most session.* methods accept the `sessionId` (UUID); a few accept the composite `key` (e.g. 'agent:main:cron:<id>'). When unsure, try the UUID first; if rejected with NOT_FOUND, retry wi… |
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
No output schema declared.
No examples provided.
openclaw_sessions_preview ~155
Preview one or more sessions without subscribing — returns recent messages, status, and metadata for each key. Wraps `sessions.preview`. Read-only. Pass `keys` (array of full session keys like 'agent:main:cron:<id>' from openclaw_sessions_list).
| Name | Type | Req | Description |
|---|---|---|---|
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
| keys | array | yes | Full session keys (the `key` field returned by openclaw_sessions_list, NOT the sessionId UUID) |
No output schema declared.
No examples provided.
openclaw_sessions_reset ~164
Reset a session (clears working state, keeps session id). Wraps `sessions.reset`. Destructive — confirm before calling.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | Session id. Most session.* methods accept the `sessionId` (UUID); a few accept the composite `key` (e.g. 'agent:main:cron:<id>'). When unsure, try the UUID first; if rejected with NOT_FOUND, retry wi… |
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
No output schema declared.
No examples provided.
openclaw_sessions_send ~187
Send a user message into an existing session. Wraps `sessions.send`. The agent processes async and streams the reply via session.message events; call openclaw_sessions_preview afterwards (with the session's composite key) to see the result. Use either `text` or `message` — gateway accepts both names depending on version.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | Session id (sessionId UUID). |
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
| message | string | – | Message text. Older alias for `text`; pass either, not both. |
| text | string | – | Message text. Preferred field name in newer gateway versions. |
No output schema declared.
No examples provided.
openclaw_sessions_subscribe ~129
Subscribe to session lifecycle events (sessions.changed). Wraps `sessions.subscribe`. Note: the MCP runs over stdio and cannot stream events back to the client — this tool registers the subscription server-side but you won't receive deltas in Claude Code. Useful mainly to confirm the subscription was accepted.
| Name | Type | Req | Description |
|---|---|---|---|
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
No output schema declared.
No examples provided.
openclaw_sessions_tail ~339
Watch a session by polling `sessions.preview` and return only the NEW messages that appeared during the tail window. Workaround for the stdio MCP not being able to stream `sessions.subscribe` / `session.message` events to Claude Code. Polls every `intervalMs` (default 2000ms) for up to `durationMs` (default 30000ms, max 300000ms), or until `maxMessages` new messages are collected, or until the session reaches a terminal status ('done', 'error', 'aborted', 'timeout', 'completed'). The first poll seeds the 'already-seen' set so existing messages are NOT returned — only what arrives after the tool was called.
| Name | Type | Req | Description |
|---|---|---|---|
| durationMs | integer | – | Total tail duration in ms. Default 30000 (30s). Max 300000 (5min). |
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
| intervalMs | integer | – | Polling interval in ms. Default 2000 (2s). Min 500 to avoid hammering the gateway. Max 10000. |
| key | string | yes | Full session key (composite, e.g. 'agent:main:cron:<id>') from openclaw_sessions_list. |
| maxMessages | integer | – | Stop early once this many new messages have arrived — useful to bail out on the first agent reply. |
No output schema declared.
No examples provided.
openclaw_sessions_unsubscribe ~84
Unsubscribe from session lifecycle events. Wraps `sessions.unsubscribe`.
| Name | Type | Req | Description |
|---|---|---|---|
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
No output schema declared.
No examples provided.
openclaw_set_heartbeats ~112
Toggle / configure heartbeat emission from the gateway. Wraps `set-heartbeats`. Pass `enabled` and any cadence params.
| Name | Type | Req | Description |
|---|---|---|---|
| enabled | boolean | – | – |
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
| intervalMs | integer | – | – |
No output schema declared.
No examples provided.
openclaw_setup ~254
Persist a named OpenClaw gateway config (URL + token) to local store. Default instance name is 'default'. Pass `instance` to manage multiple gateways (e.g. 'perso', 'work') from the same MCP. Env vars (OPENCLAW_GATEWAY_URL/TOKEN) still override everything stored here — leave them unset to use named instances. After saving, the matching client connection is closed so the next tool call re-handshakes with the new credentials.
| Name | Type | Req | Description |
|---|---|---|---|
| gatewayPassword | string | – | Optional extra password if your gateway is configured with one |
| gatewayToken | string | yes | Gateway login token (get it from your Hostinger VPS dashboard or the Control panel after login) |
| gatewayUrl | string | yes | WebSocket URL of the gateway, e.g. wss://your-gateway.example.com or ws://127.0.0.1:18789 |
| instance | string | – | Instance name (e.g. 'default', 'perso', 'work'). Defaults to 'default'. The first instance configured becomes the default automatically. |
| makeDefault | boolean | – | If true, also set this instance as the active default (for tools that don't pass `instance`). |
No output schema declared.
No examples provided.
openclaw_setup_clear ~81
Clear a persisted gateway config. By default clears every instance; pass `instance` to clear just one. Does NOT touch the device identity or device tokens. After this, the MCP falls back to env vars or errors with 'configure first'.
| Name | Type | Req | Description |
|---|---|---|---|
| instance | string | – | If set, clear only this named instance. Omit to clear all instances. |
No output schema declared.
No examples provided.
openclaw_setup_list ~47
List every persisted gateway instance (name + URL + whether token/password are set, never the values). Plus the active default instance and where secrets live (file vs OS keychain).
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
openclaw_setup_select_default ~83
Switch the active default instance — every subsequent tool call (cron.list, sessions.list, etc.) will route to this instance unless an env var overrides. Closes existing client connections so they re-handshake with the new instance's credentials.
| Name | Type | Req | Description |
|---|---|---|---|
| instance | string | yes | Instance name to set as default. Must already exist (use openclaw_setup first). |
No output schema declared.
No examples provided.
openclaw_setup_show ~67
Show the currently resolved gateway configuration for an instance (default 'default' or whichever instance is the active default). Does NOT print tokens. Pass `instance` to inspect a non-default one.
| Name | Type | Req | Description |
|---|---|---|---|
| instance | string | – | Instance name to inspect. Defaults to the active default instance. |
No output schema declared.
No examples provided.
openclaw_skills_bins ~92
List the binaries / executables exposed by installed skills. Wraps `skills.bins`. Read-only.
| Name | Type | Req | Description |
|---|---|---|---|
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
No output schema declared.
No examples provided.
openclaw_skills_detail ~108
Get detailed info on a specific skill (manifest, version, dependencies, install state). Wraps `skills.detail`. Read-only.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | Skill id / slug |
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
No output schema declared.
No examples provided.
openclaw_skills_install ~116
Install a skill (or a specific version). Wraps `skills.install`. Mutates the gateway's skill set — confirm before calling.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | Skill id to install |
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
| version | string | – | – |
No output schema declared.
No examples provided.
openclaw_skills_search ~104
Search the available skill catalog (installed and remote). Wraps `skills.search`. Read-only.
| Name | Type | Req | Description |
|---|---|---|---|
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
| limit | integer | – | – |
| query | string | – | – |
No output schema declared.
No examples provided.
openclaw_skills_status ~96
Get the skills subsystem status (which skills are installed, enabled, recently updated). Wraps `skills.status`. Read-only.
| Name | Type | Req | Description |
|---|---|---|---|
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
No output schema declared.
No examples provided.
openclaw_skills_update ~115
Update an installed skill to its latest (or a specified) version. Wraps `skills.update`. Mutates the gateway state.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | Skill id to update |
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
| version | string | – | – |
No output schema declared.
No examples provided.
openclaw_status ~99
Get overall gateway status (uptime, agents, sessions, queues). Wraps the root-level `status` JSON-RPC method. Read-only.
| Name | Type | Req | Description |
|---|---|---|---|
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
No output schema declared.
No examples provided.
openclaw_system_event ~113
Emit a custom system event onto the gateway bus. Wraps `system-event`. Mostly used for tooling / debug — operators rarely call this directly.
| Name | Type | Req | Description |
|---|---|---|---|
| event | string | yes | Event name |
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
| payload | – | – | – |
No output schema declared.
No examples provided.
openclaw_system_presence ~94
Get presence info (which devices are connected, when they last spoke). Wraps `system-presence`. Read-only.
| Name | Type | Req | Description |
|---|---|---|---|
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
No output schema declared.
No examples provided.
openclaw_talk_config ~98
Get / set the talk-mode config (push-to-talk, hold-to-listen, voice activity detection). Wraps `talk.config`.
| Name | Type | Req | Description |
|---|---|---|---|
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
No output schema declared.
No examples provided.
openclaw_talk_mode ~150
Toggle talk mode on/off. Wraps `talk.mode`. Wire format (verified live against gateway 2026.4.12+): requires `enabled: boolean` — this is a SETTER, not a getter. Use `openclaw_talk_config` to read the current state.
| Name | Type | Req | Description |
|---|---|---|---|
| enabled | boolean | yes | True to turn talk mode on, false to turn it off. |
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
No output schema declared.
No examples provided.
openclaw_talk_speak ~104
Make the agent speak a piece of text out loud (synthesizes + plays). Wraps `talk.speak`.
| Name | Type | Req | Description |
|---|---|---|---|
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
| text | string | yes | – |
No output schema declared.
No examples provided.
openclaw_tools_catalog ~118
List the catalog of agent-facing tools available to OpenClaw agents (i.e. what `main` and other agents can call from inside a session). Wraps `tools.catalog`. Read-only.
| Name | Type | Req | Description |
|---|---|---|---|
| agentId | string | – | – |
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
No output schema declared.
No examples provided.
openclaw_tools_effective ~120
Get the effective (merged) tool set for an agent — base catalog + skill-provided + per-agent overrides. Wraps `tools.effective`. Read-only.
| Name | Type | Req | Description |
|---|---|---|---|
| agentId | string | – | – |
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
| sessionId | string | – | – |
No output schema declared.
No examples provided.
openclaw_tts_convert ~112
Synthesize a piece of text to audio. Wraps `tts.convert`. Returns audio / a download URL depending on the gateway config.
| Name | Type | Req | Description |
|---|---|---|---|
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
| text | string | yes | – |
| voice | string | – | – |
No output schema declared.
No examples provided.
openclaw_tts_disable ~84
Disable text-to-speech output. Wraps `tts.disable`.
| Name | Type | Req | Description |
|---|---|---|---|
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
No output schema declared.
No examples provided.
openclaw_tts_enable ~84
Enable text-to-speech output. Wraps `tts.enable`.
| Name | Type | Req | Description |
|---|---|---|---|
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
No output schema declared.
No examples provided.
openclaw_tts_providers ~93
List available TTS providers (and their voices / models). Wraps `tts.providers`. Read-only.
| Name | Type | Req | Description |
|---|---|---|---|
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
No output schema declared.
No examples provided.
openclaw_tts_setProvider ~109
Switch the active TTS provider / voice. Wraps `tts.setProvider`.
| Name | Type | Req | Description |
|---|---|---|---|
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
| model | string | – | – |
| provider | string | yes | – |
| voice | string | – | – |
No output schema declared.
No examples provided.
openclaw_tts_status ~94
Get the TTS subsystem status (enabled, current provider, voice). Wraps `tts.status`. Read-only.
| Name | Type | Req | Description |
|---|---|---|---|
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
No output schema declared.
No examples provided.
openclaw_update_run ~120
Trigger an update of the gateway itself (pull latest version, restart components). Wraps `update.run`. DESTRUCTIVE — may briefly interrupt running sessions. Confirm before calling.
| Name | Type | Req | Description |
|---|---|---|---|
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
| version | string | – | Specific version to install; omit for latest |
No output schema declared.
No examples provided.
openclaw_usage_cost ~125
Get usage cost breakdown (per agent, per model, per period). Wraps `usage.cost`. Read-only. Pass period/agent filters if supported.
| Name | Type | Req | Description |
|---|---|---|---|
| agentId | string | – | – |
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
| sinceMs | integer | – | – |
| untilMs | integer | – | – |
No output schema declared.
No examples provided.
openclaw_usage_status ~91
Get usage status (token counts, current period, quotas). Wraps `usage.status`. Read-only.
| Name | Type | Req | Description |
|---|---|---|---|
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
No output schema declared.
No examples provided.
openclaw_voicewake_get ~95
Get the voice-wake configuration (wake word, sensitivity, enabled). Wraps `voicewake.get`. Read-only.
| Name | Type | Req | Description |
|---|---|---|---|
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
No output schema declared.
No examples provided.
openclaw_voicewake_set ~100
Update the voice-wake configuration. Wraps `voicewake.set`.
| Name | Type | Req | Description |
|---|---|---|---|
| enabled | boolean | – | – |
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
| wakeWord | string | – | – |
No output schema declared.
No examples provided.
openclaw_wake ~111
Wake an agent / session out of idle. Wraps the root-level `wake` method. Pass agentId/sessionId.
| Name | Type | Req | Description |
|---|---|---|---|
| agentId | string | – | – |
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
| sessionId | string | – | – |
No output schema declared.
No examples provided.
openclaw_wizard_cancel ~87
Cancel the active wizard flow without applying its changes. Wraps `wizard.cancel`.
| Name | Type | Req | Description |
|---|---|---|---|
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
No output schema declared.
No examples provided.
openclaw_wizard_next ~95
Advance the active wizard to its next step (with the user's answer to the current step). Wraps `wizard.next`.
| Name | Type | Req | Description |
|---|---|---|---|
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
No output schema declared.
No examples provided.
openclaw_wizard_start ~113
Start a setup wizard flow (e.g. agent onboarding, channel pairing). Wraps `wizard.start`. Pass the wizard id / kind.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | – | – |
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
| kind | string | – | – |
No output schema declared.
No examples provided.
openclaw_wizard_status ~130
Get the wizard's current step and pending input for a specific session. Wraps `wizard.status`. Wire format (verified live against gateway 2026.4.12+): requires `sessionId`. Read-only.
| Name | Type | Req | Description |
|---|---|---|---|
| instance | string | – | Optional OpenClaw instance to route this call to (e.g. 'default', 'work'). Falls back to the active default instance, or the OPENCLAW_GATEWAY_URL/TOKEN env vars when set. List configured instances wi… |
| sessionId | string | yes | Session id whose wizard state to inspect. |
No output schema declared.
No examples provided.
What is the io.github.smurfy92/openclaw-control-mcp server?
io.github.smurfy92/openclaw-control-mcp is listed in the public MCP registry as io.github.smurfy92/openclaw-control-mcp. MCP server bridging Claude Code to the OpenClaw gateway management plane via JSON-RPC. This page covers its npm package (openclaw-control-mcp).
Is the io.github.smurfy92/openclaw-control-mcp server safe to use?
io.github.smurfy92/openclaw-control-mcp scores 81 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 20 September 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the io.github.smurfy92/openclaw-control-mcp server expose?
io.github.smurfy92/openclaw-control-mcp exposes 143 tools: openclaw_setup, openclaw_setup_show, openclaw_setup_list, openclaw_setup_select_default, openclaw_setup_clear, and 138 more. Their descriptions and schemas cost roughly 19,777 tokens of context every time the server is loaded.
Is the io.github.smurfy92/openclaw-control-mcp server still maintained?
io.github.smurfy92/openclaw-control-mcp is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the io.github.smurfy92/openclaw-control-mcp server under?
io.github.smurfy92/openclaw-control-mcp declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.