tinyhumansai/openhuman · error

no channels configured - configure one in the UI

Error message

no channels configured - configure one in the UI

What it means

Doctor channel check: none of the optional channel blocks (telegram, discord, slack, imessage, matrix, whatsapp, email, irc, lark, webhook) is present in [channels] config. The app will still run, but it has no external messaging surface — inbound and proactive outbound messaging are both dead until at least one channel is configured.

Source

Thrown at src/openhuman/platform/doctor/core.rs:342

    }

    // Channel: at least one configured
    let cc = &config.channels_config;
    let has_channel = cc.telegram.is_some()
        || cc.discord.is_some()
        || cc.slack.is_some()
        || cc.imessage.is_some()
        || cc.matrix.is_some()
        || cc.whatsapp.is_some()
        || cc.email.is_some()
        || cc.irc.is_some()
        || cc.lark.is_some()
        || cc.webhook.is_some();

    if has_channel {
        items.push(DiagnosticItem::ok(cat, "at least one channel configured"));
    } else {
        items.push(DiagnosticItem::warn(
            cat,
            "no channels configured - configure one in the UI",
        ));
    }

    // Delegate agents
    let mut agent_names: Vec<_> = config.agents.keys().collect();
    agent_names.sort();
    for name in agent_names {
        let agent = config.agents.get(name).unwrap();
        if agent.model.trim().is_empty() {
            items.push(DiagnosticItem::warn(
                cat,
                format!("delegate agent \"{name}\" has empty model"),
            ));
        }
    }
}

View on GitHub (pinned to 7491200858)

Solutions

  1. Open Settings → Connections and connect a messaging channel (Telegram, Discord, Slack, WhatsApp, iMessage, email, …)
  2. Or add the corresponding [channels.<name>] block with credentials to config.toml and restart
  3. Ignore the warning if the instance is intentionally chat-UI-only
Defensive patterns

Strategy: validation

When it happens

Trigger: Thrown at src/openhuman/platform/doctor/core.rs:342 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of tinyhumansai/openhuman@7491200858 (2026-08-17). Data as JSON: /api/errors/cf52a5620fd9fdf8. Report an issue: GitHub.