Quickstart

Este quickstart te lleva de cero a un agente OpenClaw respondiendo en Telegram con una herramienta real (consulta de pedidos a tu API). Si ya tienes credenciales de Anthropic u OpenAI, son 20 minutos de tu tiempo.

1. Instala el SDK

npm install @openclaw/sdk
# o con pnpm
pnpm add @openclaw/sdk

Disponible también como paquete Python (pip install openclaw) con la misma superficie de API.

2. Configura el cliente

import { OpenClaw } from '@openclaw/sdk';

const claw = new OpenClaw({
  // Routing declarativo
  models: {
    default: 'claude-haiku-4-5',         // rápido y barato
    reasoning: 'claude-opus-4-7',         // para tareas complejas
    fallback: 'gpt-5',                    // si el primario falla
  },
  // Anthropic/OpenAI/Google keys vienen del env
  telemetry: { tracing: true, costTracking: true },
});

3. Registra una herramienta

import { z } from 'zod';

claw.tool({
  name: 'get_order_status',
  description: 'Consulta el estado de un pedido por ID',
  input: z.object({
    order_id: z.string().min(1),
  }),
  handler: async ({ order_id }) => {
    const res = await fetch(`${process.env.API_URL}/orders/${order_id}`);
    return res.json();
  },
});

El esquema Zod se convierte automáticamente a JSON Schema para el LLM. Si el modelo llama con argumentos inválidos, la validación falla antes de tocar tu API.

4. Define el agente

const supportAgent = claw.agent({
  name: 'support',
  systemPrompt: `Eres asistente de atención al cliente de Tienda X.
Resuelves consultas sobre pedidos y horarios.
Si no puedes ayudar, escala a humano.`,
  tools: ['get_order_status'],
  memory: { kind: 'vector', store: 'pgvector' },
});

5. Conecta Telegram

import { TelegramChannel } from '@openclaw/sdk/channels';

const telegram = new TelegramChannel({
  botToken: process.env.TELEGRAM_BOT_TOKEN!,
  agent: supportAgent,
});

await telegram.start();

Ya está. Tu bot responde en Telegram. Cada mensaje queda trazado en el dashboard con modelo usado, tokens y coste. Para añadir WhatsApp, Slack o web es el mismo patrón — ver Canales.