Ottie

The agent runtime that proves what it did.

Ottie is the only AI agent where every decision has a receipt. A self-evolving agent runtime that learns from tasks, makes every side-effecting action auditable and crash-recoverable, and enforces authorization at compile time — not at 3am in production. One Go binary. 28 skills. Zero dependencies.

Website · One-Click Launch · Demo Videos · 8004scan Profile

Why Ottie?

No other agent combines these five properties. Most have zero.

Features

• Self-evolving skills — learns from tasks, packages approaches as reusable skills with human-consented review; 28 skills across 7 domain categories
• Auditable replay — per-turn execution manifest captures prompt hash, tool schema hash, provider request IDs, and model ID; every LLM call including retries and fallback attempts is recorded
• Crash-proof actions — write-ahead action ledger with Prepare/Commit/Abort for every side-effecting tool; orphaned intents surface at startup for reconciliation
• Compiler-verified safety — phantom-typed PrincipalContext[C Capability] with Go generics; unauthorized high-privilege tool calls fail at go build, not in production
• 28 skills in 7 categories — crypto/ (wallets, CEX, research), defi/ (swap, lending, staking, yield, Lido MCP), identity/ (ERC-8004, Self Agent ID), payments/ (Tempo, MPP), safety/ (ClawWall, prompt injection guard), research/ (Polymarket, Farcaster), meta/ (skill management)
• 14-reason error classifier — typed FailoverReason with recovery hints (ShouldCompress, ShouldFallback, ShouldRotateCredential) driving the fallback chain
• 13+ channels — Telegram, Discord, Slack, Signal, WhatsApp, Matrix, QQ, DingTalk, LINE, WeCom, Feishu, IRC
• One binary, zero deps — single Go binary (~24 MB), zero CGO, sub-second startup, air-gapped deployable
• Multi-agent swarm — sub-agent spawning via unified delegate tool, multi-bot coordination
• On-chain verified — ERC-8004 Agent #1988, deployed contracts, real Uniswap swaps on Sepolia
• Privacy layer — Venice AI zero-retention inference, Railgun ZK-SNARK private transfers

On-Chain Artifacts

Synthesis Hackathon Demos

All 10 track demo videos — each recorded with real Ottie agent calls, step-by-step operations.

37/37 E2E tests passing: bash demos/test-onchain.sh

Quick Start

git clone https://github.com/jiayaoqijia/ottie.git && cd ottie
make build
./build/ottie onboard
./build/ottie gateway

Configuration

Config lives at ~/.ottie/config.json:

{
  "model_list": [
    {
      "model_name": "claude-sonnet-4.6",
      "model": "anthropic/claude-sonnet-4.6",
      "api_key": "sk-ant-your-key"
    }
  ],
  "agents": {
    "defaults": {
      "model": "claude-sonnet-4.6"
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN",
      "allow_from": ["YOUR_USER_ID"]
    }
  },
  "tools": {
    "mcp": {
      "enabled": true,
      "servers": {
        "lido-mcp": {
          "enabled": true,
          "command": "python3",
          "args": ["mcp-servers/lido-mcp/server.py"]
        }
      }
    }
  }
}

CLI

Chat Channels

13+ messaging platforms: Telegram · Discord · Slack · Signal · WhatsApp · Matrix · QQ · DingTalk · LINE · WeCom · Feishu · IRC · Custom Webhooks

Multi-Agent Swarm

Mode A — Sub-Agents (single process): one orchestrator spawns specialized workers internally via sessions_spawn.

Mode B — Multi-Bot Telegram (multiple processes): separate Ottie instances coordinate via shared ProjectBoard in a Telegram group.

{
  "agents": {
    "list": [
      { "id": "orchestrator", "default": true, "role": "orchestrator",
        "subagents": { "allow_agents": ["researcher", "coder"] } },
      { "id": "researcher", "role": "leaf",
        "tools_allow": ["web_search", "web_fetch", "read_file"] },
      { "id": "coder", "role": "leaf",
        "tools_allow": ["read_file", "write_file", "edit_file", "exec"] }
    ]
  }
}

# Docker
git clone https://github.com/jiayaoqijia/ottie.git && cd ottie
docker compose -f docker/docker-compose.yml --profile gateway up

# Build from source
make build              # Current platform
make build-all          # All platforms
make test               # Run tests

Acknowledgments

Built on nanobot, OpenClaw, and PicoClaw. Integrates with CoinGecko · DefiLlama · Uniswap · Lido · Aave · Venice AI · ERC-8004 · Self Protocol · Snapshot · FastMCP and more.

License

AGPL-3.0 — see LICENSE for details.