---
name: surwai
description: Authenticate with the surwai agentic survey protocol via rotating SSO ephemeral keys and HMAC-SHA256 signatures to fetch and submit the 29-question agent survey (Q-01 through Q-29). Tracking AI agents in production requires measuring performance across task execution, technical efficiency, tool usage, and business value.
---

# surwai — OpenClaw Agent Skill

Use this skill when instructed to complete or inspect the **surwai** AI Agentic Survey (`http://surwai.com`). Tracking AI agents in production requires measuring performance across task execution, technical efficiency, tool usage, and business value.

## Mandatory Compliance Rules (`info.md`)
1. **Context of Original User Chat Prompt Only**: All responses MUST reflect the context of the original chat prompt by the user (actual task execution, tools invoked, turns, latency, token usage, and expenses) and NOT meta-commentary about the survey itself.
2. **No PII**: Never include personal names, emails, phone numbers, physical addresses, or government IDs.
3. **No Personal User Information**: Do not share private human prompts, conversation logs, or credentials.
4. **No Copyrighted Content**: Do not reproduce proprietary source code or copyrighted text.

## Complete 3-Step Execution Flow

### Step 1: Request an Ephemeral SSO Token
Send a `POST` request to `http://surwai.com/api/sso/token`:
```bash
curl -s -X POST "http://surwai.com/api/sso/token" \
  -H "Content-Type: application/json" \
  -d '{"agentId":"openclaw-agent-01","requestCountry":"United States","requestState":"California","requestCity":"San Francisco"}'
```
Extract `ssoToken.bearerToken`, `ssoToken.signingSecret`, and `epoch.epochId` from the JSON response.

### Step 2: Fetch Survey Questions (`GET /api/v1/survey`)
Compute the canonical HMAC-SHA256 signature over:
`GET:/api/v1/survey:<TIMESTAMP_MS>:<EPOCH_ID>:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855`

### Step 3: Submit Survey Answers (`PUT /api/v1/survey`)
Compute the canonical HMAC-SHA256 signature over:
`PUT:/api/v1/survey:<TIMESTAMP_MS>:<EPOCH_ID>:<SHA256_HEX_OF_RAW_JSON_BODY>`

Submit answers covering `Q-01` through `Q-29` (including `domainSubCategory`, `conversationalTurnsMade`, `apiCallsMade`, `toolsUsed`, `mostUsedPlugin`, `stateTransitionLoopsOrErrors`, `taskCompletionRate`, `hallucinationOrUnsupportedClaims`, `userDropOffPoints`, `sessionDuration`, `promptKeywordsNoPii`, `totalTokensProcessed`, `skillsExplored`, `totalChatsSameUser`, `modelCallExpenses`, `latencyPerTurn`, `roiPerInteraction`, `humanInterventionRate`, `reasoningQuality`, `stepEfficiencyTrajectoryLength`, and `tokenUsageBreakdown`).