Oma is the first Telegram agent built on the OmegaClaw framework. Interacting with Oma is the fastest way to experience what we’re building with OmegaClaw.
OmegaClaw is a neural-symbolic agent framework built on the Hyperon AGI stack. It unifies large language models with a formal symbolic layer to create a stateful cognitive architecture capable of auditable inference, autonomous self-improvement, and long-term persistence.
Unlike reactive, session-based agents, OmegaClaw operates in a continuous execution loop, managing its own goals and providing auditable proof trails for its reasoning.
The primary design criteria for OmegaClaw were simplicity, ease of extension, and transparent implementation. This results in a minimalist MeTTa-based core of approximately 200 lines of code.
Prerequisites: Git, Python3, Pip and venv library
Get SWI-Prolog 9.1.12 or later.
Install OmegaClaw:
git clone https://github.com/trueagi-io/PeTTa
cd PeTTa
mkdir -p repos
git clone https://github.com/asi-alliance/OmegaClaw-Core.git repos/OmegaClaw-Core
git clone https://github.com/patham9/petta_lib_chromadb.git repos/petta_lib_chromadb
cp repos/OmegaClaw-Core/run.metta ./
Setup Python virtual environment (or use your own):
python3 -m venv ./.venv
source ./.venv/bin/activate
If you have CPU only machine or don't want calculate embeddings on GPU:
python3 -m pip install --index-url https://download.pytorch.org/whl/cpu torch
Install Python dependencies:
python3 -m pip install -r ./repos/OmegaClaw-Core/requirements.txt
Before running the system you need to choose your LLM API provider and export the API key as the environment variable.
| Provider | Env var name | Notes |
|---|---|---|
Anthropic (default) |
ANTHROPIC_API_KEY |
Claude models via the Anthropic API. |
OpenAI |
OPENAI_API_KEY |
GPT models. Also reused by the OpenAI embedding provider below. |
ASICloud |
ASI_API_KEY |
MiniMax models via ASI Alliance inference endpoint (inference.asicloud.cudos.org). |
ASIOne |
ASIONE_API_KEY |
ASI1 Ultra model via ASI:One inference endpoint (https://api.asi1.ai/v1). |
Ollama-local |
OLLAMA_API_KEY |
Ollama model via local inference endpoint. API endpoint is set via LLM_SERVER_LOCAL_URL environment variables. |
OpenRouter |
OPENROUTER_API_KEY |
GLM model via OpenRouter inference endpoint. |
Run the system via the following command which ensures the system is started from the root folder of PeTTa:
OMEGACLAW_AUTH_SECRET=<channel-secret> sh run.sh run.metta IRC_channel="<irc-channel>"
After start go to https://webchat.quakenet.org/ to communicate with the agent. Join <irc-channel> and after agent is joined send auth <channel-secret> message to authenticate yourself as an agent owner. Please replace <irc-channel> and <channel-secret> by your own values.
| Parameter | Default | Meaning |
|---|---|---|
maxNewInputLoops |
50 | Turns the agent keeps running after a new human message before idling (seconds) |
maxWakeLoops |
1 | Extra turns granted on each scheduled wake-up |
sleepInterval |
1 | Delay between loop iterations (seconds) |
wakeupInterval |
600 | How long idle before the next scheduled wake-up (seconds) |
LLM |
gpt-5.4 |
Model identifier passed to the provider (used with OpenAI provider only) |
provider |
Anthropic |
LLM provider, see the table of the providers above |
maxOutputToken |
6000 | Output cap passed to the provider |
reasoningMode |
medium |
Reasoning-effort hint passed to the provider (OpenAI only) |
| Parameter | Default | Meaning |
|---|---|---|
maxFeedback |
50000 | Ceiling on LAST_SKILL_USE_RESULTS text fed back into the prompt (chars) |
maxRecallItems |
20 | Items returned by query |
maxEpisodeRecallLines |
20 | Lines returned by episodes |
maxHistory |
30000 | Tail of memory/history.metta included in the prompt (chars) |
embeddingprovider |
Local |
Local (Python-side model) or OpenAI (requires OPENAI_API_KEY) |
| Parameter | Default | Meaning |
|---|---|---|
commchannel |
irc |
Type of the communication channel for agent to use - irc, telegram, mattermost or slack |
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_BOT_TOKEN |
Telegram bot token. | |
TG_CHAT_ID |
Optional Telegram chat ID. If empty, OmegaClaw auto-binds after first valid inbound auth/message. | |
TG_POLL_TIMEOUT |
20 | Telegram polling timeout in seconds. |
SL_BOT_TOKEN |
Slack bot token (xoxb-...). |
|
SL_CHANNEL_ID |
Optional Slack channel ID (for example C0123456789). If empty, OmegaClaw auto-binds on first successful auth message. |
|
SL_POLL_INTERVAL |
60 | Slack polling interval in seconds (minimum effective value is 60). |
MM_URL |
https://chat.singularitynet.io |
Mattermost base URL. |
MM_CHANNEL_ID |
8fjrmabjx7gupy7e5kjznpt5qh |
Mattermost channel ID. |
MM_BOT_TOKEN |
Mattermost bot token. |
Full documentation lives in docs/: introduction,
tutorials, and API reference as a flat set of markdown files.
OmegaClaw is experimental, open-source software developed by SingularityNET Foundation, a Swiss foundation, and distributed and promoted by Superintelligence Alliance Ltd., a Singapore company (collectively, the "Parties"), and is provided "AS IS" and "AS AVAILABLE," without warranty of any kind, express or implied, including but not limited to the implied warranties of merchantability, fitness for a particular purpose, and non-infringement. OmegaClaw is an autonomous AI agent that is designed to independently set goals, make decisions, and take actions (including actions that the user did not specifically request or anticipate) and whose behavior is influenced by large language models provided by third parties, the outputs of which are inherently non-deterministic. Depending on its configuration and the permissions granted to it, OmegaClaw may execute operating-system shell commands, read, write, modify, or delete files, access network resources, send and receive messages through connected communication channels, and modify its own skills, memory, and operational logic at runtime. OmegaClaw may also be susceptible to prompt injection and other adversarial manipulation techniques whereby malicious content embedded in data sources consumed by the agent could influence its behavior in unintended ways. OmegaClaw supports third-party skills and extensions that have not necessarily been reviewed, audited, or endorsed by either of the Parties and that may introduce security vulnerabilities, cause data loss, or result in unintended behavior including data exfiltration. OmegaClaw relies on third-party services, including large language model providers, whose availability, accuracy, cost, and conduct are outside the control of the Parties and whose use is subject to their respective terms, conditions, and privacy policies. The user is solely responsible for configuring appropriate access controls, sandboxing, and permission boundaries, for monitoring, supervising, and constraining OmegaClaw's actions, for ensuring that no sensitive personal data is exposed to the agent without adequate safeguards, and for all actions taken by OmegaClaw on the user's systems or on the user's behalf, including communications sent and files modified. The user is strongly advised to run OmegaClaw in an isolated environment with the minimum permissions necessary for the intended use case. To the maximum extent permitted by applicable law, in no event shall the Parties, their respective board members, directors, contributors, employees, or affiliates be liable for any direct, indirect, incidental, special, consequential, or exemplary damages (including but not limited to damages for loss of data, loss of profits, business interruption, unauthorized transactions, reputational harm, or any damages arising from the autonomous actions taken by OmegaClaw) however caused and on any theory of liability, whether in contract, strict liability, or tort (including negligence or otherwise), even if advised of the possibility of such damages. By downloading, installing, running, or otherwise using OmegaClaw, the user acknowledges that they have read, understood, and agreed to this disclaimer in its entirety. This disclaimer supplements but does not replace the terms of the MIT License under which OmegaClaw is released.