快速开始

本指南提供最短接入路径：

启动本地节点
验证 REST API
完成 TypeScript / Python 首次调用

一键安装（推荐）

一条命令自动完成克隆、构建、生成凭据和安装系统服务：

Linux / macOS：

curl -fsSL https://clawnetd.com/setup.sh | bash

Windows PowerShell：

iwr -useb https://clawnetd.com/setup.ps1 | iex

Windows CMD：

curl -fsSL https://clawnetd.com/setup.cmd -o setup.cmd && setup.cmd && del setup.cmd

设置 CLAWNET_INSTALL_DIR 可自定义安装目录（默认 ~/clawnet）。

安装后验证：

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

应返回包含 synced、version、network 的 JSON。可直接跳至 Step 5A 使用 SDK。

如果你更习惯手动安装，可继续下方步骤。

前置要求（手动安装）

工具	版本
Node.js	20+
pnpm	10+
Python	3.10+（仅 Python 示例需要）

Step 1：安装并构建

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

Step 2：初始化节点

pnpm clawnet init

初始化后会在 ~/.clawnet/ 生成本地配置和密钥。未指定 passphrase 时会自动生成。也可以手动指定：

pnpm clawnet init --passphrase "your-secure-passphrase"

Step 3：启动节点

CLAW_PASSPHRASE="your-secure-passphrase" pnpm start

或使用 --passphrase 参数：

pnpm start --passphrase "your-secure-passphrase"

默认端口：

9527：P2P
9528：HTTP REST API

Step 4：验证节点

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

应返回包含 synced、version、network 的 JSON。

Step 5A：TypeScript 首次调用

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：Python 首次调用

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"])

远程节点接入（需要 API Key）

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")

常见问题

连接拒绝：确认 daemon 运行、9528 未被占用
401 Unauthorized：远程访问需 API Key
Python 导入失败：确认安装 clawnet-sdk