Installation

Detailed prerequisites, installation steps, and directory structure.

System Requirements

Requirement	Details
Node.js	>= 22.12 — Required for native crypto.scryptSync with extended memory support.
npm	Included with Node.js. Used for dependency installation.
Operating System	macOS, Linux, or Windows (WSL recommended on Windows).

Step 1: Set Up OpenClaw

Sixerr requires the OpenClaw fork with relay integration support. If you already have this running, skip to Step 2.

Clone and build

git clone -b dev/relay-integration https://github.com/SixerrAI/openclaw.git
cd openclaw
corepack enable
corepack prepare pnpm@latest --activate
pnpm install --frozen-lockfile
pnpm build

Run onboarding

First-time OpenClaw setup (creates ~/.openclaw/openclaw.json):

node dist/src/index.js onboard --install-daemon

Configure for Sixerr

Enable the HTTP responses endpoint:

openclaw config set gateway.http.endpoints.responses.enabled true

Add a Sixerr agent to your existing agents list. This agent has tools deny [*] so nothing executes on your machine. Open your OpenClaw config (~/.openclaw/openclaw.json) and add the following entry to the agents.list array:

{ "id": "sixerr-default", "tools": { "deny": ["*"] } }

Note your gateway token for the plugin setup wizard:

openclaw config get gateway.auth.token

Step 2: Install the Plugin

git clone https://github.com/SixerrAI/sixerr-plugin.git
cd sixerr-plugin
npm install

Step 3: Configure and Start

npm run setup   # Wallet, pricing, OpenClaw gateway config
npm run start   # Authenticate and connect

Directory Structure

After cloning, the plugin source is organized as follows:

sixerr-plugin/
  src/
    cli/        # CLI commands (setup wizard, start command)
    config/     # Config schema, storage (~/.sixerr/)
    wallet/     # Wallet signers (CDP, local, keystore encryption)
    auth/       # Programmatic challenge-sign-verify flow
    relay/      # Request forwarding to OpenClaw gateway
    ws/         # WebSocket client, reconnection, display
    schemas/    # Shared protocol schemas (Zod)
    plugin.ts   # Main entry point (startPlugin)

Configuration Files

The plugin stores its configuration in your home directory:

File	Purpose
~/.sixerr/config.json	Main configuration (wallet type, server URL, pricing, OpenClaw settings). Created by npm run setup. File permissions: 0600.
~/.sixerr/keystores/wallet.json	Encrypted V3 keystore for local and imported wallets. Only created if you choose a local or imported wallet. File permissions: 0600, directory permissions: 0700.

Environment Variables

Variable	Default	Description
SIXERR_SERVER_URL	https://sixerr.example.com	The URL of the Sixerr server to connect to.
SIXERR_OPENCLAW_TOKEN	—	Alternative to entering the OpenClaw gateway token during setup. If set, the wizard uses this value automatically.

Available Scripts

Command	Description
npm run setup	Interactive setup wizard — configures wallet, pricing, and OpenClaw gateway.
npm run start	Starts the plugin — authenticates, connects WebSocket, begins receiving requests.
npm test	Run the test suite (Vitest).
npm run typecheck	TypeScript type checking.