Struct ChannelsConfig 

pub struct ChannelsConfig {

    pub cli: bool,
    pub telegram: HashMap<String, TelegramConfig>,
    pub discord: HashMap<String, DiscordConfig>,
    pub slack: HashMap<String, SlackConfig>,
    pub mattermost: HashMap<String, MattermostConfig>,
    pub webhook: HashMap<String, WebhookConfig>,
    pub imessage: HashMap<String, IMessageConfig>,
    pub matrix: HashMap<String, MatrixConfig>,
    pub signal: HashMap<String, SignalConfig>,
    pub whatsapp: HashMap<String, WhatsAppConfig>,
    pub linq: HashMap<String, LinqConfig>,
    pub wati: HashMap<String, WatiConfig>,
    pub nextcloud_talk: HashMap<String, NextcloudTalkConfig>,
    pub email: HashMap<String, EmailConfig>,
    pub gmail_push: HashMap<String, GmailPushConfig>,
    pub irc: HashMap<String, IrcConfig>,
    pub twitch: HashMap<String, TwitchConfig>,
    pub lark: HashMap<String, LarkConfig>,
    pub line: HashMap<String, LineConfig>,
    pub dingtalk: HashMap<String, DingTalkConfig>,
    pub wecom: HashMap<String, WeComConfig>,
    pub wecom_ws: HashMap<String, WeComWsConfig>,
    pub wechat: HashMap<String, WeChatConfig>,
    pub qq: HashMap<String, QQConfig>,
    pub twitter: HashMap<String, TwitterConfig>,
    pub mochat: HashMap<String, MochatConfig>,
    pub nostr: HashMap<String, NostrConfig>,
    pub clawdtalk: HashMap<String, ClawdTalkConfig>,
    pub reddit: HashMap<String, RedditConfig>,
    pub bluesky: HashMap<String, BlueskyConfig>,
    pub git: HashMap<String, GitConfig>,
    pub voice_call: HashMap<String, VoiceCallConfig>,
    pub voice_wake: HashMap<String, VoiceWakeConfig>,
    pub voice_duplex: HashMap<String, VoiceDuplexConfig>,
    pub mqtt: HashMap<String, MqttConfig>,
    pub amqp: HashMap<String, AmqpConfig>,
    pub filesystem: HashMap<String, FilesystemConfig>,
    pub message_timeout_secs: u64,
    pub max_concurrent_per_channel: usize,
    pub ack_reactions: bool,
    pub show_tool_calls: bool,
    pub session_persistence: bool,
    pub session_backend: String,
    pub session_ttl_hours: u32,
    pub debounce_ms: u64,
}

Top-level channel configurations ([channels] section).

each channel type is a keyed table of named instances (aliases). [channels.telegram.default] is the conventional single-instance key. Access via config.channels.telegram.get("default").

Fields

cli: bool

Enable the CLI interactive channel. Default: true.

telegram: HashMap<String, TelegramConfig>

Telegram bot channel instances ([channels.telegram.<alias>]).

discord: HashMap<String, DiscordConfig>

Discord bot channel instances ([channels.discord.<alias>]).

slack: HashMap<String, SlackConfig>

Slack bot channel instances ([channels.slack.<alias>]).

mattermost: HashMap<String, MattermostConfig>

Mattermost bot channel instances ([channels.mattermost.<alias>]).

webhook: HashMap<String, WebhookConfig>

Webhook channel instances ([channels.webhook.<alias>]).

imessage: HashMap<String, IMessageConfig>

iMessage channel instances ([channels.imessage.<alias>], macOS only).

matrix: HashMap<String, MatrixConfig>

Matrix channel instances ([channels.matrix.<alias>]).

signal: HashMap<String, SignalConfig>

Signal channel instances ([channels.signal.<alias>]).

whatsapp: HashMap<String, WhatsAppConfig>

WhatsApp channel instances ([channels.whatsapp.<alias>]).

linq: HashMap<String, LinqConfig>

Linq Partner API channel instances ([channels.linq.<alias>]).

wati: HashMap<String, WatiConfig>

WATI WhatsApp Business API channel instances ([channels.wati.<alias>]).

nextcloud_talk: HashMap<String, NextcloudTalkConfig>

Nextcloud Talk bot channel instances ([channels.nextcloud_talk.<alias>]).

email: HashMap<String, EmailConfig>

Email channel instances ([channels.email.<alias>]).

gmail_push: HashMap<String, GmailPushConfig>

Gmail Pub/Sub push notification channel instances ([channels.gmail_push.<alias>]).

irc: HashMap<String, IrcConfig>

