Skip to content

[OMEGA-391] [OMEGA-392] Rename OmegaClaw to Omega - #331

Merged
TossSky merged 12 commits into
singnet:mainfrom
sassless:rename/omega-391-392
Sep 1, 2026
Merged

[OMEGA-391] [OMEGA-392] Rename OmegaClaw to Omega#331
TossSky merged 12 commits into
singnet:mainfrom
sassless:rename/omega-391-392

Conversation

@TossSky

@TossSky TossSky commented Aug 31, 2026

Copy link
Copy Markdown
Collaborator

Closes OMEGA-391 and OMEGA-392 of epic OMEGA-387.

The project name moves from OmegaClaw to Omega across the code base, the scripts and the documentation. Nothing is left carrying the old name except the SonarCloud key, which holds a server-issued UUID and can only change when the project is recreated under the new organisation.

What changed

Launcher and runtime names. scripts/omegaclaw becomes scripts/omega, the container becomes omega, the volume becomes omega-memory, and the default IRC channel becomes ##omega.

Environment variables. Everything moves to the OMEGA_ prefix: the config lookup prefix, OMEGA_AUTH_SECRET, OMEGA_OPENCLAW_TOKEN, OMEGA_CONTAINER, OMEGA_IRC_CHANNEL, OMEGA_GIT_TOKEN, OMEGA_DIR and the AUTOTESTS_OMEGA_* pair in CI. Note that OMEGA_OPENCLAW_TOKEN keeps its OPENCLAW segment on purpose, since OpenClaw is a separate product and is untouched throughout.

Plugin API. The entry point is now loadOmegaPlugin, in both loaders (Python, MeTTa) and in every in-tree channel, provider and plugin. Documented in reference-plugin-api.md.

MeTTa side. lib_omegaclaw.metta becomes lib_omega.metta, the library alias becomes Omega, the agent entry function becomes (omega), and run.metta points git-import! at singnet/Omega.

In-image layout. OMEGA_DIR is /PeTTa/repos/Omega, followed by MEMORY_DIR, the entrypoint allowlist, the Landlock grant in profile/policy.yaml, the ENTRYPOINT, and the hardcoded paths in the test harness.

Licence. The disclaimer in the README and the launcher named the MIT licence, while NOTICE records the move to Apache 2.0 in July. Corrected to match.

Version string. The agent reports Omega version=. Three call sites reference that function by string rather than as an identifier, in the launcher, the Dockerfile and src/skills.metta; all three moved with it.

Documentation. 23 markdown files, plus the six README PDFs under Autotests/. Those held 118 occurrences that no text search reaches, including instructions for a launcher and variables this PR deletes. Three of them had no markdown source in the repository at all, so the sources are added and the PDFs are removed, since they only duplicated them.

CI. Only what would otherwise break in autotests.yml: the script path, the env var names, the container name in the readiness polling, and the asserted version literal. The rest of the configuration sweep belongs to OMEGA-390.

Breaking changes

No compatibility shims are kept. Out-of-tree plugins that still define loadOmegaClawPlugin will not load: Python ones fail loudly at startup, MeTTa ones fail silently, logging "Plugin X is loaded" while none of their skills register. Operators exporting OMEGACLAW_* variables will find them ignored, and the config lookup falls through to the config file rather than erroring. Existing installations keep a container named omegaclaw and a volume omegaclaw-memory, which the new launcher never touches, so the agent starts on a fresh volume and previous memory stays in the old one.

Verification

Built from this branch and run end to end:

  • tests/mettatest.sh in the container: 6 suites, 38 asserts, 0 failures.
  • tests/pytest.sh on the host: 12 passed.
  • Autotests Phase 1 @run_mandatory: 125 passed, 0 skipped, 0 failed.
  • Host launcher and image entrypoint report the same version string.
  • Agent ready in 19s.
  • The six README PDFs are gone, their markdown sources carry no occurrence of the old name.

git-import! now points at a repository that had not been created when this work started. It does not clone: the Dockerfile copies the sources in, so the alias and the in-image path resolve locally.

Still open

sonar-project.properties deliberately keeps the old project key. It carries a UUID issued by the server when the project was created, so it cannot be rewritten blind; the project has to be recreated under the new organisation and the key copied from there. The analysis is skipped on this PR by design, since the shared workflow skips any pull request whose head is a fork, so it will first run on merge to main and will report against the old project until the key moves. Renovate is the same class of thing: the slug is updated here, but the GitHub App is still installed on the old organisation. Both belong to OMEGA-390.

docs/assets/banner.png still renders the old wordmark and is the first element of the README. Only the alt text moved. It needs the brand asset regenerated, along with a decision on whether the claw mascot stays.

TossSky added 10 commits August 31, 2026 00:51
Work in progress, the tree is not consistent yet:
- src/ still resolves the old plugin entry point, so no plugin loads
- docs/, README.md and tests/ are not renamed yet
…string

Keep the pre-rename names working for one release:
- loadOmegaClawPlugin is still accepted by both plugin loaders
- OMEGACLAW_<key> is still read by the config lookup
- version files written by pre-rename images are still parsed
Point repository and image references at singnet/Omega and
singularitynet/omega, noting that both are not published yet.
…names

- remove the loadOmegaClawPlugin, OMEGACLAW_ prefix, auth secret and version
  fallbacks, and the scripts/omegaclaw shim
- move the library alias and in-image path to /PeTTa/repos/Omega
- point git-import, the Docker image, Sonar and Renovate at the new names
- the note about unpublished names had those names replaced into it, so it
  told readers to use what it had just called unavailable
- no released tag ships scripts/omega, so the pinned example no longer names
  a specific old version
- the Sonar key carries a server-issued UUID and cannot be guessed; it moves
  when the project is recreated under the new organisation
…ources

The six PDFs held 118 occurrences of the old name that no text search could
reach, including instructions for a launcher and variables this branch removed.
Three had no source in the repository at all, so the markdown is added and the
PDFs are now rendered from it.
@anseliv anseliv self-assigned this Aug 31, 2026
@anseliv anseliv added the in-jira The issue has been accepted for fixing label Aug 31, 2026
@anseliv
anseliv self-requested a review August 31, 2026 12:15

@anseliv anseliv left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

PDF files should be removed if we have .md to avoid duplication.

Comment thread scripts/omega
Comment thread README.md
- the markdown sources cover all six, so the PDFs only duplicated them
- the disclaimer named the MIT licence while the project moved to
  Apache 2.0 in NOTICE
@TossSky
TossSky requested a review from anseliv September 1, 2026 09:45

@anseliv anseliv left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good. I think we are ready to merge this

@TossSky
TossSky merged commit 4fd0975 into singnet:main Sep 1, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

in-jira The issue has been accepted for fixing

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants