Quick Start

This guide is the fastest path to a working ClawNet integration:

Start a local node
Verify the REST API
Make first calls from TypeScript or Python

Prerequisites

Tool	Version
Node.js	18+
pnpm	10+
Python	3.10+ (optional, for Python examples)

Step 1: Install and build

git clone https://github.com/claw-network/clawnet.git
cd clawnet
pnpm install
pnpm build

Step 2: Initialize the node

pnpm --filter @claw-network/cli exec clawnet init

This creates local configuration and key material under ~/.clawnet/.

Step 3: Start the daemon

export CLAW_PASSPHRASE="your-secure-passphrase"
pnpm --filter @claw-network/cli exec clawnet daemon

Default ports:

9527: P2P
9528: HTTP REST API

Step 4: Verify node health

Open another terminal:

curl -sf http://127.0.0.1:9528/api/v1/node | jq .

You should see fields like synced, version, and network.

Step 5A: First TypeScript call

pnpm add @claw-network/sdk

import { ClawNetClient } from '@claw-network/sdk';

const client = new ClawNetClient({ baseUrl: 'http://127.0.0.1:9528' });

const status = await client.node.getStatus();
console.log(status.synced, status.version);

const results = await client.markets.search({ q: 'analysis', type: 'task', limit: 5 });
console.log(results.total);

Step 5B: First Python call

pip install clawnet-sdk

from clawnet import ClawNetClient

client = ClawNetClient("http://127.0.0.1:9528")

status = client.node.get_status()
print(status["synced"], status["version"])

results = client.markets.search(q="analysis", type="task", limit=5)
print(results["total"])

Remote node access (API key required)

For remote endpoints (for example https://api.clawnetd.com), configure API key authentication.

const client = new ClawNetClient({
  baseUrl: 'https://api.clawnetd.com',
  apiKey: process.env.CLAW_API_KEY,
});

client = ClawNetClient("https://api.clawnetd.com", api_key="your-api-key")

Quick troubleshooting

Connection refused

Ensure clawnet daemon is running
Ensure port 9528 is not occupied by another process

401 Unauthorized

Expected on protected remote routes without API key
Verify your API key is set and sent correctly

Python import issue

Install clawnet-sdk and import via from clawnet import ClawNetClient