Install EvoClaw

QUICK START

Running in 3 commands.

No GPU, no cluster, no data team. Install, configure, and start — EvoClaw handles the rest.

TERMINAL

# 1. Install EvoClaw

pip install evoclaw

# 2. Setup API keys (Groq = free, Tinker = cloud LoRA)

evoclaw init

# 3. Start the proxy

evoclaw start

EvoClaw Proxy v0.2.1 — listening on localhost:8080

→ Skills: 11 loaded · Agent is now self-evolving.

STEP BY STEP

Every step, explained.

01

Install the package

Install EvoClaw from PyPI. Works on any machine with Python 3.10+.

$ pip install evoclaw

02

Setup API keys

Run the interactive setup. Uses Groq (free) for PRM scoring and Tinker for cloud LoRA training.

$ evoclaw init

EvoClaw Setup

Groq API key: gsk_xxxx # console.groq.com (free)

Tinker API key: tk_xxxx # optional, skip = skill-only

Model [1-3]: 1 # Qwen3-4B / Llama / Kimi

03

Start the proxy

EvoClaw starts an OpenAI-compatible proxy on port 8080. Your agent begins evolving with every conversation.

$ evoclaw start

╔══════════════════════════════════╗

║

EvoClaw Proxy v0.2.1 ║

║ → localhost:8080 ║

║ → Skills: 11 loaded ║

╚══════════════════════════════════╝

04

Point your app at EvoClaw

Use any OpenAI SDK. Just change the base_url — EvoClaw learns in the background automatically.

from openai import OpenAI

client = OpenAI(

base_url="http://localhost:8080/v1",

api_key="any-string", # not checked

)

response = client.chat.completions.create(

model="llama-3.3-70b-versatile",

messages=[{"role": "user", "content": "Hello!"}]

)

#

EvoClaw learns in the background

INSTALL OPTIONS

Choose what you need.

Core package is all you need to start. Add extras for Discord, Telegram, or Redis.

CORE

Base Package

Proxy, skills, scorer, trainer. Everything to start self-evolving.

pip install evoclaw

BOT

Discord Bot

Deploy to Discord. Every message trains the model automatically.

pip install evoclaw[discord]

BOT

Telegram Bot

Deploy to Telegram. Your community becomes the training ground.

pip install evoclaw[telegram]

FULL

Everything

All optional extras — Discord, Telegram, and Redis persistence.

pip install evoclaw[all]

BEGINNER GUIDE

New to EvoClaw? Start here.

Never used a Python package before? No problem. Follow these steps and you will have EvoClaw running in under 5 minutes.

00

Check Python version

EvoClaw requires Python 3.10 or newer. Open terminal and run:

$ python --version

# Should show: Python 3.10 or higher

Not installed? Download from python.org — check Add Python to PATH during install.

01

Open Command Prompt (Windows) or Terminal (Mac/Linux) and run:

$ pip install evoclaw

Successfully installed evoclaw-0.2.1

02

Get an API key

EvoClaw works with any OpenAI-compatible API. Pick the one that fits you:

FREE ★ RECOMMENDED

Groq

Free tier. Very fast. Best for getting started.

console.groq.com →

Key starts with gsk_

FREE MODELS AVAILABLE

OpenRouter

Access 100+ models. Many free options.

openrouter.ai →

Key starts with sk-or-

PAID

OpenAI

GPT-4o, GPT-4o-mini and more.

platform.openai.com →

Key starts with sk-

PAID

Anthropic

Claude models. High quality responses.

console.anthropic.com →

Key starts with sk-ant-

PAID

Together AI

Open source models. $25 free credits.

api.together.xyz →

Key starts with tog-

Tip for beginners: Start with Groq — it is completely free and requires no credit card. You can switch to any other provider later by running evoclaw init again.

03

Run setup

This saves your API key. You only need to do this once.

$ evoclaw init

EvoClaw Setup

Groq API key: gsk_xxxx # paste your key here

Tinker API key: # press Enter to skip (optional)

Model [1-3]: 1 # type 1 for Qwen3-4B (recommended)

Tinker API key is optional — press Enter to skip. EvoClaw still works with skill injection and PRM scoring without it.

04

Start EvoClaw

Start the proxy. Keep this terminal window open while using EvoClaw.

$ evoclaw start

EvoClaw Proxy v0.2.1

→ localhost:8080

→ Skills: 11 loaded

Agent is now self-evolving.

05

Test it works

Open a new terminal window and run this Python code:

# Install OpenAI SDK first

pip install openai

from openai import OpenAI

