Noya Agent

Noya 是一个面向加密货币交易、预测市场（Polymarket、Rain）、代币分析及 DCA 策略的多智能体 AI 系统。所有链上交易均由平台承担 Gas 费 —— 用户无需支付任何 Gas 费用。

• 官网：agent.noya.ai
• API 基础地址：https://safenet.one

信任与安全

• 所有 API 调用均通过 HTTPS 协议进行。NOYA_API_KEY 是唯一从环境变量中读取的敏感信息。
• 所有链上交易（如 swap、bridge、transfer）在执行前均需用户显式确认，系统将通过中断提示（interrupt prompt）发起确认请求。
• 建议测试时使用短期有效 API 密钥（有效期 30 天）。若密钥泄露，请立即前往 Settings > API Keys 页面将其撤销。

配置步骤

1. 在 agent.noya.ai 注册账号
2. 进入 Settings > API Keys 页面并生成新密钥
3. 妥善保存该密钥 —— 密钥仅在生成时显示一次，后续无法再次查看
4. 设置环境变量：

export NOYA_API_KEY="noya_your_key_here"

在 ~/.openclaw/openclaw.json 中完成配置：

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

适用场景

当用户希望执行以下操作时，请使用 Noya：

• 查询代币价格或投资组合余额
• 执行代币兑换（swap）、跨链桥接（bridge）或转账（send），支持跨链操作
• 分析代币基本面与市场趋势
• 在 Polymarket 或 Rain 预测市场中交易
• 创建或管理 DCA（定投）策略
• 查看 DeFi 头寸（positions）

不适用于：非加密相关任务、本地文件操作或通用知识类问答。

核心工作流

每次交互均通过 curl 调用 Noya REST API 完成。主接口为 POST /api/messages/stream，该接口以流式方式返回响应。配套提供了一个封装脚本用于简化调用。

1. 探查能力（首次使用）

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

返回所有可用的智能体类型（如代币分析、预测市场、DCA 等）及其支持的工具列表。建议首次使用前调用一次，以全面了解 Noya 的能力边界。

2. 生成会话 ID（开启新对话）

每个新对话主题需生成一个 UUID v4：

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

macOS/Linux 用户可使用：

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

每场对话必须使用唯一的 UUID。请按主题分别生成，并在后续追问中复用同一 ID 以维持上下文。

3. 发送消息（流式响应）

使用提供的脚本发送消息并解析结构化响应：

bash {baseDir}/noya-message.sh "我的投资组合中有哪些代币？" "THREAD_ID_HERE"

该脚本自动处理流式响应，按 --breakpoint-- 分隔符解析 JSON 数据块，并输出格式化的文本结果，包括：消息内容、工具调用结果、进度指示器以及中断提示（interrupt prompts）。

4. 继续对话

对同一主题的后续提问，请复用相同的 thread ID —— Noya 将自动维护上下文：

bash {baseDir}/noya-message.sh "将 0.1 ETH 兑换为 USDC" "SAME_THREAD_ID"

5. 响应中断请求

当智能体需要用户确认（例如执行 swap 前），输出中将包含标记为 [REQUIRES INPUT] 的选项列表。请将用户的明确答复作为后续消息，提交至同一 thread ID：

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

API 参考（curl 命令）

所有接口均需携带 x-api-key 请求头。基础地址：https://safenet.one

发送消息（流式）—— 推荐使用封装脚本

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

如需直接处理原始流式响应：

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": "ETH 当前价格是多少？", "threadId": "YOUR_UUID"}'

原始响应为以 --breakpoint--\n 分隔的 JSON 数据块，并包含 keep-alive\n\n 心跳信号。数据块类型包括：message、tool、interrupt、progress、reasonForExecution、executionSteps、error。

列出所有会话

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

获取指定会话的消息记录

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

删除指定会话

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

获取智能体能力摘要

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

聊天补全（兼容 OpenAI 格式，不启用智能体工具）

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": "你好，你能做什么？"}'

获取会话历史记录

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

清空会话

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

常见操作模式

查看投资组合

用户：“我的钱包里有什么？”

1. 生成会话 ID：uuidgen | tr '[:upper:]' '[:lower:]'
2. bash {baseDir}/noya-message.sh "我的投资组合中有哪些代币？" "$THREAD_ID"
→ 返回钱包地址、各代币余额及整体投资组合数据

代币兑换（Swap）

用户：“将 0.5 ETH 兑换为 USDC”

1. 生成会话 ID
2. bash {baseDir}/noya-message.sh "将 0.5 ETH 兑换为 USDC" "$THREAD_ID"
→ Noya 准备兑换操作，发起确认中断（interrupt），随后执行。
   所有 Gas 费由平台赞助。用户必须主动确认后方可执行。
3. bash {baseDir}/noya-message.sh "是" "$THREAD_ID"  # 用户确认后执行

代币分析

用户：“帮我分析 SOL”

1. 生成会话 ID
2. bash {baseDir}/noya-message.sh "请提供关于 SOL 的详细分析报告" "$THREAD_ID"
→ 返回价格数据、市场趋势及深度分析结论

DCA 策略

用户：“为 ETH 设置 DCA 策略”

1. 生成会话 ID
2. bash {baseDir}/noya-message.sh "为 ETH 设置每周定投策略，金额为 50 美元" "$THREAD_ID"
→ Noya 配置 DCA 策略并确认各项参数细节

预测市场

用户：“当前 Polymarket 上有哪些热门事件？”

1. 生成会话 ID
2. bash {baseDir}/noya-message.sh "展示当前 Polymarket 上最热门的事件列表" "$THREAD_ID"
→ 返回当前活跃事件、对应市场及交易选项

重要注意事项

链上交易确认机制

Noya 在执行任何链上交易（如 swap、bridge、transfer、order）前，始终要求用户手动确认。响应中将包含 [REQUIRES INPUT] 区域，列明交易详情与可选操作。请务必向用户完整呈现该提示，并将用户回复作为后续消息提交至同一 thread ID。严禁自动确认任何交易。

钱包委托（仅限网页端）

若 Noya 返回 委托钱包（delegation request） 提示，用户须通过网页端完成操作：

"如需委托您的钱包，请访问 https://agent.noya.ai 并在聊天界面点击
‘Delegate Wallet’。此操作仅需执行一次。"

Safe 部署（仅限网页端）

若 Noya 返回 Safe 部署请求（Safe deployment request），用户须通过网页端完成部署：

"如需部署您的 Polymarket Safe，请访问 https://agent.noya.ai 并点击
‘Deploy Safe Now’。此操作完全免费，耗时约 30 秒，且仅需执行一次。"

错误处理

脚本说明

本技能在其目录下包含以下脚本：

附加资源

• 完整 REST API 规范详见 {baseDir}/reference.md