1. Atención al Cliente
  2. Configuración
  3. Configuración

Cómo conectar OpenClaw a Easyship

Este artículo explica cómo instalar la Skill Oficial de Easyship en OpenClaw para que puedas gestionar envíos usando lenguaje natural, incluyendo obtener tarifas, crear envíos, comprar etiquetas, programar recogidas y rastrear entregas.

Antes de comenzar

Necesitarás:

  • OpenClaw instalado y funcionando en tu máquina
  • Acceso a tu Panel de Easyship
  • Una cuenta de Easyship (el acceso a la API está disponible en todos los planes sin costo adicional)

Si aún no has instalado OpenClaw, sigue la guía oficial de configuración de OpenClaw antes de continuar.

Paso 1: Obtén tu Token API de Easyship

  1. Ve a tu Panel de Easyship y haz clic en Conectar
  2. Haz clic en Nueva Integración
  3. Desplázate hacia abajo hasta Integración API
  4. En Tipo de Integración, selecciona Estoy desarrollando una integración personalizada
  5. Nombra la clave Easyship MCP para referencia fácil
  6. Mantén la versión predeterminada 2024-09 y haz clic en Conectar
  7. En la página siguiente, haz clic en Token de Acceso y cópialo usando el botón de copiar

Alcances requeridos: Tu token API debe incluir los siguientes alcances. La ausencia de algunos causará que ciertas herramientas fallen mientras otras continúan funcionando.

public.shipment:read              public.shipment:write
public.label:write                public.pickup:read
public.pickup:write               public.address_validation:write
public.address_validation_domestic:write
public.shipment_document:read     public.transaction_record:read
public.analytics:read             public.rate:read
public.track:read

Puedes verificar y actualizar los alcances en cualquier momento en Panel → Conectar → API sin necesidad de crear un nuevo token.

Paso 2: Descarga e instala la Skill de Easyship

  1. Ve a la página oficial de la skill Easyship en ClawHub y descarga la carpeta de la skill
  2. Mueve la carpeta descargada al directorio de skills de OpenClaw:

bash

~/.openclaw/skills/
Tu estructura de carpetas debería verse así:
~/.openclaw/skills/easyship-official/SKILL.md

Nota: OpenClaw requiere un archivo SKILL.md para cargar una skill correctamente. Asegúrate de que este archivo exista dentro de la carpeta antes de continuar.

Paso 3: Descarga e instala la Skill de Easyship

Instala la skill usando la CLI de OpenClaw, que se encarga de colocar los archivos correctamente:

bash

openclaw skills install @paulld/easyship-official

Esto descarga la skill desde la página oficial de Easyship en ClawHub y la instala en:

~/.openclaw/skills/easyship-official/SKILL.md

Nota: OpenClaw requiere un archivo SKILL.md en esa ruta para cargar la skill correctamente. Si estás instalando manualmente en lugar de usar la CLI, descarga la carpeta de la skill desde la página de ClawHub y colócala en la misma ruta.

Paso 4: Conecta tu cuenta de Easyship

Configura tu token API de Easyship como una variable de entorno. Para que persista entre sesiones y reinicios, agrégala a tu perfil de shell:

bash

# Para bash
echo 'export EASYSHIP_API_ACCESS_TOKEN="YOUR_TOKEN"' >> ~/.bashrc
source ~/.bashrc


# Para zsh (predeterminado en macOS)
echo 'export EASYSHIP_API_ACCESS_TOKEN="YOUR_TOKEN"' >> ~/.zshrc
source ~/.zshrc

Reemplaza YOUR_TOKEN con el token API que copiaste en el Paso 1.

Seguridad: Nunca compartas tu token API en una ventana de chat ni lo subas a control de versiones. Si lo expones accidentalmente, revoca y rota tu clave inmediatamente en el Panel de Easyship bajo Conectar → API.

Paso 5: Conecta el servidor Easyship MCP

Instalar la skill solo enseña a OpenClaw cómo usar las herramientas de Easyship — aún no se conecta a ellas. Registra el servidor MCP por separado para que esas herramientas estén disponibles:

bash

openclaw mcp set easyship '{"url":"https://mcp.easyship.com/mcp","transport":"streamable-http","headers":{"Authorization":"Bearer ${EASYSHIP_API_ACCESS_TOKEN}"}}'

Usar ${EASYSHIP_API_ACCESS_TOKEN} en lugar de pegar tu token directamente evita que quede guardado en tu configuración de OpenClaw.

Paso 6: Reinicia OpenClaw

Aplica tus cambios reiniciando el gateway de OpenClaw:

bash

openclaw gateway restart

Paso 7: Verifica la conexión

Primero, confirma que el servidor se registró correctamente:

bash

openclaw mcp doctor easyship --probe

Luego confirma que todo funciona de extremo a extremo solicitando a OpenClaw:

Obtén mis últimos 5 envíos de Easyship donde la etiqueta aún no está comprada

