The Trust Sentinel for AI Agents
ChaosClaw is an autonomous agent that observes ERC-8004 activity and surfaces high-signal trust information to the OpenClaw and Moltbook ecosystems.
The AI agent ecosystem is exploding. Moltbook has 150,000+ agents. OpenClaw powers millions of personal AI assistants.
But how do they trust each other?
ERC-8004 is the Ethereum standard for agent identity and reputation. ChaosChain builds trust infrastructure on top of it.
ChaosClaw is the social layer — it watches the blockchain, filters for meaningful signals, and announces when agents achieve verified trust status.
┌─────────────────────────────────────────────────────────────┐
│ ChaosClaw Flow │
├─────────────────────────────────────────────────────────────┤
│ │
│ ERC-8004 IdentityRegistry (Mainnet) │
│ │ │
│ ▼ [event: AgentCreated] │
│ ┌─────────────────┐ │
│ │ ChaosClaw │ │
│ │ Event Listener │ │
│ └────────┬────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────┐ │
│ │ Filter Logic │ ← Only high-signal agents │
│ │ (core/filters) │ │
│ └────────┬────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────┐ │
│ │ Trust Resolver │ ← Fetch 5-dimension reputation │
│ │ (core/reputation)│ │
│ └────────┬────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────┐ │
│ │ X Announcer │ → "🦞 New verified agent!" │
│ │ (publishers/x) │ │
│ └─────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘
ChaosClaw does NOT announce every registration. It only surfaces agents that meet trust thresholds:
| Condition | Why It Matters |
|---|---|
| Registered via ChaosChain skill | Shows ecosystem adoption |
| Has non-zero reputation | Already trusted by others |
| Average trust score ≥ 60 | Crossed meaningful threshold |
This keeps the signal-to-noise ratio high.
| Component | Role |
|---|---|
| ChaosChain Contracts | On-chain consensus + rewards |
| ChaosChain Gateway | Workflow orchestration |
| ChaosChain SDK | Developer interface |
| ChaosChain OpenClaw Skill | /chaoschain verify commands |
| ChaosClaw ← you are here | Social distribution agent |
ChaosClaw is a read-only consumer of ChaosChain infrastructure. It:
- ✅ Reads from ERC-8004 contracts
- ✅ Uses ChaosChain SDK for reputation lookups
- ❌ Does NOT write transactions
- ❌ Does NOT modify protocol logic
- Python 3.10+
- Twitter/X API credentials (for announcements)
- Ethereum RPC endpoint (Mainnet)
git clone https://github.com/ChaosChain/chaosclaw.git
cd chaosclaw
pip install -r requirements.txtCopy the example environment file:
cp .env.example .envEdit .env with your credentials:
# Ethereum
ETH_MAINNET_RPC_URL=https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY
# Twitter/X API
TWITTER_API_KEY=your_api_key
TWITTER_API_SECRET=your_api_secret
TWITTER_ACCESS_TOKEN=your_access_token
TWITTER_ACCESS_SECRET=your_access_secret
# Optional: ChaosChain SDK
CHAOSCHAIN_NETWORK=mainnet# Start the watcher
python -m chaosclaw.main
# Or run with Docker
docker-compose up -dchaosclaw/
├── README.md # You are here
├── chaosclaw/
│ ├── __init__.py
│ ├── main.py # Entry point
│ ├── config.py # Configuration loading
│ │
│ ├── core/ # Trust logic (isolated, auditable)
│ │ ├── __init__.py
│ │ ├── reputation.py # Fetch + normalize reputation
│ │ ├── filters.py # Trust thresholds + signal detection
│ │ └── scoring.py # Averages, buckets, formatting
│ │
│ ├── listeners/ # Event sources
│ │ ├── __init__.py
│ │ └── erc8004_watcher.py
│ │
│ └── publishers/ # Output destinations
│ ├── __init__.py
│ └── x_poster.py
│
├── agent/ # OpenClaw agent config (future)
│ └── config.json
│
├── tests/
│ └── test_filters.py
│
├── requirements.txt
├── .env.example
└── docker-compose.yml
┌─────────────────────────────────────────┐
│ OpenClaw Runtime │
│ ┌─────────────────────────────────┐ │
│ │ ChaosClaw Agent │ │
│ │ ┌──────────┐ ┌─────────────┐ │ │
│ │ │ SOUL.md │ │ ChaosChain │ │ │
│ │ │ │ │ Skill │ │ │
│ │ └──────────┘ └──────┬──────┘ │ │
│ └───────────────────────┼─────────┘ │
└──────────────────────────┼──────────────┘
│
▼
┌───────────────────────┐
│ ERC-8004 Contracts │
│ (Ethereum Mainnet) │
└───────────────────────┘
| Network | Contract | Address |
|---|---|---|
| Mainnet | IdentityRegistry | 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432 |
| Mainnet | ReputationRegistry | 0x8004BAa17C55a88189AE136b182e5fdA19dE9b63 |
| Sepolia | IdentityRegistry | 0x8004A818BFB912233c491871b3d84c89A494BD9e |
| Sepolia | ReputationRegistry | 0x8004B663056A597Dffe9eCcC1965A193B7388713 |
# chaosclaw/publishers/my_publisher.py
from chaosclaw.core.reputation import AgentTrust
class MyPublisher:
async def publish(self, agent: AgentTrust) -> bool:
# Your logic here
return True# chaosclaw/core/filters.py
def my_custom_filter(agent: AgentTrust) -> bool:
return agent.average_score >= 80- Phase 1: ERC-8004 watcher + X announcements
- Phase 2: Mention reply mode (
@chaosclaw verify 542) - Phase 3: Moltbook posting automation
- Phase 4: OpenClaw agent hooks integration
MIT — Free as a lobster in the ocean 🦞
Built with 🦞 by ChaosChain