Runtimes externos,
cidadãos de primeira classe.
Alguns sistemas são mais que um endpoint de modelo: têm agentes, sessões, saúde e autenticação próprios. O framework de connectors dá a eles um contrato tipado — em vez de gambiarras de provedor customizado.
A capability está implementada e validada no runtime — esta página a acompanha enquanto a abertura é concluída. Durante a transição, o acesso é guardado pela flag MVCODE_ENABLE_RUNTIME_CONNECTORS (desligada por padrão).
01O modelo de capacidades
Cada connector declara explicitamente o subconjunto que implementa. UI, runtime e políticas raciocinam sobre essa declaração — nunca sobre casos especiais:
| Capacidade | O que habilita |
|---|---|
| models | Modelos do runtime aparecem no /models. |
| agents | Agentes remotos descobertos e selecionáveis. |
| sessions | Estado de sessão remota consultável. |
| tools | Ferramentas remotas expostas ao agente. |
| workspaceTarget | Apontar o trabalho para um workspace remoto. |
| auth | Fluxo de credencial próprio do runtime. |
| health | Saúde e latência no popover de status. |
02Connectors embarcados
| Connector | Endpoint padrão | Env |
|---|---|---|
| OpenClaw | http://localhost:18789 | OPENCLAW_BASE_URL · OPENCLAW_GATEWAY_TOKEN |
| Paperclip | http://localhost:3100 | PAPERCLIP_API_URL · PAPERCLIP_API_KEY |
| Hermes | — | HERMES_BASE_URL · HERMES_API_KEY |
Os três falam API OpenAI-compatible e expõem descoberta de modelos e agentes; OpenClaw e Paperclip reportam saúde. Endpoints nunca são fixos no código — cada máquina configura o seu.
03Configurando
Connectors são config-driven, com env como fallback. Credencial vai para o auth store sob o namespace connector: — nunca para o arquivo:
{
"connectors": {
"openclaw": {
"enabled": true,
"baseURL": "http://100.72.64.117:18789",
"headers": { "X-Env": "studio" }
}
}
}No app, o diálogo de runtimes tem o formulário de conexão — baseURL vai para a config, a chave para o auth store — além do toggle de habilitar e o estado de saúde. Configurações são resolvidas a cada request: mudou a config, valeu na hora.
Para alcançar um runtime numa VPS sem expor porta pública, uma VPN mesh (Tailscale) é o caminho recomendado — o baseURL passa a ser o IP da tailnet.
04"Adicionar como provedor"
Um connector com workspaceTarget pode materializar um provedor OpenAI-compatible a partir da própria descoberta: o MVCode resolve endpoint, credencial e headers, e os modelos do runtime passam a fluir pela rota de modelo já testada do produto. Uma sessão vincula um runtime — a troca é explícita, nunca silenciosa.
05Provedor, plugin ou connector?
| Use… | Quando |
|---|---|
| Provedor | A integração só fornece inferência de modelo pelo contrato existente. |
| Plugin | É uma extensão opcional vivendo de hooks — não uma superfície crítica. |
| Connector | Precisa de auth própria, saúde, descoberta de capacidades, sessões/ferramentas remotas ou workspace targeting. |