52 replies

Cron Tools Not Available as Agent Tool Calls Despite Documentation

Summary

The OpenClaw documentation states that cron functionality should be available as direct tool calls (

cron.add

cron.add

cron.update

cron.update

cron.run

cron.run

cron.remove

cron.remove

), but these tools are not available to the main agent. Instead, we have to use

exec

exec

to call the CLI commands.

Environment Details

- OpenClaw Version: 2026.2.19 (from package.json)
- Runtime: Docker container on Raspberry Pi
- Agent Type: Main agent (default configuration)
- Model: deepseek/deepseek-chat
- Channel: Telegram

What the Documentation Says

According to

/app/docs/automation/cron-jobs.md

/app/docs/automation/cron-jobs.md

"JSON schema for tool calls" section explicitly shows examples of using cron tools as agent tool calls:

{
  "name": "Reminder",
  "schedule": { "kind": "at", "at": "2026-02-01T16:00:00Z" },
  "sessionTarget": "main",
  "wakeMode": "now",
  "payload": { "kind": "systemEvent", "text": "Reminder text" },
  "deleteAfterRun": true
}

{
  "name": "Reminder",
  "schedule": { "kind": "at", "at": "2026-02-01T16:00:00Z" },
  "sessionTarget": "main",
  "wakeMode": "now",
  "payload": { "kind": "systemEvent", "text": "Reminder text" },
  "deleteAfterRun": true
}

The documentation states: "Use these shapes when calling Gateway
cron.*
cron.*
tools directly (agent tool calls or RPC)."

Current Behavior

1. Cron tools are NOT available in the agent's tool list
2. Only workaround is using

exec

exec

to call CLI:

openclaw cron add --name "name" --cron "0 18 * * *" --message "text" --announce --to "chatId"

openclaw cron add --name "name" --cron "0 18 * * *" --message "text" --announce --to "chatId"

3. CLI works correctly - cron jobs are created and scheduled properly
4. Gateway cron status shows enabled:

{"enabled": true, "storePath": "/home/node/.openclaw/cron/jobs.json", "jobs": 2, "nextWakeAtMs": 1771646400000}

{"enabled": true, "storePath": "/home/node/.openclaw/cron/jobs.json", "jobs": 2, "nextWakeAtMs": 1771646400000}

Configuration Investigation

Agent Configuration (

/home/node/.openclaw/openclaw.json

/home/node/.openclaw/openclaw.json

"agents": {
  "defaults": {
    "model": {
      "primary": "deepseek/deepseek-chat",
      "fallbacks": []
    },
    "workspace": "/home/node/.openclaw/workspace"
  }
},
"tools": {
  "deny": [
    "exec:elevated"
  ],
  "web": {
    "search": { "enabled": true },
    "fetch": { "enabled": true }
  }
}

"agents": {
  "defaults": {
    "model": {
      "primary": "deepseek/deepseek-chat",
      "fallbacks": []
    },
    "workspace": "/home/node/.openclaw/workspace"
  }
},
"tools": {
  "deny": [
    "exec:elevated"
  ],
  "web": {
    "search": { "enabled": true },
    "fetch": { "enabled": true }
  }
}

FotC�

Friends of the Crustacean 🦞🤝•3w ago•

52 replies

TheSauce

Cron Tools Not Available as Agent Tool Calls Despite Documentation

Summary

The OpenClaw documentation states that cron functionality should be available as direct tool calls (

cron.add

cron.add

cron.update

cron.update

cron.run

cron.run

cron.remove

cron.remove

), but these tools are not available to the main agent. Instead, we have to use

exec

exec

to call the CLI commands.

Environment Details

What the Documentation Says

According to

/app/docs/automation/cron-jobs.md

/app/docs/automation/cron-jobs.md

"JSON schema for tool calls" section explicitly shows examples of using cron tools as agent tool calls:

{
  "name": "Reminder",
  "schedule": { "kind": "at", "at": "2026-02-01T16:00:00Z" },
  "sessionTarget": "main",
  "wakeMode": "now",
  "payload": { "kind": "systemEvent", "text": "Reminder text" },
  "deleteAfterRun": true
}

{
  "name": "Reminder",
  "schedule": { "kind": "at", "at": "2026-02-01T16:00:00Z" },
  "sessionTarget": "main",
  "wakeMode": "now",
  "payload": { "kind": "systemEvent", "text": "Reminder text" },
  "deleteAfterRun": true
}

The documentation states: "Use these shapes when calling Gateway
cron.*
cron.*
tools directly (agent tool calls or RPC)."

Current Behavior

1. Cron tools are NOT available in the agent's tool list
2. Only workaround is using

exec

exec

to call CLI:

openclaw cron add --name "name" --cron "0 18 * * *" --message "text" --announce --to "chatId"

openclaw cron add --name "name" --cron "0 18 * * *" --message "text" --announce --to "chatId"

3. CLI works correctly - cron jobs are created and scheduled properly
4. Gateway cron status shows enabled:

{"enabled": true, "storePath": "/home/node/.openclaw/cron/jobs.json", "jobs": 2, "nextWakeAtMs": 1771646400000}

{"enabled": true, "storePath": "/home/node/.openclaw/cron/jobs.json", "jobs": 2, "nextWakeAtMs": 1771646400000}

Configuration Investigation

Agent Configuration (

/home/node/.openclaw/openclaw.json

/home/node/.openclaw/openclaw.json

"agents": {
  "defaults": {
    "model": {
      "primary": "deepseek/deepseek-chat",
      "fallbacks": []
    },
    "workspace": "/home/node/.openclaw/workspace"
  }
},
"tools": {
  "deny": [
    "exec:elevated"
  ],
  "web": {
    "search": { "enabled": true },
    "fetch": { "enabled": true }
  }
}

"agents": {
  "defaults": {
    "model": {
      "primary": "deepseek/deepseek-chat",
      "fallbacks": []
    },
    "workspace": "/home/node/.openclaw/workspace"
  }
},
"tools": {
  "deny": [
    "exec:elevated"
  ],
  "web": {
    "search": { "enabled": true },
    "fetch": { "enabled": true }
  }
}

Cron Tools Not Available as Agent Tool Calls Despite Documentation

Summary

Environment Details

What the Documentation Says

Current Behavior

Configuration Investigation

Agent Configuration (
`/home/node/.openclaw/openclaw.json`
`/home/node/.openclaw/openclaw.json`
):

Similar Threads

Cron Tools Not Available as Agent Tool Calls Despite Documentation

Summary

Environment Details

What the Documentation Says

Current Behavior

Configuration Investigation

Agent Configuration (
`/home/node/.openclaw/openclaw.json`
`/home/node/.openclaw/openclaw.json`
):

Similar Threads

Similar Threads

Similar Threads

Cron Tools Not Available as Agent Tool Calls Despite Documentation

Summary

Environment Details

What the Documentation Says

Current Behavior

Configuration Investigation

Agent Configuration (/home/node/.openclaw/openclaw.json/home/node/.openclaw/openclaw.json):

Similar Threads

Cron Tools Not Available as Agent Tool Calls Despite Documentation

Summary

Environment Details

What the Documentation Says

Current Behavior

Configuration Investigation

Agent Configuration (/home/node/.openclaw/openclaw.json/home/node/.openclaw/openclaw.json):

Similar Threads

Similar Threads

Similar Threads

Agent Configuration (
`/home/node/.openclaw/openclaw.json`
`/home/node/.openclaw/openclaw.json`
):

Agent Configuration (
`/home/node/.openclaw/openclaw.json`
`/home/node/.openclaw/openclaw.json`
):