Atualizado em · SI-API

GUIAS PARA DESENVOLVEDORES

Configuração do OpenClaw

Configure os sete modelos uma vez para a TUI e a interface de controle no navegador, usando a mesma chave.

Uma conexão. Todos os sete modelos.

Configure seu agente uma vez e troque de modelo e esforço de raciocínio na mesma sessão.

Baixar ZIP de configuração com todos os modelos ↗

Prefere pular a configuração manual? Peça à IA para fazer isso por você.

Prompt de configuração com IA

Siga https://siapi.ai/pt-br/docs/openclaw?model=deepseek-flash&surface=cli&platform=macos para conectar meu Agent a todos os modelos SI-API. Preserve as configurações existentes e peça minha chave de API quando necessário.

  • GLM 5.3 Flash
  • DeepSeek V4.1 Flash
  • Kimi K3.1 Pro
  • Kimi K3.1 Pro HighSpeed
  • GLM 5.3
  • MiniMax M3.1 Flash
  • Qwen3.8 Max

Os sete modelos estão neste download. Mantenha a mesma configuração ao trocar de modelo. Obter sua chave de API →

1. Prepare sua ferramenta e sua chave

Instale OpenClaw pela página oficial. Crie ou copie sua chave SI-API em /pt-br/keys.

Guia oficial de instalação ↗

Salve a configuração e a chave na máquina que executa o OpenClaw Gateway, além do navegador que abre a interface de controle.

2. Salve a configuração

Baixe e extraia o ZIP. Substitua YOUR_SIAPI_API_KEY pela sua chave e salve cada arquivo no caminho indicado abaixo. Mescle os campos com o arquivo existente, preservando outros provedores, permissões e preferências. Não substitua toda a configuração existente.

Local da configuração: ~/.openclaw

openclaw.json

Salvar em: ~/.openclaw/openclaw.json

Mescle estes campos no arquivo existente, preservando outros provedores, permissões e preferências. Não substitua a configuração inteira. Preserve as entradas agents.defaults.models com params.thinking: elas definem os esforços iniciais por modelo. thinkingLevelMap e compat.supportedReasoningEfforts do provedor declaram as opções disponíveis.

