¿Qué hace OKX OnChainOS — Directorio de Skills?
Qué es este archivo: una página de directorio que apunta al repositorio oficial
onchainos-skillsde OKX. No contiene lógica propia — cada sub-skill listado vive enokx/onchainos-skillsy se obtiene fresco al instalarse, asegurando que siempre tengas la última versión.
OKX OnChainOS es un conjunto de 8 sub-skills especializados que cubren comercio en cadena, análisis de mercado, señales de smart money, inversión y posiciones en DeFi, operaciones de cartera, escaneo de seguridad, protocolos de pago, identidad de agente y marketplace de tareas, y noticias y sentimiento cripto en más de 20 blockchains (Ethereum, Solana, XLayer, Base, BSC, Arbitrum, Polygon, Optimism, Avalanche, TRON, …).
La mayoría de los sub-skills utilizan un único binario, onchainos, que se
descarga en el primer uso. Un subconjunto de capacidades (datos de solo lectura)
también se puede acceder sin el binario, a través del proxy sc-proxy de
Starchild — consulte las Opciones de autenticación más abajo.
Cómo funciona la instalación
# Instalar un sub-skill (recomendado — obtienes solo lo que necesitas)
npx skills add okx/onchainos-skills@<nombre-del-sub-skill>
# O en formato largo
npx skills add https://github.com/okx/onchainos-skills --skill <nombre-del-sub-skill>
# Instalar todo (detecta automáticamente tu entorno e instala según corresponda)
npx skills add okx/onchainos-skills
Cada sub-skill incluye su propio SKILL.md + documentación de referencia + frases de activación, para que puedas obtener solo lo que necesitas.
Marketplace de plugins (alternativa):
/plugin marketplace add okx/onchainos-skills
/plugin install onchainos-skills
Instalación CLI (el binario onchainos — detecta automáticamente la
plataforma, verifica SHA256, instala en ~/.local/bin o
%USERPROFILE%\.local\bin):
# macOS / Linux
curl -sSL https://raw.githubusercontent.com/okx/onchainos-skills/main/install.sh | sh
# añadir `-s -- --beta` para la última pre-release (opt-in solo; nunca degrada)
# Windows
irm https://raw.githubusercontent.com/okx/onchainos-skills/main/install.ps1 | iex
Cartera — por defecto usar la Agent Wallet del usuario
Usa el skill wallet de la plataforma para firmar y transmitir. Los endpoints
de OKX DEX devuelven calldata sin firmar ({to, value, data, ...}); pásalo a
wallet_transfer(data=<calldata>) y listo. No necesitas una cartera separada de
OKX.
Usa la cartera TEE de OnchainOS (onchainos wallet login <correo>) solo cuando
el usuario lo solicite explícitamente.
Opciones de autenticación (lea esto antes de invocar cualquier cosa)
Hay dos rutas distintas. Elija según lo que el agente necesite hacer:
Ruta A — HTTP directo a través del sc-proxy de Starchild (sin necesidad de clave API)
Para consultas de datos de solo lectura (precios, velas, señales de smart
money, análisis de tokens, comprobaciones de seguridad, carteras de direcciones
públicas — ≈ 80 % de las capacidades de OnchainOS), el agente puede omitir
completamente el CLI y llamar a
https://web3.okx.com/... directamente a través de sc-proxy:
from core.http_client import proxied_get
r = proxied_get(
"https://web3.okx.com/api/v6/dex/aggregator/supported/chain",
headers={"SC-CALLER-ID": f"chat:{thread_id}"},
)
sc-proxy inyecta automáticamente las credenciales OKX de la plataforma, firma cada solicitud con HMAC-SHA256 y factura los créditos de Starchild del emisor.
- Coste: $0.001 / solicitud
- Límite de velocidad: 60 solicitudes/min
- Configuración: ninguna
- Límites: solo datos — no puede enviar transacciones ni gestionar carteras
Ruta B — CLI onchainos con tu propia clave API de OKX Web3
Para operaciones de cartera (wallet login, wallet send, wallet contract-call), swaps DEX que requieran ejecución, pagos y cualquier otro
flujo de trabajo impulsado por CLI.
El CLI onchainos incluye claves API de sandbox integradas que funcionan de
inmediato para pruebas locales — no se requiere configuración. Estas claves son
compartidas, con límite de velocidad y solo para evaluación: NO las use en
producción ni con activos reales. Cualquier fallo o pérdida derivada del uso de
las claves integradas es responsabilidad del emisor.
Para producción, usa tus propias credenciales:
- Solicítalas en web3.okx.com → OnchainOS → Dev Portal
- Establece las variables de entorno (o un
.enven la raíz del proyecto — nunca lo subas al repositorio):export OKX_API_KEY=<tu clave> export OKX_SECRET_KEY=<tu secreto> export OKX_PASSPHRASE=<tu frase de contraseña> - Ejecuta cualquier comando CLI de un sub-skill.
Por qué el CLI no puede usar sc-proxy
El binario onchainos usa la pila TLS rustls de Rust con webpki-roots
incluidos — una copia en tiempo de compilación de la lista raíz de CA de
Mozilla. Ignora el almacén de confianza del sistema, ignora
SSL_CERT_FILE y no tiene una variable de entorno documentada para
anularlo. Como resultado, el CA MITM de sc-proxy es rechazado como
UnknownIssuer, y el CLI no puede ser proxy transparente. La Ruta A (HTTP
directo desde scripts del agente) es la única forma de usar las credenciales de
la plataforma con OnchainOS hoy.
La creación de cartera (onchainos wallet login <correo>) te da una cuenta
nueva gestionada por TEE — NO importa tu cartera existente de la aplicación /
extensión de OKX.
Sub-skills por categoría
📊 Descubrimiento y Datos de Mercado (2)
| Sub-skill | Utilízalo para |
|---|---|
okx-dex-market | Datos DEX en cadena de solo lectura: precios en tiempo real / velas / índice / PnL de cartera, seguimiento de actividades de direcciones, señales de smart money / ballena / KOL + rankings de líderes, búsqueda de tokens / metadatos / capitalización de mercado / rankings / liquidez / tokens populares / análisis de holders y clústeres / principales traders / historial de operaciones, noticias cripto / sentimiento / ambiente / ranking de KOL, escaneo de memes / zanjas / reputación de desarrollador / detección de bundles, y transmisión en tiempo real WS/script |
okx-dapp-discovery | Descubrimiento de DApps de terceros y enrutamiento directo de plugins — actualmente compatible con Polymarket, Aave V3, Hyperliquid, PancakeSwap V3 AMM, Morpho V1 Optimizer |
💼 Cartera, Trading y Seguridad (1)
| Sub-skill | Utilízalo para |
|---|---|
okx-agentic-wallet | Ciclo de vida de la cartera (autenticación, saldo, PnL de cartera, envío, historial de transacciones, llamada a contrato), Gas Station, swap DEX, puente entre cadenas, estrategia de órdenes límite, puerta de enlace de transacciones (gas / simular / transmitir / rastrear orden), cartera de direcciones públicas, escaneo de seguridad (riesgo de tokens, phishing de DApps, comprobaciones de transacciones y firmas, aprobaciones), registro de auditoría |
🏦 DeFi (1)
| Sub-skill | Utilízalo para |
|---|---|
okx-defi | DeFi agregado de OKX: descubrimiento de productos, depósito, retiro, reclamación de recompensas en Aave, Lido, PancakeSwap, Kamino, NAVI y más, además de resumen de posiciones y tenencias en protocolos y cadenas |
💸 Pagos (1)
| Sub-skill | Utilízalo para |
|---|---|
okx-agent-payments-protocol | Despachador de pagos unificado a través de x402 (esquemas exact / aggr_deferred — clave TEE o local), MPP (intenciones charge / session — abrir / voucher / recargar / cerrar, modo transacción o hash), y a2a-pay (crear / pagar / estado basado en paymentId). Enruta a referencias por esquema/intención. |
🤖 Agente e IA (2)
| Sub-skill | Utilízalo para |
|---|---|
okx-ai | Identidad de agente en cadena ERC-8004 (registrar / actualizar / buscar / calificar / listar servicios) + marketplace de tareas de agente (publicar / aceptar / entregar / disputar) + monitor en vivo de progreso de tareas |
okx-guide | Centro de incorporación y guía: incorporación a Onchain OS + banner de bienvenida, introducción a OKX.AI y enrutamiento de registro de roles, orientación de atención al cliente / Centro de ayuda |
🛠️ Operaciones (1)
| Sub-skill | Utilízalo para |
|---|---|
okx-growth-competition | Concursos de trading exclusivos para Agentic Wallet: listar, unirse, ver tabla de clasificación, reclamar recompensas |
Mapa rápido de tarea → sub-skill
| Quiero… | Sub-skill | Ruta sugerida |
|---|---|---|
| Consultar el precio o gráfico de un token | okx-dex-market | A (sin clave) |
| Buscar / analizar los holders de un token | okx-dex-market | A (sin clave) |
| Seguir compras de smart money | okx-dex-market | A (sin clave) |
| Escanear nuevos lanzamientos de memes | okx-dex-market | A (sin clave) |
| Ver cualquier cartera pública | okx-agentic-wallet (cartera de direcciones públicas) | A (sin clave) |
| Escanear un token / dApp por riesgos | okx-agentic-wallet (escaneo de seguridad) | A (sin clave) |
| Estimar gas / simular una tx | okx-agentic-wallet (puerta de enlace) | A o B |
| Gestionar / enviar desde mi propia cartera | okx-agentic-wallet | B (requiere inicio de sesión) |
| Intercambiar tokens | okx-agentic-wallet (swap DEX) REST + firmar con el skill wallet (Agent Wallet) | |
| Encontrar el mejor rendimiento DeFi (cualquier protocolo) | okx-defi | B (firma) |
| Ver mis posiciones DeFi | okx-defi | A (sin clave) |
| Usar un DApp específico (Aave, Polymarket, …) | okx-dapp-discovery | B (flujo completo de DApp) |
| Pagar un recurso con puerta x402 / MPP / a2a-pay | okx-agent-payments-protocol | B (firma) |
| Registrar / evaluar un agente en cadena, marketplace de tareas de agente | okx-ai | B (firma) |
| Incorporación, introducción a OKX.AI, soporte al cliente | okx-guide | A (sin clave) |
| Unirse a un concurso de trading | okx-growth-competition | B (requiere cartera) |
| Depurar un fallo del CLI | okx-agentic-wallet (registro de auditoría) | B (registros locales del CLI) |
Flujos de trabajo — orquestaciones multi-skill preconstruidas
Además de los sub-skills individuales, el repositorio incluye orquestaciones de
flujo de trabajo en workflows/ que componen varias habilidades en una sola
operación completa. El agente lee workflows/INDEX.md para enrutar una
solicitud, luego sigue las instrucciones paso a paso en el archivo de flujo de
trabajo coincidente.
| Flujo de trabajo | Qué hace | Comando CLI |
|---|---|---|
| Token Research | Precio, seguridad, holders, clúster, señales de smart money, inmersión opcional en plataforma de lanzamiento | onchainos workflow token-research --address <addr> |
| Daily Brief | Pulso del mercado + smart money + actividad de nuevos tokens + alertas de cartera | — |
| Smart Money Signals | Lista de señales SM agregadas por token + diligencia debida por token | onchainos workflow smart-money |
| New Token Screening | Escaneo de plataforma de lanzamiento MIGRATED + enriquecimiento de seguridad y desarrollador para los 10 principales | onchainos workflow new-tokens |
| Wallet Analysis | PnL a 7d/30d, comportamiento de trading, actividad reciente en cadena | onchainos workflow wallet-analysis --address <addr> |
| Portfolio Check | Saldos, valor total, resumen de PnL a 30d | onchainos workflow portfolio --address <addr> |
| Wallet Monitor | Sondeo en sesión — alertar sobre nuevas operaciones de carteras vigiladas | — |
| Wallet Monitor (WS) | Sesión WebSocket en segundo plano para monitoreo de cartera fuera de línea | — |
Comandos CLI compuestos
Comandos individuales que reemplazan múltiples llamadas a herramientas:
# Informe de token: información + precio + información avanzada + escaneo de seguridad (paralelo)
onchainos token report --address <addr> --chain solana
# Comandos de flujo de trabajo completos
onchainos workflow token-research --address <addr> [--chain solana]
onchainos workflow smart-money [--chain solana]
onchainos workflow new-tokens [--chain solana] [--stage MIGRATED]
onchainos workflow wallet-analysis --address <addr> [--chain ethereum]
onchainos workflow portfolio --address <addr> [--chains ethereum,solana]
Flujos de skill típicos
- Buscar y comprar:
okx-dex-market(encontrar token) →okx-agentic-wallet(verificar fondos + ejecutar operación) - Resumen de cartera:
okx-agentic-wallet(tenencias) →okx-dex-market(enriquecer con análisis + gráficos de precios) - Investigación de mercado:
okx-dex-market(tendencias/clasificaciones + velas/historial) →okx-agentic-wallet(operación) - Swap y transmisión:
okx-agentic-wallet(obtener cotización → swap → transmitir → rastrear orden) - Flujo de trading completo:
okx-dex-market(buscar + precio/gráfico) →okx-agentic-wallet(verificar saldo → swap → simular + transmitir + rastrear) - Clasificación → investigación → operación:
okx-dex-market(principales traders por PnL/ratio de aciertos + análisis de token) →okx-agentic-wallet(ejecutar operación) - Seguir smart money:
okx-dex-market(compras de KOL/smart money + detalles de token + clúster de holders + gráfico de precios) →okx-agentic-wallet(operación)
Servidor MCP
El CLI onchainos funciona también como un servidor MCP nativo, exponiendo sus
herramientas a cualquier cliente compatible con MCP. Inícialo con:
onchainos mcp
Notas importantes
- Identificadores de cadena: se aceptan tanto nombres humanos (
ethereum,solana,xlayer) como IDs numéricos. Ejecutaonchainos swap chainsoonchainos gateway chainspara la lista completa. - Operaciones de solo lectura (datos de mercado, señales, escaneo de seguridad, carteras de direcciones públicas) funcionan a través de la Ruta A sin necesidad de ninguna clave API proporcionada por el usuario.
- Trading y envío usan por defecto la Agent Wallet del usuario a través del
skill
wallet. Solo utilizaonchainos wallet logincomo respaldo cuando el usuario lo solicite. - Puerta de seguridad: cuando el escaneo de seguridad de
okx-agentic-walletinforma de un fallo, el agente que realiza la llamada DEBE bloquear la operación relacionada en lugar de continuar.
Recursos
- Repositorio upstream: okx/onchainos-skills
- Documentación de OnchainOS: OKX Web3 Build — OnchainOS
- Registro de skills: skills.sh/okx/onchainos-skills
- Portal de desarrollador (clave API): web3.okx.com/onchain-os/dev-portal