Clawd

https://github.com/x402agent/solana-clawd
Admin
Clawd is a verifiable agentic harness for Solana that converts autonomous AI actions into...
Tokens:1,813,817
Snippets:20,912
Trust Score:7.7
License:MIT
Update:5 months ago
Show doc for...
Tokens:
Raw
### Local Development Setup

Source: https://github.com/x402agent/solana-clawd/blob/newnew/agents/solana-agent/moltworker-main/AGENTS.md

Steps to set up the local development environment, including installing dependencies, copying environment variables, and starting the development server.

```bash
npm install
cp .dev.vars.example .dev.vars
# Edit .dev.vars with your ANTHROPIC_API_KEY
npm run start
```

--------------------------------

### 3D Site Local Development Setup

Source: https://github.com/x402agent/solana-clawd/blob/newnew/STARTHERE/BACKROOMS.md

Navigate to the backroom-3d directory, install dependencies, copy the example environment file to .env.local, and run the development server.

```bash
cd backroom-3d
npm install
cp .env.example .env.local
npm run dev
# → http://localhost:5173
```

--------------------------------

### Install Dependencies and Start Development Server

Source: https://github.com/x402agent/solana-clawd/blob/newnew/plugin.delivery/templates/default/README.md

Use these commands to install project dependencies and start the local development server.

```bash
# Install dependencies
pnpm install

# Start development server
pnpm dev
```

--------------------------------

### Install Dependencies and Setup Environment

Source: https://github.com/x402agent/solana-clawd/blob/newnew/agents/cloudflare-agent-api/examples/steel-openai-ralph-cua/README.md

Navigate to the example directory, install Node.js dependencies, and copy the environment file. Edit the `.env` file to include your Steel and OpenAI API keys, the task to be performed, and the desired OpenAI model.

```bash
cd examples/steel-openai-ralph-cua
npm install
cp .env.example .env
```

```env
STEEL_API_KEY=your_steel_api_key_here
OPENAI_API_KEY=your_openai_api_key_here
TASK=Go to steel.dev and summarize the latest news
OPENAI_MODEL=gpt-5.5
```

--------------------------------

### Installation Commands Example

Source: https://github.com/x402agent/solana-clawd/blob/newnew/plugin.delivery/templates/standalone/README-GENERATION-PROMPT.md

Placeholder for installation commands. These should be verbatim from the source documentation and presented sequentially.

```bash
{Installation commands - verbatim from docs}
```

--------------------------------

### External Plugin Project Setup

Source: https://github.com/x402agent/solana-clawd/blob/newnew/plugin.delivery/docs/SOLANA_CLAWD_PLUGIN_COMPLETE_GUIDE.md

Steps to clone the template, install dependencies, and start the development server for an external plugin.

```bash
# Clone template
git clone https://github.com/x402agent/solana-clawd my-plugin
cd my-plugin

# Install dependencies
pnpm install

# Start development
pnpm dev
```

--------------------------------

### Interactive Quickstart Guide

Source: https://github.com/x402agent/solana-clawd/blob/newnew/sdk/automation/README.md

Launch the interactive quick-start guide to set up the environment, spawn, and run the Leviathan runtime.

```bash
bash automation/quickstart.sh
```

--------------------------------

### Setup and Run API Server

Source: https://github.com/x402agent/solana-clawd/blob/newnew/llm-wiki-tang/README.md

Navigates to the API directory, sets up a Python virtual environment, installs dependencies, copies environment variables, and starts the Uvicorn server for the API.

```bash
cd api
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
cp ../.env.example .env
uvicorn main:app --reload --port 8000
```

--------------------------------

### Quick Start: Install and Run Worker

Source: https://github.com/x402agent/solana-clawd/blob/newnew/sdk/vendor/solana-clawd-x402/README.md

Navigate to the worker directory, install dependencies, and start the development server using npm and wrangler.

```sh
cd x402/worker
npm install
npm run typecheck
npx wrangler dev
```

--------------------------------

### Install and Run solana-clawd

