Referencia

Configuración

No se requiere nada. El asistente de la primera ejecución escribe lo que necesita; todo lo demás tiene un valor por defecto razonable.

Dónde§

• ~/lampson/.lampson/config.json — proveedor, modelo, claves (selladas), preferencias. Lo escriben /setup, el ⚙ de la web y el pill del proveedor. Compartido por la terminal y la interfaz web.
• ~/lampson/.env — sobrescrituras opcionales de los mismos ajustes, más los parámetros de abajo. .env gana sobre config.json.
• LAMPSON_HOME — mueve ~/lampson a otro lugar.

Proveedor§

LAMPSON_PROVIDER=deepseek        # openai | deepseek | kimi | groq | grok | openrouter | ollama | anthropic | minimax | glm | glm-coding
LAMPSON_API_KEY=sk-...           # o LAMPSON_API_KEY_DEEPSEEK=… una por proveedor
LAMPSON_MODEL=deepseek-chat
LAMPSON_BASE_URL=…               # cualquier endpoint compatible (sin barra final)
LAMPSON_WIRE=openai              # openai | anthropic, cuando el preset no puede adivinarlo

Comportamiento§

LAMPSON_PERMISSION=ask           # ask | yolo | strict (el modo por defecto)
LAMPSON_MAX_STEPS=40             # pasos de herramienta por turno
LAMPSON_BUDGET_TOKENS=400000     # presupuesto de costo por turno (los tokens en caché cuentan un 10 %)
LAMPSON_COMPACT_AT=80000         # compactar el contexto por encima de esta estimación
LAMPSON_MAX_TOKENS=8192          # tope de salida por respuesta (se duplica solo ante una respuesta vacía)
LAMPSON_TIMEOUT=180              # segundos por llamada al modelo
LAMPSON_EXPLORE_CAP=12           # llamadas de solo lectura seguidas antes de un empujón a actuar

Shell (Windows)§

Los comandos se ejecutan a través del bash de Git por defecto. Para usar otra cosa:

LAMPSON_SHELL=C:\Program Files\Git\bin\bash.exe
LAMPSON_SHELL_FLAG=-c

Ejecuciones sin supervisión y aprobaciones§

LAMPSON_TZ=-03:00                # para "daily 09:00" (por defecto: la del sistema)
LAMPSON_PUBLIC_URL=https://…     # cómo se llega a este Lampson desde fuera
LAMPSON_WEBHOOK_URL=https://…    # POST por cada aprobación pendiente
LAMPSON_WEBHOOK_SECRET=…         # firma HMAC-SHA256 del cuerpo
LAMPSON_WEB_TOKEN=…              # permitir que un script no local llame a la API web (Bearer)

Consulta Tareas programadas.

Lampson como motor§

LAMPSON_AGENT=build                         # el agente por defecto (terminal, run, API sin "to")
LAMPSON_CHANNEL_TELEGRAM_AGENT=tienda       # qué agente contesta cada canal: LAMPSON_CHANNEL_<CANAL>_AGENT
LAMPSON_TELEGRAM_TOKEN=…                    # canal Telegram: token de @BotFather
LAMPSON_TELEGRAM_WEBHOOK_SECRET=…           # el secreto que Telegram manda en cada webhook
LAMPSON_CHATWOOT_URL=… · LAMPSON_CHATWOOT_TOKEN=… · LAMPSON_CHATWOOT_WEBHOOK_SECRET=…
LAMPSON_WEBHOOK_SECRET=…                    # firma los callbacks de la API (además de las aprobaciones)

Los plugins reciben sus propios ajustes con "config" (LAMPSON_X → PLUGIN_X). Los agentes viven en .lampson/agents/ (proyecto) y ~/lampson/agents/ (globales). → Agentes · API HTTP · Canales

Computer use y juez de decisión§

LAMPSON_COMPUTER_USE=1                # encender computer use (apagado por defecto)
LAMPSON_COMPUTER_GRANT_PROFILE=1      # trabajar en tu navegador abierto, con tu sesión
LAMPSON_COMPUTER_MAX_TABS=5           # pestañas por turno
LAMPSON_COMPUTER_DRIVER=…             # ruta del cua-driver si no se encuentra solo
LAMPSON_JUDGE=jev                     # jev | laya | off
TYPESAFE_API_KEY=…                    # la key de Jev
LAMPSON_JUDGE_MODEL=…                 # con laya: la carpeta del checkpoint

Consulta Computer use y Juez de decisión.

Por proyecto§

Cosas que quizá quieras subir a git para que las tenga tu equipo: .lampson/agents/ (agentes), .lampson/plugins/ (plugins), .lampson/mcp.json, .lampson/lsp.json, skills/, AGENTS.md. Lampson no escribe nada más dentro de tu proyecto.