BetterClaw
Chats & Tasks

Tasks overview

Hand work to an agent as a recurring task, and run it from Scheduled tasks.

Tasks

A task is a unit of work you hand to an agent without sitting in a live chat. You write the instructions once; the agent runs them on schedule. Each run gets its own chat, so you can always open it and read exactly what the agent did.

Tasks live under Scheduled tasks in the left rail (the /tasks route). The overview lists your recurring schedules — split into Active and Paused — with their cadence, next run, and agent; each row's toggle pauses or resumes it. A Live / Offline pill shows whether the list is receiving real-time updates.

the Scheduled tasks overview listing active and paused schedules

One-time vs recurring

Every task is one of two kinds:

One-time runs

Run once at a set date and time. Your agent books these itself when work needs a follow-up.

Recurring tasks

Run automatically on a cron schedule, in the timezone you choose. Trigger them manually too.

Create a task

Both New task (on the overview) and New scheduled task (in the sidebar) open the scheduler for a recurring task.

  1. Open Scheduled tasks from the left rail.
  2. Click New task.
  3. Write the instructions — what the agent should do. Tasks don't accept file attachments.
  4. Pick the agent that will run it.
  5. Set the schedule. See Recurring tasks.
  6. Click Create task. It begins on its next scheduled time — use Run now to try it straight away.
You can also start from an existing chat: open its ⋯ menu and choose Turn into a recurring task. See Recurring tasks.
The Scheduled tasks overview and sidebar list your recurring schedules only. A one-time run doesn't appear in these lists — it runs in its own chat, which you open to follow it.

How a one-time run works

A one-time run fires once, at the date and time the agent booked, in its own chat. Until then you can pause it (which holds it until you resume it) or delete it. See Schedules the agent creates itself.

How a recurring task runs

A recurring task fires on its schedule and keeps a run history. From its detail view you can Run now, pause/resume with the toggle, edit the schedule or instructions, and open any past run's chat. See Recurring tasks.

Results

Open any run's chat to read what the agent did and download what it produced. See Results & deliverables.