Source: https://github.com/x402agent/solana-clawd/blob/newnew/plugin.delivery/templates/standalone/README.md

Instructions for cloning the repository, installing dependencies, and starting the development server.

```bash
git clone https://github.com/x402agent/solana-clawd
cd solana-clawd

pnpm install

bun run dev
```

--------------------------------

### Install and Run Development Server

Source: https://github.com/x402agent/solana-clawd/blob/newnew/plugin.delivery/templates/markdown/README.md

Installs project dependencies and starts the development server. Ensure Node.js is installed.

```bash
pnpm install

pnpm dev
```

--------------------------------

### Install and Start Surfpool CLI

Source: https://github.com/x402agent/solana-clawd/blob/newnew/agents/skills/solana-dev-skill-main/skill/testing.md

Install the Surfpool CLI and start the local Surfnet instance for integration testing.

```bash
cargo install surfpool

surfpool start
```

--------------------------------

### Setup and Run MCP Server

Source: https://github.com/x402agent/solana-clawd/blob/newnew/llm-wiki-tang/README.md

Navigates to the MCP directory, sets up a Python virtual environment, installs dependencies, and starts the Uvicorn server for the MCP.

```bash
cd mcp
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
uvicorn server:app --reload --port 8080
```

--------------------------------

### Clone Repository and Install Dependencies

Source: https://github.com/x402agent/solana-clawd/blob/newnew/agents/docs/WORKFLOW.md

Initial setup steps for local development: clone the repository, navigate into the directory, and install project dependencies using Bun.

```bash
# 1. Clone repository
git clone https://github.com/yourusername/defi-agents
cd defi-agents

# 2. Install dependencies
bun install
```

--------------------------------

### Quick Start: Session Management Commands

Source: https://github.com/x402agent/solana-clawd/blob/newnew/agents/skills/openclaw-claude-code-skill-main/README.md

Examples of starting, sending tasks to, compacting, checking context, switching models, changing effort, and stopping sessions.

```bash
# Start a session with high effort
claude-code-skill session-start myproject -d ~/project \
  --permission-mode acceptEdits \
  --allowed-tools "Bash,Read,Edit,Write,Glob,Grep" \
  --effort high

# Send a task with streaming
claude-code-skill session-send myproject "Refactor the auth module" --stream

# Need deep reasoning? Use ultrathink
claude-code-skill session-send myproject "Design a new caching layer" --stream --ultrathink

# Want a plan first?
claude-code-skill session-send myproject "Add rate limiting" --stream --plan

# Running low on context? Compact it
claude-code-skill session-compact myproject

# Check context usage
claude-code-skill session-context myproject

# Switch model mid-session
claude-code-skill session-model myproject sonnet

# Change effort level
claude-code-skill session-effort myproject max

# Done
claude-code-skill session-stop myproject
```

--------------------------------

### Quick Start Examples for Summarize Skill

Source: https://github.com/x402agent/solana-clawd/blob/newnew/agents/skills/summarize/SKILL.md

Demonstrates basic usage for summarizing URLs, local files, and YouTube links. Ensure the 'summarize' binary is installed and API keys are set for the chosen model.

```bash
summarize "https://example.com" --model google/gemini-3-flash-preview
summarize "/path/to/file.pdf" --model google/gemini-3-flash-preview
summarize "https://youtu.be/dQw4w9WgXcQ" --youtube auto
```

--------------------------------

### Install ordercli

Source: https://github.com/x402agent/solana-clawd/blob/newnew/agents/skills/food-order/SKILL.md

Installs the ordercli tool using Go. This is a one-time setup step.

```bash
go install github.com/steipete/ordercli/cmd/ordercli@latest
```

--------------------------------

### Kani Installation and Setup

Source: https://github.com/x402agent/solana-clawd/blob/newnew/formal_verification/VERIFIER.md

Installs Kani and sets up the environment for Rust model checking. Ensure you have Rust and Cargo installed.

```bash
cargo install --locked kani-verifier
cargo kani setup
```

--------------------------------

### Install Web Dependencies and Run Development Server

