oc_run
Dispatch a task to a local OpenClaw agent and synchronously wait for the reply, with an adjustable timeout and duplicate-run protection.
Instructions
向指定 agent 下发任务,并同步等待最多 wait_seconds(默认 20,最大 120)。 参数:agent 填 oc_agents 返回的名字或别名,留空则使用 config.json 里的 defaultAgent;用户点名的 agent 不在 oc_agents 列表里时不要调用本工具,直接告诉用户没有这个 agent。message 只放任务本身,不要带“让某某做”的转述。 安全:任务会被 agent 在本机真实执行,不是模拟。删除、格式化、重启、对外发送消息等破坏性动作先跟用户确认;下发时尽量限定范围。 返回判读:status=done 时 reply 是完整结果,voice.speak 是适合朗读的短句——语音场景只播报 voice.speak,reply 只用于屏幕查看或回答追问,不要整段朗读;voice.needsSummary 或 replyTruncated=true 表示内容偏长或被截断,此时用 1–3 句话总结 reply,不要朗读代码、日志、diff、JSON、URL 或长列表;voice 提示可能含敏感信息时不要复述具体值。status=running 表示仍在跑,请用返回的 runId 调 oc_wait 继续等,不要重复调用本工具;同一会话已有任务时会返回 SESSION_BUSY 并带上当前 runId;submitReconciled=true 表示提交响应丢失但已确认任务在跑,按 running 处理。 限流默认 6 次/分钟,超限返回 RATE_LIMITED 与重试时间,不要立刻重发。
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"message": "<message>"
},
"name": "oc_run"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent | No | Agent 名字或 ID(先用 oc_agents 获取本机可用值)。留空使用默认 agent。 | |
| message | Yes | 要下发的任务消息。 | |
| wait_seconds | No | 同步等待秒数,默认 20,最大 120。设为 0 立即返回。 | |
| idempotency_key | No | 幂等键,透传给 Gateway;5 秒内相同 agent+message 会自动去重。 |