# Send Noya Agent to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "noya-agent",
    "name": "Noya Agent",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/ali-hajeh/noya-agent",
    "canonicalUrl": "https://clawhub.ai/ali-hajeh/noya-agent",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/noya-agent",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=noya-agent",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "noya-message.sh",
      "reference.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "noya-agent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-02T18:22:41.478Z",
      "expiresAt": "2026-05-09T18:22:41.478Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=noya-agent",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=noya-agent",
        "contentDisposition": "attachment; filename=\"noya-agent-1.0.13.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "noya-agent"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/noya-agent"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/noya-agent",
    "downloadUrl": "https://openagent3.xyz/downloads/noya-agent",
    "agentUrl": "https://openagent3.xyz/skills/noya-agent/agent",
    "manifestUrl": "https://openagent3.xyz/skills/noya-agent/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/noya-agent/agent.md"
  }
}
```
## Documentation

### Noya Agent

Noya is a multi-agent AI system for crypto trading, prediction markets (Polymarket, Rain), token analysis, and DCA strategies. All transactions are gas-sponsored — users pay no gas fees.

Website: agent.noya.ai
API Base URL: https://safenet.one

### Trust & Security

All API calls use HTTPS. Only NOYA_API_KEY is read from the environment.
All on-chain transactions require explicit user confirmation via an interrupt prompt before execution.
Use a short-lived API key (30-day) for testing. Revoke it from Settings > API Keys if compromised.

### Setup

Create an account at agent.noya.ai
Go to Settings > API Keys and generate a key
Store the key securely — it is only shown once
Set the environment variable:

export NOYA_API_KEY="noya_your_key_here"

Configure in ~/.openclaw/openclaw.json:

{
  "skills": {
    "entries": {
      "noya-agent": {
        "enabled": true,
        "apiKey": "noya_your_key_here",
        "env": {
          "NOYA_API_KEY": "noya_your_key_here"
        }
      }
    }
  }
}

### When to Use

Use Noya when users want to:

Check token prices or portfolio balances
Swap, bridge, or send tokens (cross-chain supported)
Analyze tokens and market trends
Trade on Polymarket or Rain prediction markets
Set up or manage DCA (dollar-cost averaging) strategies
View DeFi positions

Don't use for: Non-crypto tasks, local file operations, or general knowledge questions.

### Core Workflow

Every interaction uses the Noya REST API via curl. The main endpoint is POST /api/messages/stream which streams responses. A helper script is provided for this.

### 1. Discover Capabilities (first use)

curl -s -H "x-api-key: $NOYA_API_KEY" \\
  "https://safenet.one/api/agents/summarize" | jq '.data'

Returns all available agent types (token analysis, prediction markets, DCA, etc.) and their tools. Call this once to understand what Noya can do.

### 2. Generate a Thread ID (new conversation)

Generate a UUID v4 for each new conversation topic:

python3 -c "import uuid; print(uuid.uuid4())"

Or on macOS/Linux:

uuidgen | tr '[:upper:]' '[:lower:]'

Each conversation needs a unique UUID. Generate one per topic and reuse it for follow-ups.

### 3. Send Messages (streaming)

Use the provided script to send a message and receive the parsed response:

bash {baseDir}/noya-message.sh "What tokens do I have in my portfolio?" "THREAD_ID_HERE"

The script handles the streaming response, parses --breakpoint-- delimited JSON chunks, and outputs formatted text including messages, tool results, progress indicators, and interrupt prompts.

### 4. Continue the Conversation

Reuse the same thread ID for follow-ups — Noya maintains context:

bash {baseDir}/noya-message.sh "Swap 0.1 ETH to USDC" "SAME_THREAD_ID"

### 5. Respond to Interrupts

When the agent needs confirmation (e.g., before executing a swap), the output includes [REQUIRES INPUT] with options. Send the user's answer as a follow-up in the same thread:

bash {baseDir}/noya-message.sh "Yes" "SAME_THREAD_ID"

### API Reference (curl commands)

All endpoints require the x-api-key header. Base URL: https://safenet.one

### Send Message (streaming) — use the script

bash {baseDir}/noya-message.sh "<message>" "<threadId>"

If you need the raw stream for any reason:

curl -s -X POST "https://safenet.one/api/messages/stream" \\
  -H "Content-Type: application/json" \\
  -H "x-api-key: $NOYA_API_KEY" \\
  -H "x-timezone-name: America/New_York" \\
  -d '{"message": "What is the price of ETH?", "threadId": "YOUR_UUID"}'

The raw response is --breakpoint--\\n delimited JSON chunks with keep-alive\\n\\n pings. Chunk types: message, tool, interrupt, progress, reasonForExecution, executionSteps, error.

### List Threads

curl -s -H "x-api-key: $NOYA_API_KEY" \\
  "https://safenet.one/api/threads" | jq '.data.threads'

### Get Thread Messages

curl -s -H "x-api-key: $NOYA_API_KEY" \\
  "https://safenet.one/api/threads/THREAD_ID/messages" | jq '.data.messages'

### Delete Thread

curl -s -X DELETE -H "x-api-key: $NOYA_API_KEY" \\
  "https://safenet.one/api/threads/THREAD_ID"

### Get Agent Summary

curl -s -H "x-api-key: $NOYA_API_KEY" \\
  "https://safenet.one/api/agents/summarize" | jq '.data'

### Chat Completion (OpenAI-compatible, no agent tools)

curl -s -X POST "https://safenet.one/api/chat/completions" \\
  -H "Content-Type: application/json" \\
  -H "x-api-key: $NOYA_API_KEY" \\
  -d '{"sessionId": "SESSION_ID", "message": "Hello, what can you do?"}'

### Get Session History

curl -s -H "x-api-key: $NOYA_API_KEY" \\
  "https://safenet.one/api/chat/session/SESSION_ID" | jq '.messages'

### Clear Session

curl -s -X DELETE -H "x-api-key: $NOYA_API_KEY" \\
  "https://safenet.one/api/chat/session/SESSION_ID"

### Check Portfolio

User: "What's in my wallet?"

1. Generate a thread ID: uuidgen | tr '[:upper:]' '[:lower:]'
2. bash {baseDir}/noya-message.sh "What tokens do I have in my portfolio?" "$THREAD_ID"
→ Returns wallet address, token balances, and portfolio data

### Token Swap

User: "Swap 0.5 ETH to USDC"

1. Generate a thread ID
2. bash {baseDir}/noya-message.sh "Swap 0.5 ETH to USDC" "$THREAD_ID"
→ Noya prepares the swap, asks for confirmation (interrupt), then executes.
   All gas fees are sponsored. User must confirm before execution.
3. bash {baseDir}/noya-message.sh "Yes" "$THREAD_ID"  # after user confirms

### Token Analysis

User: "Analyze SOL for me"

1. Generate a thread ID
2. bash {baseDir}/noya-message.sh "Give me a detailed analysis of SOL" "$THREAD_ID"
→ Returns price data, market trends, and analysis

### DCA Strategy

User: "Set up a DCA for ETH"

1. Generate a thread ID
2. bash {baseDir}/noya-message.sh "Set up a weekly DCA strategy for ETH with $50" "$THREAD_ID"
→ Noya configures the DCA strategy and confirms details

### Prediction Markets

User: "What are the top Polymarket events?"

1. Generate a thread ID
2. bash {baseDir}/noya-message.sh "Show me the top trending Polymarket events" "$THREAD_ID"
→ Returns current events, markets, and trading options

### Transaction Confirmation

Noya always asks for user confirmation before executing on-chain transactions (swaps, bridges, transfers, orders). The response will include a [REQUIRES INPUT] section with details and options. Always relay this to the user and send their answer as a follow-up in the same thread. Never auto-confirm transactions.

### Wallet Delegation (Website Only)

If Noya responds with a delegation request, the user must complete this on the website:

"To delegate your wallet, visit https://agent.noya.ai and click
'Delegate Wallet' in the chat. This is a one-time action."

### Safe Deployment (Website Only)

If Noya responds with a Safe deployment request, the user must complete this on the website:

"To deploy your Polymarket Safe, visit https://agent.noya.ai and click
'Deploy Safe Now'. This is free, takes ~30 seconds, and only needs to be done once."

### Error Handling

ErrorSolution401 UnauthorizedAPI key is invalid, expired, or revoked. Generate a new one at agent.noya.ai400 Bad RequestMissing message or threadId in request body429 Rate limitWait a few minutes. Limit is 15 requests per 5-minute window

### Scripts

This skill includes the following script in its directory:

ScriptPurposenoya-message.shSend a message to the Noya agent and parse the streamed response. Usage: bash {baseDir}/noya-message.sh "<message>" "<threadId>"

### Additional Resources

For the complete REST API specification, see {baseDir}/reference.md
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: ali-hajeh
- Version: 1.0.13
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-02T18:22:41.478Z
- Expires at: 2026-05-09T18:22:41.478Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/noya-agent)
- [Send to Agent page](https://openagent3.xyz/skills/noya-agent/agent)
- [JSON manifest](https://openagent3.xyz/skills/noya-agent/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/noya-agent/agent.md)
- [Download page](https://openagent3.xyz/downloads/noya-agent)