Source: https://github.com/x402agent/solana-clawd/blob/newnew/llm-wiki-tang/README.md

Navigates to the web directory, installs Node.js dependencies, copies environment variables, and starts the development server.

```bash
cd web
npm install
cp .env.example .env.local
npm run dev
```

--------------------------------

### Install solana-clawd

Source: https://github.com/x402agent/solana-clawd/blob/newnew/agents/skills/solana-clawd/SKILL.md

Use this command to clone the repository and run the setup script for a full installation.

```bash
git clone https://github.com/x402agent/solana-clawd
cd solana-clawd
npm run setup
```

--------------------------------

### Quick Start: Clawd Fetch Example

Source: https://github.com/x402agent/solana-clawd/blob/newnew/sdk/vendor/solana-clawd-x402/README.md

Example demonstrating how to use `clawdFetch` from `@solanaclawd/x402-client` to make a POST request to a Clawd agent.

```typescript
import { Connection, Keypair } from "@solana/web3.js";
import { clawdFetch } from "@solanaclawd/x402-client";

const connection = new Connection("https://mainnet.helius-rpc.com/?api-key=...");
const signer = Keypair.fromSecretKey(secret);

const res = await clawdFetch("https://solanaclawd.com/x402/agents/<agent-id>/run", {
  method: "POST",
  body: JSON.stringify({ prompt: "ship the thing" }),
  signer,
  connection,
  maxAmount: 10000n,
  allowedAssets: ["<USDC_MINT>"],
});

console.log(await res.text());
console.log(res.signature, res.receiptCid);
```

--------------------------------

### Install Solana Clawd SDK and Gateway

Source: https://github.com/x402agent/solana-clawd/blob/newnew/plugin.delivery/docs/SOLANA_CLAWD_PLUGIN_COMPLETE_GUIDE.md

Install the necessary packages for plugin development and gateway setup using pnpm.

```bash
# For plugin development
pnpm add @x402agent/plugin-sdk

# For gateway setup
pnpm add @x402agent/chat-plugins-gateway
```

--------------------------------

### Documentation: API Documentation Prompt

Source: https://github.com/x402agent/solana-clawd/blob/newnew/operator/docs/examples/index.md

Prompt for generating comprehensive API documentation for a project, including public classes/functions, usage examples, a getting started guide, and Markdown formatting.

```markdown
Generate comprehensive API documentation for this project:
- Document all public classes and functions
- Include usage examples
- Create a getting started guide
- Format as Markdown
```

--------------------------------

### Quick Start from Source

Source: https://github.com/x402agent/solana-clawd/blob/newnew/automaton-main/README.md

Clone the repository, install dependencies, build the project, and run the CLI. This process also sets up local perps if not disabled.

```bash
git clone https://github.com/x402agent/openclawd.git
cd openclawd/automaton-main
pnpm install
pnpm build
clawd-automaton --help
```

--------------------------------

### Install Embedchain Package

Source: https://github.com/x402agent/solana-clawd/blob/newnew/MemeBRain/mem0-main/embedchain/docs/examples/whatsapp_bot.mdx

Install the embedchain Python package to get started. This is a prerequisite for running the WhatsApp bot.

```bash
pip install --upgrade embedchain
```

--------------------------------

### Install and Run LiveKit Agent

Source: https://github.com/x402agent/solana-clawd/blob/newnew/sdk/livekit-agent/README.md

Quick start guide for setting up and running the Clawd agent. Includes installing dependencies and downloading necessary model files.

```bash
cd livekit-agent
cp .env.example .env.local
# fill in keys (see below)
pip install -r requirements.txt
python agent.py download-files   # silero, turn detector, noise cancellation
python agent.py dev
```

--------------------------------

### Set up Environment Variables

Source: https://github.com/x402agent/solana-clawd/blob/newnew/sdk/examples/README.md

Copies the example environment file and instructs to fill in necessary API keys.

```bash
cp examples/.env.example .env  # or edit ~/.clawd/.env
# Fill in: XAI_API_KEY, HELIUS_API_KEY (optional), etc.
```

