{
  "title": "Switch or clear the agent on an existing job",
  "content": "openclaw cron edit <jobId> --agent ops\nopenclaw cron edit <jobId> --clear-agent\nbash theme={null}\nopenclaw cron run <jobId> --force\nbash theme={null}\nopenclaw cron edit <jobId> \\\n  --message \"Updated prompt\" \\\n  --model \"opus\" \\\n  --thinking low\nbash theme={null}\nopenclaw cron runs --id <jobId> --limit 50\nbash theme={null}\nopenclaw system event --mode now --text \"Next heartbeat: check battery.\"\n```\n\n## Gateway API surface\n\n* `cron.list`, `cron.status`, `cron.add`, `cron.update`, `cron.remove`\n* `cron.run` (force or due), `cron.runs`\n  For immediate system events without a job, use [`openclaw system event`](/cli/system).\n\n* Check cron is enabled: `cron.enabled` and `OPENCLAW_SKIP_CRON`.\n* Check the Gateway is running continuously (cron runs inside the Gateway process).\n* For `cron` schedules: confirm timezone (`--tz`) vs the host timezone.\n\n### Telegram delivers to the wrong place\n\n* For forum topics, use `-100…:topic:<id>` so it’s explicit and unambiguous.\n* If you see `telegram:...` prefixes in logs or stored “last route” targets, that’s normal;\n  cron delivery accepts them and still parses topic IDs correctly.",
  "code_samples": [
    {
      "code": "Manual run (debug):",
      "language": "unknown"
    },
    {
      "code": "Edit an existing job (patch fields):",
      "language": "unknown"
    },
    {
      "code": "Run history:",
      "language": "unknown"
    },
    {
      "code": "Immediate system event without creating a job:",
      "language": "unknown"
    }
  ],
  "headings": [
    {
      "level": "h2",
      "text": "Gateway API surface",
      "id": "gateway-api-surface"
    },
    {
      "level": "h2",
      "text": "Troubleshooting",
      "id": "troubleshooting"
    },
    {
      "level": "h3",
      "text": "“Nothing runs”",
      "id": "“nothing-runs”"
    },
    {
      "level": "h3",
      "text": "Telegram delivers to the wrong place",
      "id": "telegram-delivers-to-the-wrong-place"
    }
  ],
  "url": "llms-txt#switch-or-clear-the-agent-on-an-existing-job",
  "links": []
}