Connect to OpenClaw

This guide gets your OpenClaw agent connected to Shuriken in about 2 minutes. Once set up, your agent can monitor your alpha groups, research tokens, check your portfolio, and execute trades - all through WhatsApp, Telegram, Discord, or the built-in Control UI. Time required: About 2 minutes.

Prerequisites

OpenClaw installed and running (openclaw gateway status should show it’s active)
A Shuriken Agent Key (create one here if you haven’t already)

Step-by-step setup

Copy your Agent Key

If you just created your key, copy it from the setup screen. It starts with sk_.If you already closed that screen, you’ll need to create a new key - keys are only shown once.

Open the config file

OpenClaw stores its config in a JSON5 file called openclaw.json.Option A: Use the CLI (recommended)

openclaw configure

Option B: Use the Control UIOpen http://127.0.0.1:18789 in your browser and go to the Config tab.Option C: Edit the file directly

Windows
macOS / Linux

%USERPROFILE%\.openclaw\openclaw.json

~/.openclaw/openclaw.json

Add the Shuriken MCP server

Add the following mcpServers block to your openclaw.json. Replace YOUR_AGENT_KEY with the key you copied in step 1.If you don’t have any MCP servers yet, add this to your config:

openclaw.json

{
  // ...your existing config...
  mcpServers: {
    Shuriken: {
      url: "https://api.shuriken.trade/mcp",
      headers: {
        Authorization: "AgentKey YOUR_AGENT_KEY"
      }
    }
  }
}

If you already have MCP servers, add the shuriken block inside the existing mcpServers object:

openclaw.json

{
  mcpServers: {
    "your-existing-server": {
      // ...
    },
    Shuriken: {
      url: "https://api.shuriken.trade/mcp",
      headers: {
        Authorization: "AgentKey YOUR_AGENT_KEY"
      }
    }
  }
}

OpenClaw uses JSON5 format, so you don’t need to quote keys or worry about trailing commas. But standard JSON also works.

Save and reload

OpenClaw watches the config file and applies changes automatically - no restart needed in most cases.If the tools don’t appear, restart the gateway:

openclaw gateway restart

Verify the connection

Open the Control UI at http://127.0.0.1:18789 or message your agent through any connected channel (WhatsApp, Telegram, Discord, etc.) and try:

What tokens were called in my Discord today?

What's my SOL balance?

If you see results from Shuriken, you’re all set. Your OpenClaw agent is now connected.

Troubleshooting

Config validation error on startup

OpenClaw strictly validates its config. If the gateway won’t start after your changes:

openclaw doctor --fix

This will diagnose and suggest repairs. Common issues: unknown keys, malformed types, or invalid JSON5 syntax.

Tools not appearing

Make sure the mcpServers block is at the root level of your config (not nested inside another section)
Check that your Agent Key is correct (starts with sk_)
Make sure you included the AgentKey prefix before the key (with a space)
Try restarting the gateway: openclaw gateway restart

Tools show up but return errors

Double-check your Agent Key hasn’t been revoked on the Agent Keys dashboard
Make sure the key has the permissions needed for the tool you’re trying to use (see Permissions)

​Prerequisites

​Step-by-step setup

​Troubleshooting

Prerequisites

Step-by-step setup

Troubleshooting