--------------------------------

### Basic Hugging Face Reranker Setup

Source: https://github.com/x402agent/solana-clawd/blob/newnew/MemeBRain/mem0-main/docs/components/rerankers/models/huggingface.mdx

Configure the Hugging Face reranker provider with a base model and specify the device for processing. This is the most common setup for getting started.

```python
from mem0 import Memory

config = {
    "reranker": {
        "provider": "huggingface",
        "config": {
            "model": "BAAI/bge-reranker-base",
            "device": "cpu"
        }
    }
}

m = Memory.from_config(config)
```

--------------------------------

### Run Example

Source: https://github.com/x402agent/solana-clawd/blob/newnew/MemeBRain/mem0-main/mem0-ts/src/oss/README.md

Execute the comprehensive example script to demonstrate various features.

```bash
npm run example
```

--------------------------------

### Development Setup Commands Example

Source: https://github.com/x402agent/solana-clawd/blob/newnew/plugin.delivery/templates/standalone/README-GENERATION-PROMPT.md

Placeholder for commands required to set up the development environment. These should be verbatim from the source documentation.

```bash
{Dev setup commands from docs}
```

--------------------------------

### Local Development Setup for Solana MCP

Source: https://github.com/x402agent/solana-clawd/blob/newnew/MCP/solana-mcp-official-main/README.md

Commands to install dependencies, configure environment variables, and start the local development server and inspector for the Solana MCP.

```bash
pnpm install
cp .env.example .env  # set DATABRICKS_HOST + DATABRICKS_TOKEN + DATABRICKS_VS_INDEX
pnpm dev:local
pnpm inspector  # connects MCP Inspector at http://127.0.0.1:6274
```

--------------------------------

### Setup QEDGen Project

Source: https://github.com/x402agent/solana-clawd/blob/newnew/agents/skills/solana-formal-verification/SKILL.md

Run this command to set up the QEDGen project environment, including ensuring the global Mathlib cache is available. This may take a significant amount of time on the first run.

```bash
qedgen setup
```

--------------------------------

### GET /fapi/v3/order Example

Source: https://github.com/x402agent/solana-clawd/blob/newnew/agents/solana-agent/workspace/api-docs-master/aster-finance-futures-api-v3.md

Example of how to query an order using the GET /fapi/v3/order endpoint.

```APIDOC
## GET /fapi/v3/order

### Description
Queries an order.

### Method
GET

### Endpoint
/fapi/v3/order

### Parameters
#### Query Parameters
- **symbol** (string) - Required - The symbol of the order.
- **orderId** (long) - Optional - The order ID.
- **origClientOrderId** (string) - Optional - The client order ID.
- **recvWindow** (long) - Optional - The receive window for the request. The request is valid for 10000ms by default.
- **timestamp** (long) - Required - UTC timestamp in milliseconds.

### Request Example
```
GET /fapi/v3/order?symbol=BTCUSDT&orderId=123456789&timestamp=1678886400000
```

### Response
#### Success Response (200)
- **symbol** (string) - The symbol of the order.
- **orderId** (long) - The order ID.
- **orderListId** (long) - Order list ID.
- **clientOrderId** (string) - The client order ID.
- **transactTime** (long) - Transaction time.
- **price** (string) - The price of the order.
- **origQty** (string) - The original quantity.
- **executedQty** (string) - The executed quantity.
- **cummulativeQuoteQty** (string) - The cumulative quote quantity.
- **status** (string) - Order status.
- **timeInForce** (string) - Time in force.
- **type** (string) - Order type.
- **side** (string) - Order side.
- **fills** (array) - Array of fills.

#### Response Example
```json
{
  "symbol": "BTCUSDT",
  "orderId": 123456789,
  "orderListId": -1,
  "clientOrderId": "my_order_id_123",
  "transactTime": 1678886400000,
  "price": "50000.00000000",
  "origQty": "0.00100000",
  "executedQty": "0.00000000",
  "cummulativeQuoteQty": "0.00000000",
  "status": "NEW",
  "timeInForce": "GTC",
  "type": "LIMIT",
  "side": "BUY",
  "fills": []
}
```
```