IRC channel instances ([channels.irc.<alias>]).

twitch: HashMap<String, TwitchConfig>

Twitch chat channel instances ([channels.twitch.<alias>]).

lark: HashMap<String, LarkConfig>

Lark channel instances ([channels.lark.<alias>]).

line: HashMap<String, LineConfig>

LINE Messaging API channel instances ([channels.line.<alias>]).

dingtalk: HashMap<String, DingTalkConfig>

DingTalk channel instances ([channels.dingtalk.<alias>]).

wecom: HashMap<String, WeComConfig>

WeCom (WeChat Enterprise) Bot Webhook channel instances ([channels.wecom.<alias>]).

wecom_ws: HashMap<String, WeComWsConfig>

WeCom AI Bot WebSocket channel instances ([channels.wecom_ws.<alias>]).

wechat: HashMap<String, WeChatConfig>

WeChat personal iLink Bot channel instances ([channels.wechat.<alias>]).

qq: HashMap<String, QQConfig>

QQ Official Bot channel instances ([channels.qq.<alias>]).

twitter: HashMap<String, TwitterConfig>

X/Twitter channel instances ([channels.twitter.<alias>]).

mochat: HashMap<String, MochatConfig>

Mochat customer service channel instances ([channels.mochat.<alias>]).

nostr: HashMap<String, NostrConfig>

clawdtalk: HashMap<String, ClawdTalkConfig>

ClawdTalk voice channel instances ([channels.clawdtalk.<alias>]).

reddit: HashMap<String, RedditConfig>

Reddit channel instances ([channels.reddit.<alias>]).

bluesky: HashMap<String, BlueskyConfig>

Bluesky channel instances ([channels.bluesky.<alias>]).

git: HashMap<String, GitConfig>

Git-forge channel instances ([channels.git.<alias>]). GitHub is the first provider; the provider field selects the forge.

voice_call: HashMap<String, VoiceCallConfig>

Voice call channel instances ([channels.voice_call.<alias>]).

voice_wake: HashMap<String, VoiceWakeConfig>

Voice wake word detection channel instances ([channels.voice_wake.<alias>]).

voice_duplex: HashMap<String, VoiceDuplexConfig>

Voice duplex instances ([channels.voice_duplex.<alias>]).

mqtt: HashMap<String, MqttConfig>

MQTT channel instances ([channels.mqtt.<alias>]).

amqp: HashMap<String, AmqpConfig>

AMQP channel instances ([channels.amqp.<alias>]).

filesystem: HashMap<String, FilesystemConfig>

Filesystem SOP listener instances ([channels.filesystem.<alias>]).

message_timeout_secs: u64

Base timeout in seconds for processing a single channel message (LLM + tools). Runtime uses this as a per-turn budget that scales with tool-loop depth (up to 4x, capped) so one slow/retried model call does not consume the entire conversation budget. Default: 300s for on-device LLMs (Ollama) which are slower than cloud APIs.

max_concurrent_per_channel: usize

Per-channel multiplier for the global channel message in-flight budget. Runtime multiplies this value by the configured channel count, then applies its global minimum and maximum bounds to one shared dispatcher semaphore. Default: 4.

ack_reactions: bool

Whether to add acknowledgement reactions (👀 on receipt, ✅/⚠️ on completion) to incoming channel messages. Default: true.

show_tool_calls: bool

Whether to send tool-call notification messages (e.g. 🔧 web_search_tool: …) to channel users. When false, tool calls are still logged server-side but not forwarded as individual channel messages. Default: false.

session_persistence: bool

Persist channel conversation history to JSONL files so sessions survive daemon restarts. Files are stored in {workspace}/sessions/. Default: true.

session_backend: String

Session persistence backend: "jsonl" (legacy) or "sqlite" (new default). SQLite provides FTS5 search, metadata tracking, and TTL cleanup.

session_ttl_hours: u32

Auto-archive stale sessions older than this many hours. 0 disables. Default: 0.

debounce_ms: u64

Inbound message debounce window in milliseconds. When a sender fires multiple messages within this window, they are accumulated and dispatched as a single concatenated message. 0 disables debouncing. Default: 0.

Implementations

impl ChannelsConfig

pub fn configurable_prefix() -> &'static str

Returns the #[prefix] value for this Configurable struct.

pub fn secret_fields(&self) -> Vec<SecretFieldInfo>

Returns metadata about all #[secret] fields on this struct and nested children.

pub fn secret_field_terminals() -> Vec<&'static str>

pub fn encrypt_secrets(&mut self, store: &SecretStore) -> Result<(), Error>

