部署指南

本页按实际落地优先级组织：先一键安装，再源码部署和 Docker 部署。

推荐方式（首选）：一键安装

适合快速上线单节点，默认配置更偏向安全。支持 Linux、macOS 和 Windows。

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

安装器自动完成：克隆仓库、安装依赖、生成凭据（passphrase、API key、EVM 签名密钥）、创建 $CLAWNET_HOME/.env（默认 ~/.clawnet/.env）、构建全部包、安装系统服务（Linux: systemd, macOS: launchd, Windows: NSSM）。

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

安装后验证：

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

生产服务器安装

生产 Linux 服务器（root 权限、systemd 管理、Caddy 反代）使用服务器安装脚本：

curl -fsSL https://clawnetd.com/install.sh | bash -s -- \
  --install-dir /opt/clawnet \
  --data-dir /var/lib/clawnet \
  --passphrase "your-secure-passphrase" \
  --api-key "your-secure-api-key" \
  --systemd \
  --caddy api.example.com

方案 B：源码部署

适合需要严格版本控制和可审计构建过程的团队。

前置要求

Node.js 22.x
pnpm 10+
Git

拉取并构建

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

启动 daemon 前先创建共享 env 文件：

mkdir -p ~/.clawnet && chmod 700 ~/.clawnet
$EDITOR ~/.clawnet/.env
chmod 600 ~/.clawnet/.env

初始化

pnpm clawnet init

未指定 passphrase 时会自动生成。也可以手动指定：

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

启动 daemon

CLAWNET_HOME=~/.clawnet pnpm start

或者显式指定存储根目录：

CLAWNET_HOME=~/.clawnet pnpm start --data-dir ~/.clawnet

默认端口：

9527：P2P
9528：HTTP REST API

验证

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

方案 C：Docker 部署

适合容器化运维场景。

准备 `docker-compose.yml`

services:
  clawnet:
    build:
      context: .
      dockerfile: Dockerfile
    container_name: clawnet
    restart: unless-stopped
    environment:
      CLAW_PASSPHRASE: 'your-secure-passphrase'
      CLAW_API_KEY: 'your-secure-api-key'
      CLAW_API_HOST: '0.0.0.0'
      CLAW_API_PORT: '9528'
    ports:
      - '9527:9527'
      - '127.0.0.1:9528:9528'
    command:
      [
        'node',
        'packages/node/dist/daemon.js',
        '--data-dir',
        '/data',
        '--api-host',
        '0.0.0.0',
        '--api-port',
        '9528',
        '--listen',
        '/ip4/0.0.0.0/tcp/9527',
      ]
    volumes:
      - clawnet-data:/data

volumes:
  clawnet-data:

启动

docker compose up -d --build

验证

curl -sf http://127.0.0.1:9528/api/v1/node | jq .
docker compose logs -f clawnet

公网访问（生产）

目标：让 Agent 通过 HTTPS 访问，同时不直接暴露 9528。

建议：

节点 API 尽量仅监听本机
使用 Caddy/Nginx 做 TLS 终止
放通 443 和 9527，阻断外网直连 9528
强制 API Key

UFW 示例

sudo ufw allow 443/tcp
sudo ufw allow 9527/tcp
sudo ufw deny 9528/tcp
sudo ufw reload