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

`zeroclaw agent --agent {agent_alias}` is not configured (no

Error message

`zeroclaw agent --agent {agent_alias}` is not configured (no [agents.{agent_alias}] entry)

What it means

Error "`zeroclaw agent --agent {agent_alias}` is not configured (no [agents.{agent_alias}] entry)" thrown in zeroclaw-labs/zeroclaw.

Source

Thrown at src/main.rs:3687

                ta("cli-otp-enrollment-uri", &[("uri", &uri)], "Enrollment URI")
            );
        }
    }

    #[cfg(not(feature = "agent-runtime"))]
    {
        // Kernel-only mode: minimal CLI agent without channels/tools/gateway
        match cli.command {
            Commands::Agent {
                agent: agent_alias,
                message,
                model_provider,
                model,
                temperature,
                ..
            } => {
                if config.agent(&agent_alias).is_none() {
                    anyhow::bail!(
                        "`zeroclaw agent --agent {agent_alias}` is not configured (no [agents.{agent_alias}] entry)"
                    );
                }
                let agent_entry = config.model_provider_for_agent(&agent_alias);
                let final_temperature = temperature
                    .unwrap_or_else(|| agent_entry.and_then(|e| e.temperature).unwrap_or(0.7));
                if let Some(p) = &model_provider {
                    // Parse --model-provider as "type.alias" or bare "type" (use agent alias as alias name).
                    let (type_key, alias_key) =
                        p.split_once('.').unwrap_or((p.as_str(), &agent_alias));
                    let entry = config
                        .providers
                        .models
                        .ensure(type_key, alias_key)
                        .ok_or_else(|| {
                            ::zeroclaw_log::record!(
                                WARN,
                                ::zeroclaw_log::Event::new(

View on GitHub (pinned to 88bb9c8533)

Solutions

1. Add an [agents.<alias>] section to config.toml or run `zeroclaw quickstart` to create the agent.
2. Run without --agent to use the default agent, or check the alias spelling against configured agents.

When it happens

Trigger: Thrown at src/main.rs:3687 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/9ac1bd9edf4fb946. Report an issue: GitHub.