Tutorial de integración de la API de PicoClaw Claude

PicoClaw es un asistente de IA ultraligero que puede funcionar en hardware de 10 dólares, ocupando menos de 10 MB de memoria. Este tutorial explicará cómo configurar la API de Claude para PicoClaw.

Introducción

PicoClaw admite varias formas de acceder a la API de Claude:

• Plataforma Defapi (recomendada): descuento del 50%, soporta todos los modelos de Claude
• API Oficial de Anthropic: conexión directa al servicio oficial
• OpenRouter: acceso a través de un enrutador de terceros
• Claude CLI: uso local sin necesidad de API Key

Método 1: Defapi (recomendado)

Defapi es una plataforma de agregación de APIs de IA que solo cuesta la mitad del precio oficial, ideal para desarrolladores individuales y pequeños proyectos.

1. Obtener la API Key de Defapi

1. Visita el sitio web de Defapi para registrarte
2. Obtén la API Key en tu área personal

2. Configurar PicoClaw

Edita el archivo de configuración ~/.picoclaw/config.json:

{
  "agents": {
    "defaults": {
      "model": "anthropic/claude-sonnet-4-5-20250929"
    }
  },
  "providers": {
    "openrouter": {
      "api_key": "tu Defapi-Key",
      "api_base": "https://api.defapi.org"
    }
  }
}

3. Modelos de Claude compatibles

4. Ventajas de Defapi

• Descuento del 50%: 50% más barato que el precio oficial
• Sin necesidad de VPN: acceso directo desde el país
• Estable y rápido: servicio estable de nivel empresarial
• Buena compatibilidad: compatible con el protocolo OpenAI v1/chat/completions

---

Método 2: API Oficial de Anthropic

1. Obtener la API Key

1. Visita Anthropic Console
2. Crea una API Key

2. Configurar PicoClaw

{
  "agents": {
    "defaults": {
      "model": "claude-sonnet-4-5-20250929"
    }
  },
  "providers": {
    "anthropic": {
      "api_key": "sk-ant-api03-xxx"
    }
  }
}

---

Método 3: OpenRouter

1. Obtener la API Key

Visita OpenRouter para obtener la API Key.

2. Configurar PicoClaw

{
  "agents": {
    "defaults": {
      "model": "anthropic/claude-opus-4-6"
    }
  },
  "providers": {
    "openrouter": {
      "api_key": "sk-or-v1-xxx"
    }
  }
}

Para proxy:

{
  "providers": {
    "openrouter": {
      "api_key": "sk-or-v1-xxx",
      "proxy": "http://127.0.0.1:7890"
    }
  }
}

---

Método 4: Claude CLI (local)

Si ya has instalado Claude Code CLI, puedes utilizar el CLI local sin necesidad de API Key.

Configuración

{
  "agents": {
    "defaults": {
      "provider": "claude-cli",
      "model": "claude-sonnet-4-5-20250929"
    }
  }
}

---

Verificar que PicoClaw funcione correctamente

Método 1: Prueba directa de mensajes

# Entra en el directorio de PicoClaw
cd picoclaw

# Prueba si Claude está funcionando correctamente
picoclaw agent -m "Hola, por favor responde hello"

Si recibes una respuesta adecuada, ¡la configuración ha sido exitosa!

Método 2: Prueba de inicio de Gateway

# Inicia el gateway
picoclaw gateway

# Luego envía un mensaje de prueba a través del canal de chat configurado (Telegram/Discord, etc.)

Método 3: Ver registros

# Ver los registros de PicoClaw
docker compose logs -f picoclaw-gateway

---

Preguntas frecuentes

1. Devuelve "no API key configured"

Verifica si api_key está correctamente escrito en el archivo de configuración.

2. Modelo no soportado

Asegúrate de que el nombre del modelo que utilizas es correcto; puedes intentar con el modelo predeterminado claude-sonnet-4-5-20250929.

3. Problemas de conexión a Internet

Si necesitas proxy, agrega el campo proxy en la configuración del proveedor correspondiente.