All notable changes to OmniClaw are documented here.
The format is based on Keep a Changelog, and this project follows Semantic Versioning.
- Added the owner/operator
omniclaw facilitator exactcommand for self-hosted x402 exact settlement. - Added public facilitator documentation covering Circle Gateway, external facilitators, and OmniClaw self-hosted exact settlement.
- Added Arc Testnet exact-settlement support documentation using CAIP-2
eip155:5042002. - Added B2B SDK examples for vendor APIs, machine-to-vendor payments, external exact facilitators, and self-hosted exact settlement.
- Added a public
.env.examplewith role-based configuration for agents, vendors, facilitators, Circle Gateway, Thirdweb, and production hardening.
- Moved the owner/operator CLI entrypoint to
omniclaw.admin_cli:mainso it no longer conflicts with theomniclaw.cliagent CLI package. - Updated release artifact verification for the new admin CLI module and package layout.
- Reworked public README and docs around agent buyer, SDK buyer, vendor SDK seller, Financial Policy Engine, and facilitator deployment paths.
- Updated the OmniClaw CLI skill to require idempotency keys for x402 URL payments.
- Bumped runtime and shipped CLI skill metadata to
0.0.6.
- Added a release verification gate so broken wheels are caught before upload.
- Added artifact checks for
omniclaw/__init__.py,omniclaw/cli.py,omniclaw/cli_agent.py, and console entrypoints. - Added a clean-room smoke install step for built wheels.
- Bumped runtime version metadata to
0.0.5.
- "Financial Firewall" Model: Full production hardening with strict Owner/Agent role isolation.
- Premium Agent CLI: New
status,ledger, andservecommands foromniclaw-cli. - Automated x402: Agents now autonomously handle HTTP 402 "Payment Required" flows.
- Zero-Friction Onboarding: Automated entity secret generation and smart wallet preparation.
- Service Exposure: Agents can now expose their own payment-gated services using
omniclaw-cli serve. - Idempotency & Safety: Mandatory idempotency keys for all payments and automated "simulate-first" dry-runs.
- Refactored
SKILL.mdto the 2026 High-Fidelity standard for AI agents. - Consolidated all agent onboarding into a single
bootstrap.shself-onboarding script. - Simplified Owner deployment to a single
docker compose upflow.
0.0.3 - 2026-03-25
- Multi-facilitator support: Circle Gateway, Coinbase CDP, OrderN, RBX, Thirdweb
- Seller SDK: Full seller-side SDK for accepting x402 payments
- Trust Gate: ERC-8004 based identity and reputation verification
- Payment Intents: 2-phase commit with fund reservation
- Enhanced buyer SDK with smart payment routing
- Rewrote the top-level documentation set for launch readability.
- Reduced README scope to the actual SDK entry points and runtime contract.
- Split docs by purpose: usage guide, API reference, architecture, and cross-chain usage.
- Removed stale or duplicate SDK markdown that conflicted with the current codebase.
- Documented the strict Redis environment contract around
OMNICLAW_REDIS_URL. - Documented trust-gate behavior so explicit trust checks require a real
OMNICLAW_RPC_URL. - Brought SDK-facing docs in line with the current async client surface and wallet flows.
- Fixed duplicate methods, test issues, and lint errors.
- SDK unit suite passes with
1168tests intests/. - All lint checks pass (0 errors).
0.0.2 - 2026-01-22
- Initial public alpha of the OmniClaw SDK.
- Core payment client, wallet management, routing, guards, intents, ledger, and webhook support.
- Transfer, x402, and cross-chain adapter support.
- Onboarding helpers for Circle entity secret setup.
- Requires Python
3.10+. - Requires Circle Web3 Services credentials.