Deberías ver una tabla con tus 5 envíos más recientes de la lista "Por Enviar". Si aparecen resultados, tu configuración está completa.

Pruébalo

Una vez conectado, OpenClaw detecta automáticamente cuándo usar la skill de Easyship — solo describe tu tarea en lenguaje natural. Prueba un comando como:

Quiero enviar un paquete desde Nueva York, EE. UU. a Toronto, Canadá. Origen: 350 5th Avenue, Nueva York, US 10001. Destino: 220 Yonge Street, Toronto, ON, Canadá M5B 2H1. Paquete: 1.98 lb, 6 × 4 × 2 cm. Artículo: Documentos comerciales, cantidad 1, código HS 4911.99, valor declarado $1.00 USD, categoría documentos, DDU. Muéstrame las opciones de envío más económicas y de mejor valor con tiempos de entrega y nombres de mensajerías.

Para una lista completa de herramientas y flujos disponibles, consulta la Documentación para desarrolladores de Easyship MCP.

Consejos para mejores resultados:

  • Incluye detalles clave en tus comandos (origen, destino, peso, dimensiones)
  • Sé específico sobre lo que deseas (por ejemplo, "opción más barata" o "entrega más rápida")
  • Usa lenguaje natural — no necesitas comandos especiales

Acciones disponibles

Herramienta Acción Descripción
validate_address Validación de dirección Verifica si una dirección es entregable y obtiene correcciones sugeridas
get_rates Comparar tarifas de mensajería Consulta opciones de costo de envío antes de enviar algo
create_shipment Crear envío Inicia un envío como borrador o compra una etiqueta inmediatamente
create_label Comprar etiqueta Compra y genera una etiqueta de envío para un ID de envío existente
get_shipment Detalles del envío Consulta un envío — estado, costos y enlaces a documentos
list_shipments Buscar envíos Navega o filtra tus envíos por país, estado de etiqueta, etc.
update_shipment Actualizar un envío Corrige detalles en un envío existente antes de enviarlo
cancel_shipment Cancelar un envío Cancela un envío que aún no se ha movido
delete_shipment Eliminar un borrador Elimina un envío en borrador no enviado
track_shipment Estado de seguimiento Consulta el estado actual, ETA y eventos recientes de seguimiento
list_pickups Listar recogidas Consulta recogidas programadas por fecha, mensajería o estado
get_pickup Detalle de recogida Detalles completos de una recogida programada
get_pickup_slots Ventanas de recogida disponibles Consulta las ventanas disponibles para recogida por mensajería antes de reservar
create_pickup Programar una recogida Reserva una mensajería para recoger uno o más paquetes
cancel_pickup Cancelar una recogida Cancela una recogida programada
list_transactions Libro de transacciones Revisa cargos y créditos en tu cuenta de Easyship
analytics_shipments Tendencia de volumen de envíos Envíos creados a lo largo del tiempo, con volumen diario
analytics_top_couriers Mezcla de mensajerías por volumen Cuáles transportistas usas más
analytics_top_destinations Destinos principales A dónde envías la mayoría de los paquetes

Solución de problemas

No ocurre nada cuando escribes una solicitud

  • Asegúrate de que OpenClaw esté funcionando
  • Reinicia OpenClaw
  • Prueba un comando más claro (por ejemplo, "Obtener tarifas de envío a Canadá")

Errores de API o autenticación

  • Verifica que EASYSHIP_API_ACCESS_TOKEN esté configurado correctamente en tu shell
  • Asegúrate de que tu cuenta de Easyship esté activa y el token tenga todos los alcances requeridos

Algunas herramientas funcionan pero otras fallan

  • La falta de un alcance causará que la herramienta específica falle. Verifica que tu token tenga todos los alcances listados en el Paso 1.

Skill no detectada

  • Confirma que la ruta de la carpeta es correcta: ~/.openclaw/skills/easyship-official/
  • Asegúrate de que SKILL.md exista dentro de la carpeta
  • Reinicia OpenClaw

El servidor MCP no se conecta

  • Ejecuta openclaw mcp doctor easyship --probe para confirmar que el servidor se registró correctamente
  • Asegúrate de que EASYSHIP_API_ACCESS_TOKEN esté configurado antes de ejecutar el comando openclaw mcp set en el Paso 5
  • Reinicia OpenClaw después de registrar o actualizar el servidor MCP

Preguntas frecuentes

¿Puedo usar un token API existente o necesito uno nuevo? 

Puedes usar un token existente. Solo asegúrate de que tenga todos los alcances requeridos listados en el Paso 1.

¿Por qué no funciona mi token API? 

Verifica los alcances en el Panel de Easyship bajo Conectar → API. Habilita todos los alcances listados en el Paso 1 para acceso completo.

¿Debo pagar por el token API? 

No. Easyship ofrece acceso a la API en todos los planes sin costo adicional. Si excedes los límites incluidos de API para tu plan, pueden aplicarse cargos por excedentes.

¿Fue útil este artículo?
Usuarios a los que les pareció útil: 0 de 0
Temas populares