--------------------------------

### Set Up Environment Variables

Source: https://github.com/x402agent/solana-clawd/blob/newnew/packages/clawd/CONTRIBUTING.md

Copies the example environment file and instructs to add API keys. Never commit the .env file.

```bash
cp .env.example .env
# Edit .env and add your API keys (NEVER commit this file)
```

--------------------------------

### Install and Start Flowise

Source: https://github.com/x402agent/solana-clawd/blob/newnew/MemeBRain/mem0-main/docs/integrations/flowise.mdx

Install Flowise globally and start the application. Requires Node.js version 18.15.0 or higher.

```bash
npm install -g flowise
npx flowise start
```

--------------------------------

### Setup Development Environment

Source: https://github.com/x402agent/solana-clawd/blob/newnew/operator/docs/contributing.md

Commands to clone the repository, set up a virtual environment, install dependencies, and configure pre-commit hooks.

```bash
# Fork and clone the repository
git clone https://github.com/YOUR_USERNAME/ralph-orchestrator.git
cd ralph-orchestrator

# Create a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install development dependencies
pip install -e .
pip install pytest pytest-cov black ruff

# Install pre-commit hooks (optional)
pip install pre-commit
pre-commit install
```

--------------------------------

### Terminal TUI Local Development Setup

Source: https://github.com/x402agent/solana-clawd/blob/newnew/STARTHERE/BACKROOMS.md

Navigate to backroom-tui, copy the example environment file, install dependencies using bun, and run the development server. An optional step is provided to set up a stable reusable identity.

```bash
cd backroom-tui
cp .env.example .env
bun install

# interactive terminal dashboard
bun run dev

# optional: stable reusable identity
bun run src/cli.tsx setup --name my-terminal
```

--------------------------------

### Quick Start Development Commands

Source: https://github.com/x402agent/solana-clawd/blob/newnew/plugin.delivery/docs/PLUGIN_DEVELOPMENT_GUIDE.md

Commands to set up and run a plugin development server using npm.

```bash
# Copy a template (choose one)
cp -r templates/openapi my-plugin     # OpenAPI-based
cp -r templates/markdown my-plugin    # Markdown output
cp -r templates/standalone my-plugin  # Interactive React

cd my-plugin

# Install dependencies
npm install

# Start development server
npm run dev
```

--------------------------------

### Guided OpenHue Setup

Source: https://github.com/x402agent/solana-clawd/blob/newnew/agents/skills/openhue/SKILL.md

Initiates a guided setup process for connecting to your Hue Bridge. You may need to press the bridge button during this process.

```bash
openhue setup
```

--------------------------------

### Install Script: enter.sh

Source: https://github.com/x402agent/solana-clawd/blob/newnew/sdk/install.txt

The `enter.sh` script provides a full backroom onboarding experience, including all functionalities of `install.sh` plus additional features like a cyberpunk banner and wallet key storage.

```APIDOC
## enter.sh

### Description
A comprehensive onboarding script that includes all features of `install.sh` along with enhanced UI elements and optional wallet key storage.

### Served At:
- `https://install.x402.wtf/enter`
- `https://backrooms.x402.wtf/enter.sh`

### Command
```bash
curl -fsSL https://install.x402.wtf/enter | bash
```

### Additional Features:
- Cyberpunk ASCII banner and color palette.
- Vulcan check.
- Richer profile display.
- Stores `developer.wallet` if `~/.openclawd/keystore.json` exists.
- Spinner animations for each step.
```

--------------------------------

### Install and Start Surfpool CLI

Source: https://github.com/x402agent/solana-clawd/blob/newnew/skills/solana-dev-skill-main/skill/testing.md

Install the Surfpool CLI using Cargo and start the local Surfnet instance. Surfpool provides a drop-in replacement for solana-test-validator for integration testing.

```bash
# Install Surfpool CLI
cargo install surfpool

