Clawmes — Hermes agent for crypto

🪽

clawmes

hermes agent for crypto

$ pip install clawmes

no Hermes yet? pip install hermes-agent first

from GitHub? hermes plugins install clawnchdev/clawmes --enable

editable? git clone + pip install -e ".[dev]"

Read the Docs View on GitHub PyPI

tools

commands

channels

services

quick start

-> Grab an LLM API key and a channel token
Bankr·Anthropic·OpenRouter·OpenAI+Telegram·Discord·Slack

-> pip install hermes-agent — if you don't already have Hermes

-> pip install clawmes

-> hermes clawmes init — validates keys, writes ~/.hermes/.env

-> hermes — start chatting

-> Message your bot — /setup to verify, /connect for wallet

📈

Trading

0x DEX aggregator for swaps. Limit, stop, trailing, and DCA orders via the compound action engine. Cross-chain bridging through Li.Fi. Uniswap V3 LP positions.

🏦

DeFi

Aave V3 supply & borrow, Lido & Rocket Pool staking, Yearn V3 vaults. Live APY comparisons via DeFiLlama. Position monitoring with alert thresholds.

📊

Market Intelligence

RSI, MACD, Bollinger bands. Whale activity tracking, trending tokens, FIFO P&L. 5-source price oracle (CoinGecko, Birdeye, DexScreener, TWAP, Chainlink).

⚡

Automation Engine

Time, price, and on-chain triggers. Compound actions with conditionals, loops, parallel execution. Plans persist to disk and survive restarts via Hermes' cron daemon.

🚀

Token Launches

Deploy ERC-20s on Base via Clawnch launchpad. Automatic Uniswap V4 pool creation. Configurable bonding curves and launch parameters.

🎨

NFT & Airdrops

ERC-721 mint, transfer, and burn. Airdrop eligibility checking across protocols. Collection management from chat.

🔍

On-chain Intel

Contract source verification, token security audits, real-time swap monitoring. Block explorer queries. Integrated web browsing.

🗳️

Governance & Social

DAO proposal voting from chat. Farcaster casting, search, and notifications. X/Twitter posting via Molten agent integration.

🔒

Security

Bounded approvals (exact amounts, never unlimited). Credential leak scanning. Prompt injection guards. Transaction verification before execution. Outbound HTTP allowlist with 100-entry block audit ring, runtime additions via /allow.

👛

Three Wallet Modes

WalletConnect (agent never holds keys). Local encrypted BIP-39 mnemonic (scrypt + AES-256-GCM, macOS Keychain). Bankr custodial multi-chain wallet.

🧠

Self-Improvement

Procedural memory across sessions and agent-initiated skill refinement. Both write paths gated behind an explicit evolution mode (OFF by default) so prompt injection can't drift the agent's own context. /evolve enables, /stable disables.

🤖

Agent Network

Agent-to-agent matching via Clawnx. Hummingbot market-making integration. Wayfinder route optimization. Multi-agent orchestration.

👋

Onboarding & personas

Interactive setup flow with 5 personas (professional, degen, chill, technical, mentor) and 10 capability toggles. /welcome shows current step + persona + picks. /skip, /back, /reonboard navigate the flow.

🔑

Agent identity

Ed25519 keypair + did:key encoding for each agent, independent from the wallet. Wallet signs on-chain transactions (high-value); DID signs protocol messages — MCP calls, capability delegations, attestation signatures. /identity to show or generate.

🧭

Discoverability

/skills, /persona, /chains, /tools_list, /safety_status — the LLM tells you exactly what it can do. A pre_llm_call hook injects your last 5 slash-command results into context so it stops re-asking things you just answered.

🪽

BV-7X Oracle

Clawnch-ecosystem BTC oracle. Daily predictions posted on-chain as EAS attestations on Base — verifiable before outcome. /btc surfaces price + Fear & Greed + ETF flows in one line; /bv7x shows track record + regime. Agent-to-agent calls + $BV7X-gated premium signal supported.

🛰️

OpenGateway LLM

OpenAI-compatible LLM gateway via gitlawb's OpenGateway. Routes Xiaomi MiMo, GMI Cloud, and more behind one endpoint. Server-side secrets, per-key usage, no embedded keys in OSS clients. Auth optional during the partnership window.

runs on Telegram · Discord · Slack · Signal · WhatsApp · iMessage · LINE

built on Hermes — Python ≥ 3.11 · web3.py · viem (bridges) · ~/.hermes/

faq

How is this different from OpenClawnch?

Clawmes is the Python rewrite targeting Hermes Agent. OpenClawnch is the original TypeScript build for OpenClaw. Different surface compositions today: clawmes leads in tool surface (52 vs 45) and ships the agent-economy stack (BV-7X, A2A, EAS, DID:key); OpenClawnch leads in command coverage (113 vs 73). Pick the runtime that matches your environment.

Does the agent hold my keys?

Not in WalletConnect mode (recommended). Every write transaction goes to your phone wallet for approval. The agent never sees your private keys.

Which chains are supported?

Ethereum, Base, and any EVM-compatible chain. Cross-chain swaps via Li.Fi bridge. Multi-RPC failover with circuit breakers.

Can I control what it approves?

Yes. Set spending policies in natural language: /policy approve swaps under 0.05 ETH, max 10/hour. The LLM can also propose policies via policy_manage with a propose→confirm flow — nothing lands without your explicit confirm.

What if I just want to read?

/safemode blocks all on-chain writes. Market data, analytics, and portfolio tracking still work. /safety_status shows current mode. /dangermode exists for advanced use (re-enables writes after a /safemode session).

Do I run my own instance?

Yes. Fully self-hosted. Your keys, your data, your instance. No shared infrastructure. Hermes runs locally; hermes command keeps the agent alive.

documentation

Quick Start Tools Commands CLI Security Ecosystem Architecture Contributing

Prefer TypeScript & OpenClaw? Check out openclawnch — the same agent, different stack.