Run Your First Lobster (OpenClaw)

AiCoin CoinOS works with all major Agents, including OpenClaw, Claude Code, and more. This tutorial walks you through installing OpenClaw from scratch and connecting CoinOS's powerful market data, strategy, backtesting, and Hyperliquid on-chain capabilities to your Agent.

This tutorial is beginner-friendly. Switch to your platform's tab and follow each step. The whole process takes about 5-10 minutes.

0Prerequisites

OpenClaw requires Node.js 22.16+ (Node 24 recommended). If you already have Node.js installed, skip this step.

Recommended: install via winget (built into Windows 10 1709+):

winget install OpenJS.NodeJS.LTS

Or via Chocolatey:

choco install nodejs-lts

You can also download the installer from nodejs.org.

Verify the installation (should show v22.x or v24.x):

node -v

1Install OpenClaw

The installer script auto-detects your environment and installs OpenClaw.

Run in PowerShell:

iwr -useb https://openclaw.ai/install.ps1 | iex

If the installer script fails, you can install manually via npm:

npm install -g openclaw@latest

Note

Native Windows support is still improving. Some Skills and Shell tools may have compatibility issues. If you run into problems, consider switching to WSL2.

After installation, verify it works:

openclaw --version

openclaw command not found?

This usually means npm's global bin directory is not in your PATH. Run these commands to diagnose:

npm prefix -g
echo "$PATH"

2Run the Onboarding Wizard

The onboarding wizard guides you through all essential configuration:

openclaw onboard --install-daemon

The wizard walks you through:

Choose an AI model provider (Anthropic / OpenAI / Ollama, etc.) and configure your API Key
Set workspace path (default: ~/.openclaw/workspace/)
Configure Gateway port and authentication
Optional: set up messaging channels (WhatsApp / Telegram / Discord, etc.)
Install the background daemon so the Gateway starts on boot

Once complete, check if the Gateway is running:

openclaw gateway status

Open the Control UI (browser will open http://127.0.0.1:18789 automatically):

openclaw dashboard

3Connect CoinOS

Choose either method below to connect AiCoin CoinOS capabilities to your Agent:

Method A: Skills (Recommended)

Tell your Agent:

Help me install CoinOS Skills, run: npx skills add aicoincom/coinos-skills

Or install via ClawHub:

npx clawhub install aicoin

The Agent will install automatically and remind you to restart. See GitHub | ClawHub

Method B: MCP Server (Optional)

Tell your Agent:

Add an MCP server named aicoin, command is npx, args are -y @aicoin/aicoin-mcp.
Remind me to restart after setup.

Or add manually:

npx mcporter config add aicoin --command npx --arg -y --arg @aicoin/aicoin-mcp

4Try It Out!

After connecting, tell your Agent in the Control UI or any messaging channel:

What is the current price of BTC?

The Agent will return something like:

BTC is currently priced at $104,250.00.

More examples:

Analyze the long/short sentiment for ETH
Show me whale positions for BTC on Hyperliquid
Place a limit order for 0.1 ETH at 2800 on Binance

5Configure API Credentials (Optional)

The built-in free key works immediately (15 req/min). For higher limits, get your own key.

Go to AiCoin OpenData Platform, register and create an API Key, then tell your Agent:

Tell your Agent:

My AiCoin API Key is xxx, Secret is yyy. Please configure them.

The Agent will automatically save credentials to .env and verify they work.

Credentials are stored at: ~/.openclaw/workspace/.env

6Connect Trading Platforms (Optional)

To operate exchange accounts (place orders, check balances, manage positions), just tell your Agent:

Tell your Agent:

I want to connect my OKX account.

The Agent will guide you through providing your platform API Key and save it to .env.

Supported platforms: Binance, OKX, Bybit, Bitget, Gate, HTX, KuCoin, MEXC, Coinbase, Hyperliquid

Security Tip

Never share your API Key or Secret in chat logs, screenshots, or social media. If you suspect a leak, regenerate your keys immediately on the corresponding platform.

Your Lobster is ready — start exploring!

Having Issues?

If something fails, try the full manual setup flow: Authentication Guide

Useful Commands

openclaw doctor          # Diagnose issues
openclaw status          # Check Gateway status
openclaw dashboard       # Open Control UI
openclaw configure       # Reconfigure
openclaw gateway run     # Run Gateway in foreground