zeroclaw-labs/zeroclaw · error · anyhow::Error

agent_alias is required; cron jobs must name an owning agent

Error message

agent_alias is required; cron jobs must name an owning agent

What it means

Error "agent_alias is required; cron jobs must name an owning agent" thrown in zeroclaw-labs/zeroclaw.

Source

Thrown at crates/zeroclaw-runtime/src/cron/store.rs:105

    name: Option<String>,
    schedule: Schedule,
    command: &str,
    delivery: Option<DeliveryConfig>,
    shell_output_format: CronShellOutputFormat,
) -> Result<CronJob> {
    let now = Utc::now();
    validate_schedule(&schedule, now)?;
    validate_delivery_config(delivery.as_ref())?;
    let next_run = next_run_for_schedule(&schedule, now)?;
    let id = Uuid::new_v4().to_string();
    let expression = schedule_cron_expression(&schedule).unwrap_or_default();
    let schedule_json = serde_json::to_string(&schedule)?;
    let delivery = delivery.unwrap_or_default();

    let delete_after_run = matches!(schedule, Schedule::At { .. });
    let agent_alias = agent_alias.trim();
    if agent_alias.is_empty() {
        anyhow::bail!("agent_alias is required; cron jobs must name an owning agent");
    }

    let shell_output_format_str = match shell_output_format {
        CronShellOutputFormat::Wrapped => "wrapped",
        CronShellOutputFormat::Raw => "raw",
    };

    with_initialized_connection(config, |conn| {
        conn.execute(
            "INSERT INTO cron_jobs (
                id, expression, command, schedule, job_type, prompt, name, session_target, model,
                enabled, delivery, delete_after_run, agent_alias, created_at, next_run, shell_output_format
             ) VALUES (?1, ?2, ?3, ?4, 'shell', NULL, ?5, 'isolated', NULL, 1, ?6, ?7, ?8, ?9, ?10, ?11)",
            params![
                id,
                expression,
                command,
                schedule_json,

View on GitHub (pinned to 88bb9c8533)

Solutions

1. Set agent_alias on the cron job so it has an owning agent.

When it happens

Trigger: Thrown at crates/zeroclaw-runtime/src/cron/store.rs:105 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of zeroclaw-labs/zeroclaw@88bb9c8533 (2026-08-23). Data as JSON: /api/errors/8d65a515880e6d9a. Report an issue: GitHub.