client = OpenAI(

base_url="http://localhost:8080/v1",

api_key="any-string",

)

response = client.chat.completions.create(

model="llama-3.3-70b-versatile",

messages=[{"role": "user", "content": "Hello!"}]

)

print(response.choices[0].message.content)

# EvoClaw learns from every conversation automatically

Every conversation now trains your agent. The more you chat, the smarter it gets.

Common Issues

command not found: evoclaw

Try: python -m evoclaw init instead, or reinstall with pip install evoclaw

GROQ_API_KEY not set

Run evoclaw init again and paste your API key. Get a free one at console.groq.com or use any OpenAI-compatible provider.

Tinker init error: billing

Normal! Press Enter to skip Tinker during setup. Skill injection still works 100% for free.

Connection refused localhost:8080

Make sure evoclaw start is running in a separate terminal window first.

SKILL MARKETPLACE

Browse, install, and sell skills.

The EvoClaw Marketplace lets you browse skills learned by other agents, install them into yours in 1 click, and sell your own skills for USDC — paid directly to your wallet via x402.

EXPLORE

Browse Skills

See all skills from agents across the network. Preview full content and PRM score before installing. No account needed.

evoclaw.tech/marketplace →

INSTALL

1-Click Install

Connect your agent and install any skill directly into it. Skill becomes active in 3 seconds — no restart needed.

SELL

Monetize Skills

List your skills with a USDC price. Buyers pay directly to your Base wallet via x402. No middleman, no fees.

RATE

Rate & Review

After installing, rate the skill 1–5 stars. Ratings help the best skills rise to the top of the network.

👀

Browse without an agent (Guest)

You can explore and preview all skills without installing EvoClaw. Just open the marketplace:

# No setup needed — just open in browser

evoclaw.tech/marketplace

# As a guest you can:

✅ Browse all skills in EXPLORE tab

✅ Preview full skill content + PRM score

✅ Download skill as .json file

✅ Copy skill content to clipboard

To INSTALL skills directly into an agent, you need to connect your agent first — see below.

🔌

Connect your agent (Local / VPS)

Run EvoClaw first, then paste your agent URL in the marketplace connect bar:

LOCAL (laptop / PC)

evoclaw start

# Paste in marketplace:

http://localhost:8080

VPS / CLOUD SERVER

evoclaw start

# Paste in marketplace:

http://YOUR_IP

After pasting the URL and clicking CONNECT AGENT, the status bar shows ● AGENT ONLINE · 12 skills

⚡

Install a skill from the network

After connecting your agent, you can install any skill from EXPLORE with 1 click:

1. Open EXPLORE tab

2. Click PREVIEW to see full content

3. Click INSTALL (free skills)

or

3. Click ⚡ BUY · X USDC (paid skills)

# Skill is active in your agent in 3 seconds

# No restart needed — hot-inject ✅

For paid skills, MetaMask will open and ask you to sign a USDC transfer. No ETH needed for gas — EvoClaw uses gasless ERC-3009 signatures via x402.

💰

List your skill for sale

Any skill your agent has learned can be listed to the marketplace:

1. Connect agent → MY SKILLS tab

2. Click LIST on any skill

3. Set price: 0 = FREE · 1 = 1 USDC · etc

4. Paste your Base wallet address

(0x... — MetaMask or any Base wallet)

5. Click LIST NOW →

# Skill appears in EXPLORE for all users

# Payments go directly to your wallet

No MetaMask needed to list. You only need MetaMask to buy paid skills. To sell, just paste your wallet address.

✏️

Manage your listings

From the EXPLORE tab, skills you own show extra controls:

UNLIST — remove skill from marketplace

✏ — edit price anytime

# From MY SKILLS tab:

● LISTED — skill is visible to all

○ PRIVATE — skill only on your agent

⬇ — download skill as .json

⚡

Payments powered by x402

Internet-native payments · Base Network · Powered by Coinbase

Currency
USDC on Base network

Gas fees
Zero — gasless ERC-3009 signatures

Settlement
Direct to seller wallet, instant

Platform fee
0% — seller keeps 100%

Open Marketplace → Learn about x402 →

CLI REFERENCE

All commands.

TERMINAL

evoclaw init # Setup API keys interactively

evoclaw start # Start proxy on localhost:8080

evoclaw start --port 9000 --no-train # Custom port, skill-only

evoclaw status # Skills + trainer stats

evoclaw skills # List all learned skills

evoclaw skills --category crypto # Filter by category

evoclaw clear # Reset skill bank

evoclaw train --file conversations.jsonl # Train from file

Full Documentation → ▶ Live Demo ⭐ GitHub