Skip to main content

​
Overview

Cron tools let the agent create and manage scheduled jobs. You can schedule HTTP calls (webhooks), execute any profClaw tool automatically, or run shell commands on a cron expression or interval. All cron tools are in the Full tier - they require capable models to correctly reason about cron expressions and job lifecycles.

​
Available Tools

ToolDescription
cron_createCreate a new scheduled job
cron_listList all scheduled jobs
cron_triggerManually trigger a job now
cron_pausePause or resume a job
cron_archiveArchive (soft-delete) a job
cron_deletePermanently delete a job
cron_historyView run history for a job

​
Tool: cron_create

Create a new scheduled job. Security level: moderate | Tier: Full
​
name
string
required
Human-readable name for the job (max 100 characters).
​
description
string
Optional description of what the job does.
​
cron
string
Cron expression (e.g., "*/5 * * * *" for every 5 minutes). Either cron or interval is required.
​
interval
number
Interval in milliseconds (minimum 1000ms = 1 second). Alternative to cron.
​
type
string
default:"http"
Job type: http, tool, or script.

​
HTTP Job Parameters

​
url
string
Webhook URL to call.
​
method
string
default:"GET"
HTTP method: GET, POST, PUT, DELETE.
​
headers
object
Request headers.
​
body
any
Request body (JSON-encoded automatically).

​
Tool Job Parameters

​
tool
string
Name of the profClaw tool to execute.
​
toolParams
object
Parameters to pass to the tool.

​
Script Job Parameters

​
command
string
Shell command to run.
​
args
array
Command arguments array.
​
workdir
string
Working directory for the script.

​
Limits

​
maxRuns
number
Stop the job after this many successful runs.
​
maxFailures
number
Pause the job after this many consecutive failures.

​
Examples

{
  "name": "Daily health check",
  "description": "POST to our monitoring endpoint every day at 9am",
  "cron": "0 9 * * *",
  "type": "http",
  "url": "https://monitoring.example.com/ping",
  "method": "POST",
  "body": { "service": "profclaw", "check": "daily" }
}

​
Common Cron Expressions

ExpressionMeaning
*/5 * * * *Every 5 minutes
0 * * * *Every hour
0 9 * * *Daily at 9:00 AM
0 9 * * 1-5Weekdays at 9:00 AM
0 0 * * 0Weekly on Sunday midnight
0 0 1 * *Monthly on the 1st

​
Tool: cron_list

List all scheduled jobs with status. Returns job IDs, names, schedules, current status (active/paused/archived), last run time, and next scheduled run.

​
Tool: cron_trigger

Manually trigger a job outside its schedule.
​
jobId
string
required
Job ID to trigger.

​
Tool: cron_pause

Pause or resume a job.
​
jobId
string
required
Job ID.
​
pause
boolean
required
true to pause, false to resume.

​
Tool: cron_history

View the run history for a job.
​
jobId
string
required
Job ID.
​
limit
number
default:"20"
Maximum history entries.
Returns: run timestamps, duration, status (success/failure), and any error messages.

profClaw Ops

Schedule recurring ticket creation or status updates.

Web Fetch

HTTP jobs use the same SSRF protections as web_fetch.