CLAWTRADE
RETURN TO TERMINAL

Beginner's Installation Guide for Clawtrade Agent

Welcome! This guide will help you install and run the Clawtrade Agent on your computer, even if you have never written a line of code before.

01. Preparation (What you need)

Before we start, you need a few tools on your computer.

1. Node.js (The Engine)

This agent runs on a platform called Node.js.

  • Check if you have it: Open your terminal (Command Prompt on Windows, Terminal on Mac) and type:
$ node -v

If it says something like v20.10.0, you are good!

If not: Download and install the "LTS" version from nodejs.org.

2. A Code Editor

You need a place to view and edit the files. We strongly recommend VS Code.

Download it here: code.visualstudio.com

02. Getting the Code

You need to get the agent's files onto your computer.

Option A: Using Git (Recommended)

If you have git installed, open your terminal and run:

$ git clone https://github.com/Elishaokon13/ClawBack.git
$ cd ClawBack

Option B: Download ZIP (Easiest)

  1. Go to the GitHub page for this project.
  2. Click the green <> Code button.
  3. Select Download ZIP.
  4. Unzip the folder to somewhere easy to find (like your Desktop).

03. Installation

1. Open the folder in VS Code

  • Open VS Code.
  • Click "File" - "Open Folder...".
  • Select the ClawBack (Clawtrade) folder you just downloaded.

2. Open the Terminal in VS Code

  • In the top menu, click Terminal - New Terminal.
  • A box will appear at the bottom of the screen. This is where you type commands.

3. Install Dependencies

Type this command and hit Enter:

$ npm install

What is happening? The agent is downloading all the "spare parts" and libraries it needs to run. This might take a minute.

04. Configuration (Important!)

The agent needs some "keys" to work (like access to the blockchain and trading systems).

1. Create your configuration file

  • Look at the file list on the left side of VS Code.
  • Find a file named env.example.
  • Right-click it and select Copy.
  • Right-click in the empty space and select Paste.
  • Rename the new file to just .env (it must be exactly .env with the dot at the start).

2. Edit your .env file

Click on .env to open it. You will see lines like BASE_RPC_URL=.... You need to fill these in.

Required Settings:

BASE_RPC_URL

This is how the agent "talks" to the Base blockchain.

  • Free Option: You can use a public one, but getting a free private one from Alchemy or Infura is better for reliability.
  • Example: https://base-mainnet.g.alchemy.com/v2/YOUR-API-KEY

BANKR_API_KEY

This allows the agent to make trades.

  • Go to bankr.bot/api.
  • Sign up and get your "Agent API Key".
  • Copy and paste it here.

BANKR_API_URL

Leave this as https://api.bankr.bot.

Optional Settings (Social Media):

If you want the agent to post on Twitter or Farcaster, fill in those keys. If not, you can leave them blank or ignore them for now.

05. Starting the Agent

You are customizable! Let's turn it on.

1. Run the Agent

In your VS Code terminal, type:

$ npm run dev

2. What to expect

  • You should see text appearing in the terminal.
  • It might say "Scanning block..." or "Initializing...".
  • Success! Your agent is now alive and running.

Troubleshooting

  • "command not found: npm"This means Node.js is not installed correctly. Try reinstalling it.
  • "Error: Missing API Key"Check your .env file again. Did you save it? (File - Save).
  • "Could not resolve host"Check your internet connection.

Enjoy using Clawtrade! 🤖