Ver ou copiar configuração
openclaw.json
Baixar
{
  "models": {
    "mode": "merge",
    "providers": {
      "siapi": {
        "baseUrl": "https://siapi.ai/v1",
        "apiKey": "${SIAPI_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "glm-5.3-flash",
            "name": "GLM 5.3 Flash",
            "input": [
              "text"
            ],
            "reasoning": true,
            "thinkingLevelMap": {
              "off": null,
              "minimal": null,
              "low": "low",
              "medium": null,
              "high": "high",
              "xhigh": null,
              "max": "max"
            },
            "compat": {
              "supportsDeveloperRole": false,
              "supportsReasoningEffort": true,
              "supportedReasoningEfforts": [
                "low",
                "high",
                "max"
              ]
            }
          },
          {
            "id": "deepseek-flash",
            "name": "DeepSeek V4.1 Flash",
            "input": [
              "text"
            ],
            "reasoning": true,
            "thinkingLevelMap": {
              "off": "none",
              "minimal": null,
              "low": "low",
              "medium": null,
              "high": "high",
              "xhigh": null,
              "max": "max"
            },
            "compat": {
              "supportsDeveloperRole": false,
              "supportsReasoningEffort": true,
              "supportedReasoningEfforts": [
                "none",
                "low",
                "high",
                "max"
              ],
              "reasoningEffortMap": {
                "off": "none"
              }
            }
          },
          {
            "id": "kimi-k3.1-pro",
            "name": "Kimi K3.1 Pro",
            "input": [
              "text"
            ],
            "reasoning": true,
            "thinkingLevelMap": {
              "off": null,
              "minimal": null,
              "low": "low",
              "medium": null,
              "high": "high",
              "xhigh": null,
              "max": "max"
            },
            "compat": {
              "supportsDeveloperRole": false,
              "supportsReasoningEffort": true,
              "supportedReasoningEfforts": [
                "low",
                "high",
                "max"
              ]
            }
          },
          {
            "id": "kimi-k3.1-pro-highspeed",
            "name": "Kimi K3.1 Pro HighSpeed",
            "input": [
              "text"
            ],
            "reasoning": true,
            "thinkingLevelMap": {
              "off": null,
              "minimal": null,
              "low": "low",
              "medium": null,
              "high": "high",
              "xhigh": null,
              "max": "max"
            },
            "compat": {
              "supportsDeveloperRole": false,
              "supportsReasoningEffort": true,
              "supportedReasoningEfforts": [
                "low",
                "high",
                "max"
              ]
            }
          },
          {
            "id": "glm-5.3",
            "name": "GLM 5.3",
            "input": [
              "text"
            ],
            "reasoning": true,
            "thinkingLevelMap": {
              "off": null,
              "minimal": null,
              "low": "low",
              "medium": null,
              "high": "high",
              "xhigh": null,
              "max": "max"
            },
            "compat": {
              "supportsDeveloperRole": false,
              "supportsReasoningEffort": true,
              "supportedReasoningEfforts": [
                "low",
                "high",
                "max"
              ]
            }
          },
          {
            "id": "minimax-m3.1",
            "name": "MiniMax M3.1 Flash",
            "input": [
              "text"
            ],
            "reasoning": false,
            "compat": {
              "supportsDeveloperRole": false,
              "supportsReasoningEffort": false
            }
          },
          {
            "id": "qwen3.8-max",
            "name": "Qwen3.8 Max",
            "input": [
              "text"
            ],
            "reasoning": true,
            "thinkingLevelMap": {
              "off": "none",
              "minimal": null,
              "low": "low",
              "medium": "medium",
              "high": null,
              "xhigh": "xhigh",
              "max": null
            },
            "compat": {
              "supportsDeveloperRole": false,
              "supportsReasoningEffort": true,
              "supportedReasoningEfforts": [
                "none",
                "low",
                "medium",
                "xhigh"
              ],
              "reasoningEffortMap": {
                "off": "none"
              }
            }
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "siapi/deepseek-flash"
      },
      "models": {
        "siapi/glm-5.3-flash": {
          "alias": "glm-5.3-flash",
          "params": {
            "thinking": "max"
          }
        },
        "siapi/deepseek-flash": {
          "alias": "deepseek-flash",
          "params": {
            "thinking": "high"
          }
        },
        "siapi/kimi-k3.1-pro": {
          "alias": "kimi-k3.1-pro",
          "params": {
            "thinking": "max"
          }
        },
        "siapi/kimi-k3.1-pro-highspeed": {
          "alias": "kimi-k3.1-pro-highspeed",
          "params": {
            "thinking": "max"
          }
        },
        "siapi/glm-5.3": {
          "alias": "glm-5.3",
          "params": {
            "thinking": "max"
          }
        },
        "siapi/minimax-m3.1": {
          "alias": "minimax-m3.1"
        },
        "siapi/qwen3.8-max": {
          "alias": "qwen3.8-max",
          "params": {
            "thinking": "xhigh"
          }
        }
      }
    }
  }
}

.env.example

Salvar em: ~/.openclaw/.env

Adicione a chave ao .env do Gateway, inclusive quando ele funcionar como serviço em segundo plano.

Ver ou copiar configuração
.env.example
Baixar
SIAPI_API_KEY=YOUR_SIAPI_API_KEY

3. Inicie seu agente

Inicie uma nova sessão e envie uma mensagem. O modelo inicial é deepseek-flash.

Inicie seu agente
openclaw gateway restart
openclaw models set siapi/deepseek-flash
openclaw tui

4. Alterne entre todos os modelos

Após a configuração, escolha qualquer modelo abaixo dentro do agente. A mesma chave e configuração funcionam com os sete modelos; não é necessário baixar ou conectar novamente.

Todos os 7 modelos nesta configuração de agente
Modelo / ID na APIComando / caminho no seletorConfigurações de raciocínio
GLM 5.3 Flash
glm-5.3-flash
/model siapi/glm-5.3-flashLow, High e Max. O raciocínio fica sempre ativado; escolha Low para menos raciocínio. O padrão do modelo é Max.
DeepSeek V4.1 Flash
deepseek-flash
/model siapi/deepseek-flashOff, Low, High e Max. Medium / XHigh correspondem a High; Ultra corresponde a Max.
Kimi K3.1 Pro
kimi-k3.1-pro
/model siapi/kimi-k3.1-proLow, High e Max. O raciocínio fica sempre ativado; escolha Low para menos raciocínio. O padrão do modelo é Max.
Kimi K3.1 Pro HighSpeed
kimi-k3.1-pro-highspeed
/model siapi/kimi-k3.1-pro-highspeedLow, High e Max. O raciocínio fica sempre ativado; escolha Low para menos raciocínio. O padrão do modelo é Max.
GLM 5.3
glm-5.3
/model siapi/glm-5.3Low, High e Max. O raciocínio fica sempre ativado; escolha Low para menos raciocínio. O padrão do modelo é Max.
MiniMax M3.1 Flash
minimax-m3.1
/model siapi/minimax-m3.1Use o padrão do modelo. Esta rota não oferece controles personalizados de raciocínio.
Qwen3.8 Max
qwen3.8-max
/model siapi/qwen3.8-maxOff, Low, Medium e XHigh. High / Max correspondem a XHigh, sem níveis adicionais.

