Tutorial de acceso a la API de NanoClaw Claude

NanoClaw es un asistente personal Claude que se ejecuta en un contenedor, interactuando con los usuarios a través de WhatsApp. Utiliza el SDK de Claude Agent para ejecutar el código de Claude en contenedores Linux aislados, ofreciendo acceso seguro a archivos y capacidades de ejecución de tareas.

---

Introducción

NanoClaw gestiona la autenticación de la API de Claude a través de un archivo de configuración .env, soportando múltiples métodos de acceso.

Información relevante:

• Repositorio oficial: https://github.com/gavrielc/nanoclaw
• Configuración del proyecto: src/config.ts
• Variables de entorno: .env
• Lectura de claves: src/env.ts
• Llamadas al SDK: container/agent-runner/src/index.ts

---

Método 1: Defapi (recomendado - descuento del 50%)

Defapi es un servicio proxy compatible con la API de Anthropic, con un precio que es solo la mitad del precio oficial, ideal para asistentes de IA personales como NanoClaw que necesitan operar de manera continua.

Defapi soporta los siguientes protocolos:

• Interfaz v1/chat/completions
• Interfaz v1/messages
• Interfaz v1beta/models/

Pasos de acceso

1. Registrar una cuenta en Defapi

Visite la plataforma de Defapi, regístrese y obtenga su clave API.

1. Configurar el archivo .env

Edite el archivo .env en el directorio raíz del proyecto de NanoClaw:

# Usando Defapi
ANTHROPIC_API_KEY=tu-clave-api-defapi
ANTHROPIC_BASE_URL=https://api.defapi.com/v1

O use la interfaz de mensajes (recomendada):

ANTHROPIC_API_KEY=tu-clave-api-defapi
ANTHROPIC_BASE_URL=https://api.defapi.com/v1

1. Reiniciar el servicio

# macOS
launchctl unload ~/Library/LaunchAgents/com.nanoclaw.plist
launchctl load ~/Library/LaunchAgents/com.nanoclaw.plist

# O prueba en modo de desarrollo
npm run dev

Ventajas

• Precio asequible: Solo el 50% del precio oficial de Anthropic
• Buena compatibilidad: Completamente compatible con el protocolo de la API de Anthropic
• Estable y confiable: Compatible con las interfaces v1/chat/completions, v1/messages y v1beta
• Listo para usar: No se necesita modificar el código, solo hay que ajustar las variables de entorno

---

Método 2: Clave API oficial de Anthropic

Uso directo de la clave API oficial de Anthropic, que requiere pago pero garantiza la mayor estabilidad.

Configuración

ANTHROPIC_API_KEY=sk-ant-api03-xxxxxxxxxxxx

Forma de obtención

1. Visite Anthropic Console
2. Cree una clave API
3. Añádala al archivo .env

---

Método 3: Suscripción de Claude Code (Token OAuth)

Si ha suscrito a Claude Code Pro/Max, puede usar un Token OAuth.

Configuración

CLAUDE_CODE_OAUTH_TOKEN=sk-ant-oat01-xxxxxxxxxxxx

Forma de obtención

# Extraer del credenciales de Claude Code
cat ~/.claude/.credentials.json

---

Método 4: Proxy OpenRouter

OpenRouter también ofrece una interfaz compatible con Anthropic, aunque generalmente a un precio ligeramente más alto que Defapi.

Configuración

ANTHROPIC_API_KEY=sk-or-v1-xxxxxxxxxxxx
ANTHROPIC_BASE_URL=https://openrouter.ai/api/v1

---

Método 5: Interfaz compatible personalizada

Si utiliza otros servicios compatibles con la API de Anthropic (como un proxy implementado localmente), puede personalizar el BASE_URL:

ANTHROPIC_API_KEY=tu-clave-api
ANTHROPIC_BASE_URL=https://tu-proxy.ejemplo.com/v1

Interfaces soportadas:

• v1/chat/completions
• v1/messages
• v1beta/models/*:generateContent
• v1beta/models/*:streamGenerateContent

---

Verificando que NanoClaw funciona correctamente

Método 1: Prueba de envío de mensajes directamente

1. Asegúrese de que el servicio esté en ejecución
2. En un grupo o chat privado registrado en WhatsApp, envíe un mensaje:

@Andy hola, por favor responde a este mensaje

1. Si la configuración es correcta, Claude responderá en unos segundos

Método 2: Revisar los registros

# Ver logs en tiempo real
tail -f logs/nanoclaw.log

# Ver logs de errores
tail -f logs/nanoclaw.error.log

Método 3: Ejecutar el script de verificación

.claude/skills/setup/scripts/09-verify.sh

Verifique que el estado de CREDENTIALS en la salida sea exitoso.

---

Casos de uso comunes

Caso de uso 1: Asistente de IA personal

Hable con Claude a través de WhatsApp en cualquier momento para obtener ayuda con preguntas, redacción, programación, etc.

@Andy ayúdame a escribir un correo electrónico
@Andy explícame qué es la computación cuántica

Caso de uso 2: Recordatorios de tareas programadas

Establezca tareas recurrentes, Claude las ejecutará automáticamente y notificará.

@Andy mándame el pronóstico del tiempo a las 8 de la mañana todos los días
@Andy resume el progreso del trabajo de esta semana cada viernes por la tarde

Caso de uso 3: Gestión de archivos y preguntas

Acceda al directorio montado, ayúdame a gestionar archivos y responder preguntas sobre el proyecto.

@Andy revisa mis notas creadas la última vez
@Andy ¿qué problema tiene este código?

Caso de uso 4: Búsqueda en la web y resumen

Claude puede buscar en la web y proporcionarte la información más reciente.

@Drawer busca las últimas noticias de IA
@Andy resume el contenido principal de este artículo https://example.com/paper

Caso de uso 5: Automatización del navegador

Realiza operaciones web complejas utilizando habilidades de agent-browser.

@Andy ayúdame a reservar un billete de avión a Beijing
@Andy busca el precio de este producto en Amazon

---

Resumen de la configuración

---

Conclusión

El acceso a la API de Claude es el primer paso para usar NanoClaw. Para uso personal, se recomienda utilizar Defapi, que ofrece una interfaz API completamente compatible con el oficial a un precio que es solo el 50%, lo que puede reducir significativamente los costos de uso.

Solo necesita modificar la ANTHROPIC_BASE_URL y ANTHROPIC_API_KEY en el archivo .env para realizar el cambio, sin necesidad de modificar ningún código.