# Start local Surfnet
surfpool start

```

--------------------------------

### Display Help and Configuration Options

Source: https://github.com/x402agent/solana-clawd/blob/newnew/operator/docs/guide/configuration.md

To see a comprehensive list of all available configuration options and their descriptions, use the `--help` flag.

```bash
python ralph_orchestrator.py --help
```

--------------------------------

### Create and Install from requirements.txt

Source: https://github.com/x402agent/solana-clawd/blob/newnew/operator/docs/installation.md

Create a requirements.txt file with all optional dependencies and install them using pip.

```bash
# Create requirements.txt
cat > requirements.txt << EOF
psutil>=5.9.0
orjson>=3.9.0
pytest>=7.0.0
pytest-cov>=4.0.0
black>=23.0.0
ruff>=0.1.0
EOF

# Install all dependencies
pip install -r requirements.txt

```

--------------------------------

### Run Setup Script

Source: https://github.com/x402agent/solana-clawd/blob/newnew/CONTRIBUTING.md

Execute the setup script to configure environment files and dependencies.

```bash
npm run setup      # runs scripts/setup.sh
```

--------------------------------

### Get Nonce Response Example

Source: https://github.com/x402agent/solana-clawd/blob/newnew/solana-python-agent/workspace/api-docs-master/aster-finance-spot-api.md

This is an example of the nonce returned when requesting it for API key creation.

```javascript
111111
```

--------------------------------

### First Run Command Example

Source: https://github.com/x402agent/solana-clawd/blob/newnew/plugin.delivery/templates/standalone/README-GENERATION-PROMPT.md

Placeholder for the first command a user should run after installation. This should be verbatim from the source documentation.

```bash
{First command to run}
```

--------------------------------

### Start the iii engine

Source: https://github.com/x402agent/solana-clawd/blob/newnew/tailclawd/quickstart/README.md

Starts the iii engine configuration. Ensure the iii engine is installed and on your PATH.

```bash
iii -c iii-config.yaml
```

--------------------------------

### Setup and Credentials

Source: https://github.com/x402agent/solana-clawd/blob/newnew/moltbook-agent/README.md

No npm install is required as the agent has zero dependencies. Node 18+ is needed for global fetch. Ensure Moltbook credentials exist at ~/.config/moltbook/credentials.json.

```bash
# No npm install needed! Zero dependencies.
# Just needs Node 18+ (for global fetch)

# Credentials should already exist at:
# ~/.config/moltbook/credentials.json
cat ~/.config/moltbook/credentials.json
```

--------------------------------

### Install SolanaOS via CLI

Source: https://github.com/x402agent/solana-clawd/blob/newnew/apps/macos/README.md

Installs SolanaOS using a curl command and displays the setup code.

```bash
curl -fsSL https://raw.githubusercontent.com/x402agent/SolanaOS/main/install.sh | bash

```

```bash
cat ~/.nanosolana/connect/setup-code.txt

```

--------------------------------

### Set Up Environment Variables

Source: https://github.com/x402agent/solana-clawd/blob/newnew/MemeBRain/mem0-main/mem0-ts/src/oss/README.md

Copy the example environment file and edit it with your OpenAI API key.

```bash
cp .env.example .env
# Edit .env with your OpenAI API key
```

--------------------------------

### Start Local Validator with Amman

Source: https://github.com/x402agent/solana-clawd/blob/newnew/programs/mpl-token-metadata-main/README.md

This command starts a local validator using Amman. After starting, navigate to `<ROOT>/clients/js` to install dependencies and run tests.

```sh
pnpm validator
```

--------------------------------

### Start Development Server

Source: https://github.com/x402agent/solana-clawd/blob/newnew/MemeBRain/mem0-main/docs/cookbooks/companions/quickstart-demo.mdx

Run this command to start the Next.js development server for the demo application.

```bash
pnpm run dev
```

--------------------------------

### Install Script: install.sh

Source: https://github.com/x402agent/solana-clawd/blob/newnew/sdk/install.txt

The `install.sh` script is a one-shot installer for OpenClawd. It handles Node.js checks, package installation, environment setup, and initial heartbeat registration.

```APIDOC
## install.sh

