whoareyou

by lineagelabs

Install this Skill

curl -fsSL -o whoareyou.zip https://skill.seembox.com/api/v1/skills/whoareyou/download && unzip whoareyou.zip

SKILL.md About

---
name: whoareyou
version: 3.1.0
description: Show your verified WayID identity card. Use whenever the user asks who you are, who owns you, who you belong to, who's behind you, who runs you, who's responsible, "show your ID", "show your certificate", "prove who you are", "are you real", or any variant of identity / ownership / provenance question.
user-invocable: true
---

# /whoareyou — Verified Identity Card

When a user asks who you are or who runs you (slash command or any natural-language variant — "Who are you?", "Show me your ID", "Who do you belong to?", "Show certificate"), display your verified WayID identity card so they can see who owns and operates you.

> Default Base URL: https://way.je
> The actual base URL comes from `wayidIssuer` in your DID file (see Step 1) — agents claimed on a staging or self-hosted WayID server use that origin instead.

## Rules

- **Read-only.** Never sign anything. Never read keys.
- **One file read, one HTTPS GET, render the result.** Nothing else.
- **NEVER open a browser or attempt to navigate to any URL.** All actions are API calls only.
- Do NOT invent or fabricate data. Only display fields returned by the API.
- If your DID file is missing, tell your human and stop. Do not attempt to claim — that's a separate skill at https://way.je/claim/SKILL.md.

## What to Do

### Step 1: Find Your DID

Read your DID from disk. The exact path depends on what kind of agent you are:

- **OpenClaw default `main` agent:** `{openclaw-path}/workspace/wayid.json`
- **OpenClaw named agent `<agentId>`:** `{openclaw-path}/workspace-<agentId>/wayid.json`
- **Non-OpenClaw agent:** the file your operator stored at claim time. If you don't know the path, ask your human.

The file contains:

```json
{
  "agentId": "<id>",
  "wayidDid": "wayid:agent:...",
  "wayidIssuer": "https://way.je",
  "claimedAt": "<iso8601>"
}
```

Take the `wayidDid` value. Also take the `wayidIssuer` value if present — it's the WayID origin that minted the DID and the only server that can resolve it. If `wayidIssuer` is absent (older claims), default to `https://way.je`.

If no such file exists, tell your human:

> "I haven't been claimed yet — run the WayID claim flow at https://way.je/claim/SKILL.md first."

Stop. Do not invent a DID. Do not attempt to read your keypair to look up a pubkey — the display skill must not touch credentials.

### Step 2: Fetch Your Card

One call — URL-encode the DID (the colons in `wayid:agent:...` must be encoded as `%3A`). Use the `wayidIssuer` from Step 1 as the base URL (default `https://way.je` if missing):

```
GET {wayidIssuer}/api/v1/agent/{urlencoded-did}/card
```

The response shape:

```json
{
  "displayName": "Your Agent Name",
  "owner": { "displayName": "Owner Name", "username": "ownerusername" },
  "verificationStatus": "verified",
  "telegramHandle": "@yourbot",
  "certificateUrl": "https://way.je/agent/your-username"
}
```

`verificationStatus` is one of `"verified"`, `"claim"`, or `"unverified"`. `telegramHandle` is `null` if no Telegram channel is bound to this agent. `owner` is `null` if the owner has not yet completed their profile.

If the API returns 404, either your DID is stale (the agent was deleted or migrated) or your `wayidIssuer` is pointing at the wrong WayID server (e.g. you were claimed on `staging.way.je` but the file falls back to `https://way.je`). Tell your human verbatim — including which base URL you queried — and stop. Do not reclaim, do not retry.

### Step 3: Display the Card

Render the card in **exactly** this format. The badge line and the bound-Telegram line are conditional — see below.

#### Template

```
🛡 **{displayName}**

{boundLine}

Owner: **{owner.displayName}** (WayID: human.{owner.username})
{badgeLine}

[View Certificate →]({certificateUrl})
```

#### `{boundLine}`

- If `telegramHandle` is set: `{telegramHandle} is bound to a WayID-verified owner.`
- Otherwise: `This agent is bound to a WayID-verified owner.`

#### `{badgeLine}` — map `verificationStatus` to:

| `verificationStatus` | Render exactly                  |
| -------------------- | ------------------------------- |
| `verified`           | `✓ Verified Human`              |
| `claim`              | `+ Alias`                       |
| `unverified`         | `✕ Unverified`                  |

#### `{owner}` is null

If `owner` is `null`, replace the Owner line with:

```
Owner: profile not yet completed
```

…and omit the `{badgeLine}` entirely.

## What is WayID?

WayID is provenance infrastructure for AI agents. It binds verified human identities to their AI agents, giving consumers a way to verify agent ownership and reputation — like SSL certificates, but for AI agents.

_meta.json Metadata

{
  "ownerId": "kn7435zt7yt4xct7hk168xfcgx83455d",
  "publishedAt": 1778069712116,
  "slug": "whoareyou",
  "version": "3.1.0"
}