Encrypt all secret fields in place using the provided store.

pub fn decrypt_secrets(&mut self, store: &SecretStore) -> Result<(), Error>

Decrypt all secret fields in place using the provided store.

pub fn set_secret(&mut self, name: &str, value: String) -> Result<(), Error>

Set a secret field by its full dotted name, dispatching to nested children.

pub fn prop_fields(&self) -> Vec<PropFieldInfo>

Returns metadata about all property fields on this struct and nested children.

pub fn get_prop(&self, name: &str) -> Result<String, Error>

Get a property value by its full dotted name, returning it as a display string.

pub fn set_prop(&mut self, name: &str, value_str: &str) -> Result<(), Error>

Set a property value by its full dotted name, parsing from string.

pub fn prop_is_secret(name: &str) -> bool

Check if a property name refers to a secret field (static, no instance needed).

pub fn init_defaults(&mut self, prefix: Option<&str>) -> Vec<&'static str>

Instantiate None nested sections whose prefix matches. Returns the prefixes that were initialized.

pub fn map_key_sections() -> Vec<MapKeySection>

Enumerate every map-keyed (HashMap<String, T>) and list-shaped (Vec<T>) section discoverable from this Configurable’s tree. The dashboard / CLI consume this to surface “+ Add” affordances without hardcoding the section list.

pub fn nested_section_help(name: &str) -> Option<&'static str>

Help blurb for a #[nested] field on this struct, sourced from the field-level /// docstring. Returns None for unknown names so callers can fall through to a different lookup.

pub fn nested_section_group(name: &str) -> Option<&'static str>

pub fn get_map_keys(&self, section_path: &str) -> Option<Vec<String>>

Return the current alias keys at section_path, or None if the path doesn’t resolve to a map-keyed section in this tree.

pub fn nested_option_entries(&self) -> Vec<NestedOptionEntry>

pub fn create_map_key( &mut self, section_path: &str, map_key: &str, ) -> Result<bool, String>

pub fn delete_map_key( &mut self, section_path: &str, map_key: &str, ) -> Result<bool, String>

pub fn rename_map_key( &mut self, section_path: &str, map_key: &str, new_key: &str, ) -> Result<bool, String>

impl ChannelsConfig

pub fn channels(&self) -> Vec<ChannelInfo>

Returns metadata and configuration status for every known channel type.

Always returns the full set of channel types regardless of compile-time feature flags — the configured flag reflects whether the operator has populated that channel’s config section. For a list restricted to only the channels compiled into this binary use zeroclaw_channels::listing::compiled_channels instead.

pub fn has_any_enabled(&self) -> bool

Returns true when at least one channel entry across all channel types has enabled = true. Used by the daemon to decide whether the channels supervisor should be started — a config with only enabled = false entries (e.g. partially-configured or disabled bots) must not start the supervisor, otherwise it exits immediately and restarts in a tight loop.

pub fn channel_presence(&self) -> [(&'static str, bool, bool); 36]

One (canonical_name, configured, deliverable) row per channel in the registry. Single source for name-addressed channel lookups so no surface has to hardcode a subset of the channel list. deliverable is false for input-only transports whose Channel::send is a no-op (mqtt and amqp are fan-in listeners; voice_wake is input-only), so a name-addressed outbound surface such as heartbeat.target can refuse them at validation instead of accepting a target the delivery layer silently drops.

pub fn is_channel_configured(&self, name: &str) -> bool

Whether a channel named name (case-insensitive) is a known channel with at least one configured instance. Used by name-addressed surfaces (e.g. heartbeat.target) without hardcoding a subset of the registry.

pub fn is_known_channel(&self, name: &str) -> bool

Whether name (case-insensitive) names a channel in the registry, regardless of whether it is configured.

pub fn is_channel_deliverable(&self, name: &str) -> bool

Whether name (case-insensitive) names a channel that can actually deliver an outbound message. Input-only transports (mqtt, amqp, voice_wake) are known and may be configured, but their Channel::send is a no-op, so they are not valid outbound targets.

Trait Implementations

impl Clone for ChannelsConfig

fn clone(&self) -> ChannelsConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ChannelsConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for ChannelsConfig

fn default() -> ChannelsConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ChannelsConfig

fn deserialize<__D>( __deserializer: __D, ) -> Result<ChannelsConfig, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for ChannelsConfig

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl MaskSecrets for ChannelsConfig

fn mask_secrets(&mut self)

fn restore_secrets_from(&mut self, current: &ChannelsConfig)

impl Serialize for ChannelsConfig

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.