omniclaw  by omnuron

Enables autonomous agents to conduct secure, policy-controlled economic transactions

Created 4 months ago
573 stars

Top 55.6% on SourcePulse

GitHubView on GitHub
Project Summary

Summary

OmniClaw provides a policy-controlled payment network designed for autonomous agents, enabling secure, gasless, and real-money transactions at machine speed. It addresses the critical security and operational challenges of using software agents for economic activities, offering a robust solution for programmatic payments where traditional wallets fall short due to key exposure risks and speed limitations.

How It Works

The system employs a two-part architecture: a Financial Policy Engine run by the owner, which securely holds private keys and enforces spending policies defined in policy.json, and a thin CLI client used by the agent. This separation ensures agents never access private keys, mitigating risks of wallet drainage. Payments are facilitated via Circle's Gateway using the EIP-3009 protocol, enabling gasless nanopayments with instant settlement, making high-frequency agent-to-agent commerce economically viable.

Quick Start & Requirements

Installation is straightforward via pip install omniclaw. Key requirements include setting several environment variables: OMNICLAW_PRIVATE_KEY (agent's signing key), OMNICLAW_AGENT_TOKEN (from policy.json), OMNICLAW_AGENT_POLICY_PATH (path to policy file), and CIRCLE_API_KEY. Network configuration (OMNICLAW_NETWORK, OMNICLAW_RPC_URL) is also necessary. The Financial Policy Engine is started with uvicorn omniclaw.agent.server:app --port 8080, and the CLI is configured using omniclaw-cli configure. Official documentation is available for agent setup, skills, features, and policy reference.

Highlighted Details

  • Gasless Nanopayments: Utilizes Circle Gateway and EIP-3009 for sub-cent, instant, gas-free transactions, crucial for high-frequency agent commerce.
  • Policy-Driven Security: Enforces granular spending limits and recipient controls via policy.json, safeguarding assets.
  • Agentic Execution Layer: Separates sensitive key management from agent operations, preventing direct key exposure.
  • Bidirectional Commerce: Supports agents acting as both payers and receivers, with the ability to expose services via the x402 protocol.

Maintenance & Community

The project is licensed under MIT by Omnuron AI. Specific details regarding community channels (e.g., Discord, Slack), active contributors, sponsorships, or a public roadmap are not detailed in the provided README.

Licensing & Compatibility

The project is released under the MIT license, which is permissive and generally allows for commercial use, modification, and distribution, including integration into closed-source applications.

Limitations & Caveats

The README indicates that the nanopayment functionality, specifically CAIP-2 derivation, is EVM-only. No other explicit limitations, alpha/beta status, or known bugs are mentioned.

Health Check
Last Commit

1 month ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
3
Star History
1 stars in the last 30 days

Explore Similar Projects

Starred by Chip Huyen Chip Huyen(Author of "AI Engineering", "Designing Machine Learning Systems"), Travis Fischer Travis Fischer(Founder of Agentic), and
2 more.

agentkit by coinbase

0.5%
1k
SDK for AI agents to interact with crypto wallets and onchain
Created 1 year ago
Updated 1 week ago
Feedback? Help us improve.