Referência

Configuração

Nada é obrigatório. O assistente da primeira execução escreve o que precisa; todo o resto tem um padrão sensato.

Onde§

• ~/lampson/.lampson/config.json — provedor, modelo, chaves (seladas), preferências. Escrito por /setup, pelo ⚙ da web e pela pílula do provedor. Compartilhado pelo terminal e pela interface web.
• ~/lampson/.env — sobrescritas opcionais das mesmas configurações, mais os ajustes abaixo. O .env prevalece sobre o config.json.
• LAMPSON_HOME — mover ~/lampson para outro lugar.

Provedor§

LAMPSON_PROVIDER=deepseek        # openai | deepseek | kimi | groq | grok | openrouter | ollama | anthropic | minimax | glm | glm-coding
LAMPSON_API_KEY=sk-...           # ou LAMPSON_API_KEY_DEEPSEEK=… uma por provedor
LAMPSON_MODEL=deepseek-chat
LAMPSON_BASE_URL=…               # qualquer endpoint compatível (sem barra no final)
LAMPSON_WIRE=openai              # openai | anthropic, quando o preset não consegue adivinhar

Comportamento§

LAMPSON_PERMISSION=ask           # ask | yolo | strict (o modo padrão)
LAMPSON_MAX_STEPS=40             # passos de ferramenta por turno
LAMPSON_BUDGET_TOKENS=400000     # orçamento de custo por turno (tokens em cache contam 10%)
LAMPSON_COMPACT_AT=80000         # compactar o contexto acima desta estimativa
LAMPSON_MAX_TOKENS=8192          # limite de saída por resposta (dobra sozinho em resposta vazia)
LAMPSON_TIMEOUT=180              # segundos por chamada ao modelo
LAMPSON_EXPLORE_CAP=12           # chamadas de só leitura seguidas antes de um empurrão para agir

Shell (Windows)§

Os comandos rodam pelo bash do Git por padrão. Para usar outra coisa:

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

Execuções sem ninguém por perto e aprovações§

LAMPSON_TZ=-03:00                # para "daily 09:00" (padrão: o do sistema)
LAMPSON_PUBLIC_URL=https://…     # como este Lampson é alcançado de fora
LAMPSON_WEBHOOK_URL=https://…    # POST para cada aprovação pendente
LAMPSON_WEBHOOK_SECRET=…         # assinatura HMAC-SHA256 do corpo
LAMPSON_WEB_TOKEN=…              # permitir que um script não local chame a API web (Bearer)

Veja Tarefas agendadas.

Lampson como motor§

LAMPSON_AGENT=build                         # o agente padrão (terminal, run, API sem "to")
LAMPSON_CHANNEL_TELEGRAM_AGENT=tienda       # qual agente responde em cada canal: LAMPSON_CHANNEL_<CANAL>_AGENT
LAMPSON_TELEGRAM_TOKEN=…                    # canal Telegram: token do @BotFather
LAMPSON_TELEGRAM_WEBHOOK_SECRET=…           # o segredo que o Telegram envia em cada webhook
LAMPSON_CHATWOOT_URL=… · LAMPSON_CHATWOOT_TOKEN=… · LAMPSON_CHATWOOT_WEBHOOK_SECRET=…
LAMPSON_WEBHOOK_SECRET=…                    # assina os callbacks da API (além das aprovações)

Os plugins recebem os próprios ajustes com "config" (LAMPSON_X → PLUGIN_X). Os agentes ficam em .lampson/agents/ (projeto) e ~/lampson/agents/ (globais). → Agentes · API HTTP · Canais

Computer use e juiz de decisão§

LAMPSON_COMPUTER_USE=1                # ligar o computer use (desligado por padrão)
LAMPSON_COMPUTER_GRANT_PROFILE=1      # trabalhar no seu navegador aberto, com sua sessão
LAMPSON_COMPUTER_MAX_TABS=5           # abas por turno
LAMPSON_COMPUTER_DRIVER=…             # caminho do cua-driver se ele não for achado sozinho
LAMPSON_JUDGE=jev                     # jev | laya | off
TYPESAFE_API_KEY=…                    # a key do Jev
LAMPSON_JUDGE_MODEL=…                 # com laya: a pasta do checkpoint

Veja Computer use e Juiz de decisão.

Por projeto§

Coisas que você pode querer versionar, para que sua equipe também as tenha: .lampson/agents/ (agentes), .lampson/plugins/ (plugins), .lampson/mcp.json, .lampson/lsp.json, skills/, AGENTS.md. O Lampson não escreve mais nada no seu projeto.