Quickstart

Before you start

You’ll need:

An ImaRobot account — sign up free at app.imarobot.ai
An API key from app.imarobot.ai/settings/api-keys

You do NOT need a domain name. Every ImaRobot account gets an auto-assigned issuer namespace like yourname.agents.imarobot.ai. Your agents are immediately verifiable.

Choose your path

🤖 Personal Agent / OpenClaw Skill

Building a hobby project, personal assistant, or OpenClaw skill? Start here — no domain needed.

🏢 Organization / Enterprise

Building for a company or team? You can use your own domain as issuer.

Personal Agent

Step 1: Register an agent

No issuer_domain needed — ImaRobot auto-assigns your namespace (e.g., yourname.agents.imarobot.ai).

curl -X POST https://api.imarobot.ai/v1/agents/register \
  -H "Authorization: Bearer sk_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "MyFirstAgent",
    "scopes": ["read:data", "write:data"]
  }'

Response:

{
  "agent_id": "agt_abc123",
  "name": "MyFirstAgent",
  "issuer": "yourname.agents.imarobot.ai",
  "scopes": ["read:data", "write:data"],
  "token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expires_at": "2026-03-28T18:00:00.000Z",
  "verify_url": "https://api.imarobot.ai/v1/verify/eyJ..."
}

Save the token — it’s your agent’s passport. Share the verify_url with anyone who needs to verify your agent.

Step 2: Verify the token

Anyone can verify your agent — no API key required:

curl https://api.imarobot.ai/v1/verify/eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...

Response:

{
  "valid": true,
  "agent_id": "agt_abc123",
  "name": "MyFirstAgent",
  "issuer": "yourname.agents.imarobot.ai",
  "scopes": ["read:data", "write:data"],
  "expires_at": "2026-03-28T18:00:00.000Z",
  "verified_at": "2026-03-27T18:00:01.234Z"
}

That’s it — your agent has a verified identity. 🎉

Using the OpenClaw Skill

If you’re running OpenClaw, the ImaRobot skill makes this even easier:

# Register (issuer auto-assigned)
node imarobot.js register --name "Rosie" --scopes "read,write"

# Verify a token from another agent
node imarobot.js verify eyJhbGci...

# Check your agent's status
node imarobot.js status

Organization

For teams and companies, you can optionally use your own domain as issuer (requires Developer plan or above).

Step 1: Register an agent with your domain

curl -X POST https://api.imarobot.ai/v1/agents/register \
  -H "Authorization: Bearer sk_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "SupportBot",
    "issuer_domain": "yourcompany.com",
    "scopes": ["read:tickets", "write:responses"],
    "description": "Customer support automation agent"
  }'

Don’t have a domain yet? No problem — just omit issuer_domain and your agent will be issued under yourorg.agents.imarobot.ai. You can verify a custom domain later.

Step 2: Verify your domain (optional, recommended)

Add a DNS TXT record to prove you own the domain. See Domain Verification for details. Verified domains get a higher trust level in verification responses.

Step 3: Verify the token

Same as personal agents — anyone can verify:

curl https://api.imarobot.ai/v1/verify/eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...

Step 3: Add verification to your API

Install the Verify SDK:

npm install imarobot-verify

Add 3 lines to your Express app:

import { createVerifier } from 'imarobot-verify';

const { middleware } = createVerifier({
  publishableKey: 'pk_live_YOUR_KEY'
});

// Protect any route — only verified agents can access
app.get('/api/data', middleware(), (req, res) => {
  const { agentId, scopes } = req.agent;
  res.json({ message: `Hello, agent ${agentId}` });
});

Every request to /api/data now requires a valid ImaRobot token. Invalid or revoked tokens get a 401 automatically.

Step 4: Revoke when needed

curl -X POST https://api.imarobot.ai/v1/agents/agt_abc123/revoke \
  -H "Authorization: Bearer sk_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "reason": "Credential rotation" }'

Revocation is immediate — no cache lag. Verify the same token again and it returns:

{
  "valid": false,
  "error": "TOKEN_REVOKED"
}

Your issuer namespace

Every ImaRobot account gets an auto-assigned namespace:

Account type	Issuer format	Example
Personal / Free	`{username}.agents.imarobot.ai`	`rosie.agents.imarobot.ai`
Organization	`{org-name}.agents.imarobot.ai`	`acme-corp.agents.imarobot.ai`
Custom domain (Developer+)	`yourdomain.com`	`acme.com`

Want to use your own domain? Upgrade to Developer and verify it in Settings.

Next steps

Verify SDK docs

Offline mode, middleware options, and framework integrations.

Agent SDK docs

Token lifecycle

Understand expiry, revocation, and offline validation.

API reference

Full endpoint docs.

Getting started

Core concepts

SDKs

Guides

Before you start

Choose your path

🤖 Personal Agent / OpenClaw Skill

🏢 Organization / Enterprise

Personal Agent

Step 1: Register an agent

Step 2: Verify the token

Using the OpenClaw Skill

Organization

Step 1: Register an agent with your domain

Step 2: Verify your domain (optional, recommended)

Step 3: Verify the token

Step 3: Add verification to your API

Step 4: Revoke when needed

Your issuer namespace

Next steps

Verify SDK docs

Agent SDK docs

Token lifecycle

API reference

​Before you start

​Choose your path

🤖 Personal Agent / OpenClaw Skill

🏢 Organization / Enterprise

​Personal Agent

​Step 1: Register an agent

​Step 2: Verify the token

​Using the OpenClaw Skill

​Organization

​Step 1: Register an agent with your domain

​Step 2: Verify your domain (optional, recommended)

​Step 3: Verify the token

​Step 3: Add verification to your API

​Step 4: Revoke when needed

​Your issuer namespace

​Next steps

Verify SDK docs

Agent SDK docs

Token lifecycle

API reference

Before you start

Choose your path

Personal Agent

Step 1: Register an agent

Step 2: Verify the token

Using the OpenClaw Skill

Organization

Step 1: Register an agent with your domain

Step 2: Verify your domain (optional, recommended)

Step 3: Verify the token

Step 3: Add verification to your API

Step 4: Revoke when needed

Your issuer namespace

Next steps