Guía de configuración de frameworks de agentes

¿Qué endpoint usar?

Dos endpoints — elige el correcto

Tokonomix expone dos endpoints de gateway. La elección depende de si tu agente usa llamadas a herramientas.

Cuándo usar qué endpoint

OpenClaw

OpenClaw se conecta a Tokonomix mediante la URL base de Anthropic. Las llamadas a herramientas y el streaming funcionan de inmediato.

# OpenClaw config (config.toml or .openclaw)
[api]
base_url = "https://tokonomix.ai/api/anthropic"
api_key  = "tok-your-key"

# For consensus (single-model passthrough via OpenAI endpoint):
# base_url = "https://tokonomix.ai/api/v1"
# model    = "tokonomix-consensus"

# Tool-calling agents: use the Anthropic base URL (Mode B).
# Consensus sessions: switch to the OpenAI-compat base URL above.

LangChain

Usa la clase ChatOpenAI con una URL base personalizada. Para agentes con herramientas, cambia al endpoint Anthropic Messages.

# Python — plain chat or consensus
from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    model="tokonomix-consensus",          # or any model slug
    base_url="https://tokonomix.ai/api/v1",
    api_key="tok-your-key",
)

# Tool-calling agents: switch to the Anthropic endpoint
from langchain_anthropic import ChatAnthropic

tool_llm = ChatAnthropic(
    model="claude-sonnet-4-6",
    base_url="https://tokonomix.ai/api/anthropic",
    api_key="tok-your-key",
)
# Bind tools as usual:
# agent_llm = tool_llm.bind_tools([my_tool])

AutoGen

El OpenAIChatCompletionClient de AutoGen acepta una URL base personalizada. Configúrala con el endpoint compatible con OpenAI de Tokonomix para chat y consenso.

# Python — AutoGen 0.4+ (autogen-agentchat)
from autogen_ext.models.openai import OpenAIChatCompletionClient

# Plain chat or consensus
client = OpenAIChatCompletionClient(
    model="tokonomix-consensus",          # or any model slug
    base_url="https://tokonomix.ai/api/v1",
    api_key="tok-your-key",
)

# Tool-calling agents: use OpenAI client pointed at the OpenAI-compat endpoint.
# Consensus: pass model="tokonomix-consensus"; remove any tools= argument.
# Note: do NOT pass tools= when using tokonomix-consensus — that model does not
# accept tool definitions and will return a 400 error.

Claude Code MCP

Claude Code obtiene Tokonomix a través del servidor MCP. Una vez configurado, Claude Code puede llamar directamente a tokonomix_consensus_ask y tokonomix_single_ask.

// ~/.claude/settings.json  (or project .claude/settings.json)
{
  "mcpServers": {
    "tokonomix": {
      "command": "npx",
      "args": ["-y", "tokonomix-mcp"],
      "env": {
        "TOKONOMIX_API_KEY": "tok-your-key"
      }
    }
  }
}

// Available MCP tools after setup:
//   tokonomix_consensus_ask   — ask a question across multiple models at once
//   tokonomix_single_ask      — single-model call with full token accounting
//   tokonomix_get_balance     — check remaining token balance
//   tokonomix_list_models     — enumerate available models and capabilities
//
// Example usage in Claude Code:
//   tokonomix_consensus_ask({ prompt: "Review this function for edge cases", ... })
//
// Note: the MCP tools use the gateway internally — no separate endpoint config needed.

Errores comunes y soluciones