Run Your First Lobster (OpenClaw)

AiCoin CoinOS works with all major Agents, including OpenClaw, Claude Code, and more. This tutorial uses OpenClaw as an example — five steps to connect CoinOS's powerful market data, strategy, backtesting, and Hyperliquid on-chain capabilities to your Agent.

Step 1: Install OpenClaw

If you haven't installed OpenClaw yet:

curl -fsSL https://openclaw.ai/install.sh | bash

Or install via npm:

npm i -g openclaw

Once installed, open your terminal and run openclaw tui to start.

Step 2: Connect to CoinOS

Choose either method below:

Method A: Skills (Recommended)

Tell your Agent:

Help me install AiCoin Skills, run: npx skills add aicoincom/aicoin-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

Step 3: Try It Out!

After connecting, tell your Agent:

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

Step 4: Configure 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

Step 5: Connect Platform (Optional)

To operate platform accounts (execute operations, 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 Agent is ready — start exploring!

Having Issues?

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