🤖 OpenClaw Bot Integration

Install the Soulprint Skill

OpenClaw agents use the ClawHub skill registry. Install Soulprint into any agent workspace:

clawhub install soulprint

This adds the skills/soulprint/SKILL.md file to your workspace. The agent will automatically discover and use it for Soulprint-related tasks.

What the Skill Enables

Once installed, your OpenClaw agent can:

• Guide users through npx soulprint verify-me step by step
• Check a user's trust score and explain what each credential means
• Help users renew expired tokens
• Launch and monitor a validator node
• Integrate Soulprint middleware into projects being built by the agent
• Debug token errors and score issues
• Run the full verification flow as part of an onboarding workflow

Agent Workflow Examples

Example 1 — Verify a new user

A user messages your OpenClaw bot: "I want to verify my identity"

// Agent detects Soulprint intent → reads skill → responds:

"Sure! Let's verify your identity with Soulprint.
Run this in your terminal:

  npx soulprint install-deps   ← one-time setup (~200 MB)
  npx soulprint verify-me      ← interactive verification

You'll need your government ID and a camera.
Everything runs locally — nothing is uploaded.

Once done, send me the output of: npx soulprint show"

Example 2 — Check identity before an action

Build an agent that gates premium features behind identity:

// In your agent's logic (via MCP tool gating):
// 1. User requests a premium action
// 2. Agent checks if token exists and score is sufficient
// 3. If not → guides user through verify-me
// 4. If yes → proceeds with the action

const check = await exec("npx soulprint show --json");
const token = JSON.parse(check.stdout);

if (token.score < 60) {
  reply("Your current score is " + token.score + "/100. To access this feature, you need 60+. Run: npx soulprint verify-me");
} else {
  // proceed with premium action
}

Example 3 — Auto-run validator node

An OpenClaw agent managing infrastructure can auto-start a validator node:

// Agent prompt: "Start a Soulprint validator node in background"

// Agent reads the soulprint skill, then executes:
exec("npx soulprint node", { background: true });

// Monitor the node:
exec("curl http://localhost:4888/info");
// Returns: { peerId, score, attestationsIssued, peers }

Example 4 — Integrate into a project being built

When an agent is helping build a Node.js app and the user says "add identity gates":

// Agent installs the package:
exec("npm install soulprint-express");

// Agent adds middleware to app.ts:
writeFile("src/middleware/identity.ts", `
import { soulprintMiddleware } from "soulprint-express";
export const requireIdentity = soulprintMiddleware({ minScore: 60 });
`);

// Agent applies it to protected routes automatically

Multi-Agent Scenarios

Soulprint works across multi-agent systems. A parent agent can pass identity tokens to sub-agents:

// Parent agent receives user token
const userToken = req.headers["x-soulprint-token"];

// Spawn sub-agent with identity context
sessions_spawn({
  task: "Process this job application: " + applicationData,
  env: { SOULPRINT_TOKEN: userToken }
});

// Sub-agent can verify the token independently:
// clawhub install soulprint → reads SOULPRINT_TOKEN → verifies identity

OpenClaw + mcp-colombia-hub

The mcp-colombia-hub MCP server has full Soulprint integration. Install both skills for a complete Colombian services + identity stack:

clawhub install soulprint
clawhub install mcp-colombia

With both installed, your agent can:

• Search MercadoLibre products — open to all
• Search hotels & flights — open to all
• Compare CDTs and simulate credits — requires score ≥ 40
• Apply for jobs (trabajo_aplicar) — requires score ≥ 40

Environment Variables

Useful Commands for Agents

# Check if user is verified
npx soulprint show --json

# Verify identity interactively
npx soulprint verify-me

# Renew an expiring token
npx soulprint renew

# Check a specific DID's reputation
npx soulprint reputation <did>

# Start validator node
npx soulprint node

# Verify a raw token string
npx soulprint verify-token <token>

Skill Auto-Detection

OpenClaw agents auto-load skills when the user's request matches the skill description. The Soulprint skill is triggered by requests like:

• "Verify my identity for this AI agent"
• "Run a Soulprint validator node"
• "Add identity verification to my MCP server"
• "Check the reputation score of a bot or DID"
• "Generate a privacy proof from my ID"
• "Issue or verify an SPT token"