• Python 3.10+
• uv (recommended package manager)
• A Circle API key and Entity Secret from Circle Console

```bash pip install omniclaw ```

```bash git clone https://github.com/omnuron/omniclaw.git cd omniclaw uv sync --extra dev ```

Create a `.env` file in your project root:

```bash

CIRCLE_API_KEY=your_circle_api_key ENTITY_SECRET=your_entity_secret

OMNICLAW_RPC_URL=https://sepolia.base.org ```

```bash omniclaw doctor # Verify credentials and connectivity omniclaw env # List all configured environment variables ```

```python from omniclaw import OmniClaw, Network

client = OmniClaw(network=Network.BASE_SEPOLIA) wallet = client.create_wallet()

sim = client.simulate(wallet_id=wallet.id, to="recipient", amount=1.00)

result = client.pay(wallet_id=wallet.id, to="recipient", amount=1.00) ```

OmniClaw uses Circle's entity secret model. The `ENTITY_SECRET` is the signing secret needed to create wallets and sign transactions. The Circle recovery file is stored in `~/.config/omniclaw/` on Linux.

Important: If you lose both the entity secret and the recovery file, account recovery requires Circle-side reset steps.

• Architecture — understand how OmniClaw is structured
• API Reference — explore all SDK methods
• Contributing Guide — set up your dev environment