### Description
This script installs the OpenClawd package, sets up the agent ID and name, registers the developer with the Convex backend, and initiates background heartbeats.

### Command
```bash
curl -fsSL https://solanaclawd.com/install.sh | bash
```

### Steps:
1. Checks for Node.js v20+, npm, and curl.
2. Derives a stable AGENT_ID.
3. Installs `@openclawdsolana/clawd` globally.
4. Creates `~/.clawd/.env` with `CLAWD_AGENT_ID` and `CLAWD_NAME`.
5. POSTs to Convex `/clawd/register`.
6. Stores `developer.profile` KV in Convex.
7. Fires an initial heartbeat with state `"installed"`.
8. Starts a 20-minute background heartbeat loop with state `"active"`.
9. Prints personalized backroom curl commands.
```

--------------------------------

### Start All Docker Services

Source: https://github.com/x402agent/solana-clawd/blob/newnew/sdk/knowledge/wiki.md

This command starts all services defined in the docker-compose.yml file. Ensure Docker is installed and running.

```bash
docker-compose up -d
```

--------------------------------

### Start Local Development Server

Source: https://github.com/x402agent/solana-clawd/blob/newnew/MemeBRain/mem0-main/docs/README.md

Run this command in the root of your documentation project to preview changes locally.

```bash
mintlify dev
```

--------------------------------

### Install and Run TailClaude

Source: https://github.com/x402agent/solana-clawd/blob/newnew/tailclawd/README.md

Install dependencies and run the iii engine to start TailClaude. Assumes you are in the project directory.

```bash
cd /Users/8bit/fraud/solana-claude/tailclawd
npm install
iii -c iii-config.yaml
```

--------------------------------

### Steel OpenAI Ralph CUA Starter Setup

Source: https://github.com/x402agent/solana-clawd/blob/newnew/agents/cloudflare-agent-api/README.md

Instructions for setting up and running the Steel OpenAI Ralph CUA starter project. This starter includes browser control agents, GPT orchestration, and Steel Computer API integration.

```bash
cd examples/steel-openai-ralph-cua
npm install
cp .env.example .env
# set STEEL_API_KEY and OPENAI_API_KEY in .env
npm run dev
```

--------------------------------

### Setup Local Places Skill

Source: https://github.com/x402agent/solana-clawd/blob/newnew/agents/skills/local-places/SKILL.md

Install dependencies, set up the environment, and run the local server. Requires GOOGLE_PLACES_API_KEY to be set in a .env file.

```bash
cd {baseDir}
echo "GOOGLE_PLACES_API_KEY=your-key" > .env
uv venv && uv pip install -e ".[dev]"
uv run --env-file .env uvicorn local_places.main:app --host 127.0.0.1 --port 8000
```

--------------------------------

### Install Ralph Orchestrator via pip

Source: https://github.com/x402agent/solana-clawd/blob/newnew/operator/docs/installation.md

A straightforward method to install Ralph using pip for quick setup.

```bash
# Install via pip
pip install ralph-orchestrator

```

--------------------------------

### Example UI .env Configuration

Source: https://github.com/x402agent/solana-clawd/blob/newnew/MemeBRain/mem0-main/docs/openmemory/quickstart.mdx

Example configuration for the UI's .env file. Set the API URL and the User ID, ensuring it matches the API's user ID.

```bash
NEXT_PUBLIC_API_URL=http://localhost:8765
NEXT_PUBLIC_USER_ID=<user-id> # Same as the user ID for environment variable in api
```

--------------------------------

### Clone and Set Up Solana Clawd Project

Source: https://github.com/x402agent/solana-clawd/blob/newnew/plugin.delivery/README.zh-CN.md

Clone the Solana Clawd repository, navigate to the plugins directory, install dependencies, and start the development server.

```bash
# Clone
git clone https://github.com/x402agent/solana-clawd
cd plugins

# Install
bun install

