Skip to content

reference-configuration.md

Latest commit

 

History

History
72 lines (56 loc) · 3.18 KB

reference-configuration.md

File metadata and controls

72 lines (56 loc) · 3.18 KB
Raw

Reference — Configuration

Every tunable in OmegaClaw is declared as (= (name) (empty)) and later bound by a configure call inside an init* function. The configure helper in src/utils.metta is:

(= (configure $name $default)
   (let $value (argk $name $default)
        (add-atom &self (= ($name) $value))))

This reads a command-line override via argk (name=value on the MeTTa command line) if present, otherwise falls back to the default.

Loop (src/loop.metta, initLoop)

Parameter Default Meaning
maxNewInputLoops 50 How many turns the agent keeps running after a new human message before idling.
maxWakeLoops 1 Extra turns granted on each scheduled wake-up.
sleepInterval 1 (seconds) Delay between loop iterations.
LLM gpt-5.4 Model identifier passed to the provider.
provider Anthropic LLM provider — Anthropic, OpenAI, ASICloud, or ASIOne.
maxOutputToken 6000 Output cap passed to the provider.
reasoningMode medium Reasoning-effort hint passed to the provider.
wakeupInterval 600 (seconds) How long idle before the next scheduled wake-up.

Memory (src/memory.metta, initMemory)

Parameter Default Meaning
maxFeedback 50000 (chars) Ceiling on LAST_SKILL_USE_RESULTS text fed back into the prompt.
maxRecallItems 20 Items returned by query.
maxEpisodeRecallLines 20 Lines returned by episodes.
maxHistory 30000 (chars) Tail of memory/history.metta included in the prompt.
embeddingprovider Local Local (Python-side model) or OpenAI.

Channels (src/channels.metta, initChannels)

Parameter Default Meaning
commchannel irc Active channel — irc, telegram, slack, or mattermost.
IRC_channel ##omegaclaw IRC channel to join.
IRC_server irc.quakenet.org IRC server hostname.
IRC_port 6667 IRC port.
IRC_user omegaclaw IRC nickname.
TG_CHAT_ID (empty — auto-bind supported) Optional fixed Telegram chat ID. Leave empty to auto-bind on first valid inbound auth/message.
TG_POLL_TIMEOUT 20 Telegram long-poll timeout in seconds.
SL_CHANNEL_ID (empty — auto-bind supported) Optional Slack channel ID where OmegaClaw reads/writes messages. Leave empty to auto-bind on first valid inbound auth/message.
SL_POLL_INTERVAL 60 Slack poll interval in seconds (minimum effective value is 60).
MM_URL https://chat.singularitynet.io Mattermost base URL.
MM_CHANNEL_ID 8fjrmabjx7gupy7e5kjznpt5qh Target channel ID.
Environment variable Meaning
TG_BOT_TOKEN Telegram bot token (from BotFather).
MM_BOT_TOKEN Bot auth token.
SL_BOT_TOKEN Slack bot token (xoxb-...).

Command-line overrides

Any configured parameter can be overridden at startup:

metta run.metta provider=Anthropic LLM=claude-opus-4-6 commchannel=mattermost

Slack example:

SL_BOT_TOKEN=xoxb-... metta run.metta commchannel=slack SL_CHANNEL_ID=C0123456789

The argk helper parses key=value pairs from argv.