5. Escolha o esforço de raciocínio

Envie cada comando separadamente dentro do agente. Com DeepSeek V4.1 Flash, alterne de Low para High antes da próxima mensagem.

Dentro do agente
/think low
/think high

Os níveis de esforço disponíveis dependem do modelo; consulte a tabela acima. O MiniMax M3.1 Flash usa o padrão do modelo.

Padrões de esforço e configurações salvas

Comece com o DeepSeek V4.1 Flash. Escolha Low, envie uma tarefa curta de leitura de arquivo, depois escolha High e repita. Confira a configuração atual após cada alteração.

Effort é a quantidade de raciocínio solicitada. Kimi K3.1 Pro / HighSpeed, GLM 5.3 e GLM 5.3 Flash oferecem Low / High / Max, com raciocínio sempre ativado. Escolha Low para raciocínio mais curto; não há opção Off. O padrão desses modelos é Max, mas o cliente pode substituí-lo. DeepSeek e Qwen têm os níveis próprios listados abaixo.

O MiniMax M3.1 Flash usa o raciocínio padrão. As configurações do MiniMax M3 se aplicam a outro modelo.

As entradas agents.defaults.models fornecidas definem params.thinking separadamente para cada modelo: High para DeepSeek, Max para Kimi e GLM, XHigh para Qwen. Esses padrões são separados de thinkingLevelMap, onde null desabilita uma opção não aceita.

Envie /think low ou /think high como mensagem isolada para mudar a configuração salva da sessão. /think mostra o nível atual; /status mostra as configurações solicitada e efetiva. Envie /think default para remover a sobrescrita da sessão e herdar o padrão configurado. Isso não pede ao modelo upstream que escolha um padrão. Padrões por agente ainda podem substituir as configurações compartilhadas.

A TUI usa a mesma configuração local do OpenClaw Gateway que a interface de controle no navegador. Confira /think após trocar de modelo ou retomar uma sessão salva.

No agente · envie cada comando separadamente
/think
/think low
/status
/think high
/status
/think low
  • Reinicie o OpenClaw Gateway local após atualizar reasoning, thinkingLevelMap ou compat. Níveis mais altos exigem a declaração supportedReasoningEfforts fornecida. Off deve corresponder a none; omitir effort não garante que o raciocínio esteja desativado. Padrões por agente e sobrescritas de sessão podem substituir configurações compartilhadas.

Resultado esperado: No DeepSeek V4.1 Flash, a configuração muda de Low para High e volta a Low antes da próxima mensagem. Os demais modelos seguem os controles abaixo.

Níveis de raciocínio e endpoints personalizados do OpenClaw ↗

Confira o modelo e execute sua primeira tarefa

Confira o modelo e execute sua primeira tarefa

Abra um projeto com README.md. Permita que a ferramenta leia o arquivo e envie o prompt abaixo. Confirme a leitura e o retorno de um resumo. Para testar outro modelo, troque pela tabela acima e repita a tarefa.

Na sua ferramenta
/model
Envie esta tarefa na sua ferramenta

Use a ferramenta de leitura de arquivos para ler o README.md deste projeto e resumir sua finalidade em uma frase. Não modifique nenhum arquivo.

Observações sobre a ferramenta
  • A lista de modelos permitidos inclui os sete modelos da SI-API. Seleções existentes por agente podem substituir o padrão.
  • Reinicie o Gateway instalado após editar o ambiente. Se ele ainda não estiver instalado, siga primeiro o guia oficial de configuração inicial.

Referência oficial de configuração ↗ · Configuração do modelo

A conexão não funciona? · Uso

Compatibilidade dos Agents — Versões dos clientes, campos de raciocínio testados e limitações conhecidas.

Baixar instruções de configuração