# Dev server
bun dev
```

--------------------------------

### Install DFlow Skills Library

Source: https://github.com/x402agent/solana-clawd/blob/newnew/docs/dflow/agent-cli.md

Install the DFlow Skills library, which provides Claude Code Skills for agents to interact with the CLI. This can be installed during initial setup or later.

```bash
dflow skills install
```

--------------------------------

### Run OpenClawd Examples with tsx

Source: https://github.com/x402agent/solana-clawd/blob/newnew/sdk/examples/README.md

Runs OpenClawd examples directly using `tsx` after cloning the repository and installing dependencies.

```bash
# Clone the repo first
git clone https://github.com/openclawdsolana/openclawd-framework
cd openclawd-framework
npm install

# Then run any example
npx tsx examples/ooda-loop.ts
npx tsx examples/lobster-trader.ts
npx tsx examples/blockchain-buddies-demo.ts
```

--------------------------------

### Configure TutorAgent with System Prompt and Tools

Source: https://github.com/x402agent/solana-clawd/blob/newnew/MemeBRain/mem0-main/docs/cookbooks/frameworks/llamaindex-multiagent.mdx

Set up the TutorAgent, defining its name, description, system prompt, available tools, LLM, and potential handoff targets. The system prompt guides the agent's behavior, emphasizing memory-driven teaching.

```python
from llama_index.agent import FunctionAgent
from llama_index.llms.openai import OpenAI

# AGENTS
# Tutor Agent - Main teaching and explanation
self.tutor_agent = FunctionAgent(
    name="TutorAgent",
    description="Primary instructor that explains concepts and adapts to student needs",
    system_prompt="""
    You are a patient, adaptive programming tutor. Your key strength is REMEMBERING and BUILDING on previous interactions.

    Key Behaviors:
    1. Always check what the student has learned before (use memory context)
    2. Adapt explanations based on their preferred learning style
    3. Reference previous struggles or successes
    4. Build progressively on past lessons
    5. Use assess_understanding to evaluate responses and save insights

    MEMORY-DRIVEN TEACHING:
    - "Last time you struggled with X, so let's approach Y differently..."
    - "Since you prefer visual examples, here's a diagram..."
    - "Building on the functions we covered yesterday..."

    When student shows understanding, hand off to PracticeAgent for exercises.
    """,
    tools=tools,
    llm=self.llm,
    can_handoff_to=["PracticeAgent"]
)
```

--------------------------------

### Clone and Install SDK

Source: https://github.com/x402agent/solana-clawd/blob/newnew/plugin.delivery/packages/sdk/README.md

Instructions for cloning the solana-clawd repository and installing dependencies locally using Bun.

```bash
$ git clone https://github.com/x402agent/solana-clawd
$ cd plugin-sdk
$ bun install
$ bun dev
```

--------------------------------

### List and Run Clawd Examples

Source: https://github.com/x402agent/solana-clawd/blob/newnew/sdk/README.md

Use the `clawd examples` command to list available demos and run specific ones. Some demos do not require API keys.

```bash
clawd examples list          # all 9 demos
clawd examples run ooda      # OODA loop (no key needed)
clawd examples run lobtrader # pump.fun bonding curves
clawd examples run buddies   # Blockchain Buddies
clawd examples run x402sol   # x402 USDC payments
clawd examples run research  # self-improving research client
```

--------------------------------

### Start Clawd Daemon

Source: https://github.com/x402agent/solana-clawd/blob/newnew/chrome-extension/popup.html

Use this command to start the Clawd daemon locally. The shared setup code is located at `~/.clawd/connect/setup-code.txt`.

```bash
clawd nanobot
```

--------------------------------

### Building Documentation Locally with MkDocs

Source: https://github.com/x402agent/solana-clawd/blob/newnew/operator/docs/contributing.md

Commands to install MkDocs, serve the documentation locally for development, and build the static site for deployment.

```bash
# Install MkDocs
pip install mkdocs mkdocs-material

# Serve locally
mkdocs serve

# Build static site
mkdocs build
```
Tokens:
Raw