Tradução de apoio para consulta. Código e identificadores técnicos preservados. Consultar referência original ↗

OpenClaw

#OpenClaw

Plataforma de assistente de IA de código aberto

OpenClaw permite interagir com IA por meio de vários canais de mensagens. Você pode configurá-lo para acessar modelos de IA de QwenCloud. Ele suporta três métodos de acesso: pré-pago, Token Plan (Personal Edition) e Token Plan Team Edition.

Instale o OpenClaw

OpenClaw requer Node.js 22.19.0 ou posterior. Execute o seguinte comando para verificar sua versão do Node.js:

node --version

Se o Node.js não estiver instalado ou sua versão for anterior a 22.19.0, visite o site do Node.js para baixá-lo e instalá-lo.

macOS / Linux

Recomendamos usar o script de instalação oficial:

```bash
curl -fsSL https://openclaw.ai/install.sh | bash
```

Ou instale globalmente via npm:

```bash
npm install -g openclaw@latest
```

Windows

Execute o seguinte no PowerShell:

```powershell
iwr -useb https://openclaw.ai/install.ps1 | iex
```

Ou instale globalmente via npm:

```bash
npm install -g openclaw@latest
```

Após a primeira instalação, o OpenClaw inicia automaticamente o assistente de configuração. Você também pode executar manualmente o openclaw onboard comando para iniciar o assistente.

Configuração	Recomendado
Eu entendo que isso é poderoso e inerentemente arriscado. Continuar?	Selecione Sim
Modo de integração	Selecione Início Rápido
Provedor de modelo/autenticação	Selecione Pular por enquanto (configurar QwenCloud modelos mais tarde)
Filtrar modelos por provedor	Selecione Todos os provedores
Modelo padrão	Selecione Manter atualizado
Selecione o canal (QuickStart)	Selecione Pular por agora (configurar canais mais tarde)
Configurar habilidades agora? (recomendado)	Selecione Não
Ativar ganchos?	Pressione Espaço para selecionar opções e pressione Enter para prosseguir
Como você want chocar seu bot?	Selecione Faça isso mais tarde

Configurar credenciais de acesso

OpenClaw fornece dois métodos de configuração: terminal (recomendado) ou Web UI.

O exemplo desativa a autenticação de gateway (auth.mode: none), adequado apenas para uso local em uma única máquina. Para acesso compartilhado ou remoto, execute openclaw doctor --fix para ativar a autenticação de token.

Method 1: Terminal

Editar `~/.openclaw/openclaw.json` e adicione a configuração do plano escolhido.

Method 2: Web UI

1. Em seu terminal, execute o seguinte comando para iniciar a UI da Web:

```bash
openclaw dashboard
```

O navegador abrirá automaticamente a página do console (geralmente `http://127.0.0.1:18789`).

2. No menu esquerdo, escolha **Configuração** > **Configurações** > **Avançado** e clique em **Abrir** para abrir o editor de configuração.

3. Substitua o `"agents": {...}` seção com a configuração do plano escolhido e substitua `YOUR_API_KEY` com sua chave de API.



  Para manter as configurações existentes, não substitua o arquivo inteiro. Mesclar o `models` e `agents` seções cuidadosamente.

Plano de token (edição pessoal)

Substituir YOUR_API_KEY com o Token Plan (Personal Edition) dedicado chave de API. Para modelos disponíveis, consulte modelos suportados do Token Plan (Personal Edition).

Parâmetro	Valor
Chave de API	Token Plan (Personal Edition) dedicado chave de API
URL base	`https://token-plan.maas.qwencloudapi.com/compatible-mode/v1`
Modelos disponíveis	Todos os modelos incluídos no Token Plan (Personal Edition)

O arquivo de configuração está localizado em ~/.openclaw/openclaw.json. OpenClaw lê automaticamente este arquivo na inicialização.

Para uma nova configuração: Copie o conteúdo a seguir no arquivo de configuração. Substituir YOUR_API_KEY com sua chave API para o Token Plan (Personal Edition).

Para uma configuração existente: para preservar as configurações atuais, não substitua todo o conteúdo do arquivo. Consulte Como modificar com segurança uma configuração existente.

{
  "meta": {
    "lastTouchedVersion": "2026.2.1",
    "lastTouchedAt": "2026-02-03T08:20:00.000Z"
  },
  "models": {
    "mode": "merge",
    "providers": {
      "bailian-token-plan": {
        "baseUrl": "https://token-plan.maas.qwencloudapi.com/compatible-mode/v1",
        "apiKey": "YOUR_API_KEY",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "auto",
            "name": "auto",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 1000000,
            "maxTokens": 393216,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }
          },
          {
            "id": "qwen3.8-max",
            "name": "qwen3.8-max",
            "reasoning": true,
            "input": ["text", "image"],
            "contextWindow": 983616,
            "maxTokens": 131072,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "compat": { "thinkingFormat": "openai" }
          },
          {
            "id": "qwen3.8-flash",
            "name": "qwen3.8-flash",
            "reasoning": true,
            "input": ["text", "image"],
            "contextWindow": 983616,
            "maxTokens": 131072,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "compat": { "thinkingFormat": "openai" }
          },
          {
            "id": "qwen3.7-max",
            "name": "qwen3.7-max",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 1000000,
            "maxTokens": 65536,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "compat": { "thinkingFormat": "openai" }
          },
          {
            "id": "qwen3.7-plus",
            "name": "qwen3.7-plus",
            "reasoning": false,
            "input": ["text", "image"],
            "contextWindow": 1000000,
            "maxTokens": 65536,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "compat": { "thinkingFormat": "openai" }
          },
          {
            "id": "qwen3.6-flash",
            "name": "qwen3.6-flash",
            "reasoning": false,
            "input": ["text", "image"],
            "contextWindow": 1000000,
            "maxTokens": 32768,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "compat": { "thinkingFormat": "openai" }
          },
          {
            "id": "glm-5.3",
            "name": "glm-5.3",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 1000000,
            "maxTokens": 16384,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "compat": { "thinkingFormat": "openai" }
          },
          {
            "id": "glm-5.2",
            "name": "glm-5.2",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 1000000,
            "maxTokens": 16384,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "compat": { "thinkingFormat": "openai" }
          },
          {
            "id": "deepseek-v4-pro",
            "name": "deepseek-v4-pro",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 163840,
            "maxTokens": 32768,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }
          },
          {
            "id": "deepseek-v4-pro-0813",
            "name": "deepseek-v4-pro-0813",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 163840,
            "maxTokens": 32768,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }
          },
          {
            "id": "deepseek-v4.1-flash",
            "name": "deepseek-v4.1-flash",
            "reasoning": false,
            "input": ["text", "image"],
            "contextWindow": 1000000,
            "maxTokens": 393216,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "bailian-token-plan/auto"
      },
      "models": {
        "bailian-token-plan/auto": {},
        "bailian-token-plan/qwen3.8-max": {},
        "bailian-token-plan/qwen3.8-flash": {},
        "bailian-token-plan/qwen3.7-max": {},
        "bailian-token-plan/qwen3.7-plus": {},
        "bailian-token-plan/qwen3.6-flash": {},
        "bailian-token-plan/glm-5.3": {},
        "bailian-token-plan/glm-5.2": {},
        "bailian-token-plan/deepseek-v4-pro": {},
        "bailian-token-plan/deepseek-v4-pro-0813": {},
        "bailian-token-plan/deepseek-v4.1-flash": {}
      }
    }
  },
  "gateway": {
    "mode": "local",
    "auth": { "mode": "none" }
  }
}

**qwen3.8-max modo de pensamento **:

pensando: Suporta habilitado e desabilitado (modo de pensamento híbrido).
temperatura: o padrão é 0,6 no modo de pensamento. Valores abaixo de 0,6 são ajustados automaticamente para 0,6.
reasoning_effort: Controla a profundidade do raciocínio. Opções: xalto, médio, baixo. Padrão: xalto.

Token Plan Team Edition

Substituir YOUR_API_KEY com o Token Plan Team Edition dedicado chave de API. Para modelos disponíveis, consulte Token Plan Team Edition modelos suportados.

Parâmetro	Valor
Chave de API	Token Plan Team Edition dedicado chave API
URL base	`https://token-plan.maas.qwencloudapi.com/apps/anthropic/v1`
Modelos disponíveis	Token Plan Team Edition modelos suportados

"models": {
  "mode": "merge",
  "providers": {
    "bailian-token-plan": {
      "baseUrl": "https://token-plan.maas.qwencloudapi.com/apps/anthropic/v1",
      "apiKey": "YOUR_API_KEY",
      "api": "anthropic-messages",
      "models": [
        {
          "id": "auto",
          "name": "auto",
          "reasoning": false,
          "input": ["text"],
          "contextWindow": 1000000,
          "maxTokens": 393216,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }
        },
        {
          "id": "qwen3.8-max",
          "name": "qwen3.8-max",
          "reasoning": true,
          "input": ["text", "image"],
          "contextWindow": 983616,
          "maxTokens": 131072,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "compat": { "thinkingFormat": "openai" }
        },
        {
          "id": "qwen3.7-max",
          "name": "qwen3.7-max",
          "reasoning": false,
          "input": ["text"],
          "contextWindow": 1000000,
          "maxTokens": 65536,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "compat": { "thinkingFormat": "openai" }
        },
        {
          "id": "qwen3.7-plus",
          "name": "qwen3.7-plus",
          "reasoning": false,
          "input": ["text", "image"],
          "contextWindow": 1000000,
          "maxTokens": 65536,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "compat": { "thinkingFormat": "openai" }
        },
        {
          "id": "qwen3.6-plus",
          "name": "qwen3.6-plus",
          "reasoning": false,
          "input": ["text", "image"],
          "contextWindow": 1000000,
          "maxTokens": 65536,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "compat": { "thinkingFormat": "openai" }
        },
        {
          "id": "qwen3.6-flash",
          "name": "qwen3.6-flash",
          "reasoning": false,
          "input": ["text", "image"],
          "contextWindow": 1000000,
          "maxTokens": 32768,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "compat": { "thinkingFormat": "openai" }
        },
        {
          "id": "deepseek-v4-pro",
          "name": "deepseek-v4-pro",
          "reasoning": false,
          "input": ["text"],
          "contextWindow": 163840,
          "maxTokens": 32768,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }
        },
        {
          "id": "deepseek-v4-pro-0813",
          "name": "deepseek-v4-pro-0813",
          "reasoning": false,
          "input": ["text"],
          "contextWindow": 163840,
          "maxTokens": 32768,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }
        },
        {
          "id": "deepseek-v4-flash-0731",
          "name": "deepseek-v4-flash-0731",
          "reasoning": false,
          "input": ["text"],
          "contextWindow": 1000000,
          "maxTokens": 393216,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }
        },
        {
          "id": "deepseek-v4.1-flash",
          "name": "deepseek-v4.1-flash",
          "reasoning": false,
          "input": ["text", "image"],
          "contextWindow": 1000000,
          "maxTokens": 393216,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }
        },
        {
          "id": "kimi-k2.7-code",
          "name": "kimi-k2.7-code",
          "reasoning": false,
          "input": ["text", "image"],
          "contextWindow": 262144,
          "maxTokens": 32768,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "compat": { "thinkingFormat": "openai" }
        },
        {
          "id": "kimi-k2.6",
          "name": "kimi-k2.6",
          "reasoning": false,
          "input": ["text", "image"],
          "contextWindow": 262144,
          "maxTokens": 16384,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "compat": { "thinkingFormat": "openai" }
        },
        {
          "id": "kimi-k2.5",
          "name": "kimi-k2.5",
          "reasoning": false,
          "input": ["text", "image"],
          "contextWindow": 262144,
          "maxTokens": 16384,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "compat": { "thinkingFormat": "openai" }
        },
        {
          "id": "glm-5.3",
          "name": "glm-5.3",
          "reasoning": false,
          "input": ["text"],
          "contextWindow": 1000000,
          "maxTokens": 16384,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "compat": { "thinkingFormat": "openai" }
        },
        {
          "id": "glm-5.2",
          "name": "glm-5.2",
          "reasoning": false,
          "input": ["text"],
          "contextWindow": 1000000,
          "maxTokens": 16384,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "compat": { "thinkingFormat": "openai" }
        },
        {
          "id": "glm-5.1",
          "name": "glm-5.1",
          "reasoning": false,
          "input": ["text"],
          "contextWindow": 202752,
          "maxTokens": 16384,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "compat": { "thinkingFormat": "openai" }
        },
        {
          "id": "glm-5",
          "name": "glm-5",
          "reasoning": false,
          "input": ["text"],
          "contextWindow": 202752,
          "maxTokens": 16384,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "compat": { "thinkingFormat": "openai" }
        },
        {
          "id": "MiniMax-M2.5",
          "name": "MiniMax-M2.5",
          "reasoning": false,
          "input": ["text"],
          "contextWindow": 204800,
          "maxTokens": 131072,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }
        }
      ]
    }
  }
},
"agents": {
  "defaults": {
    "model": {
      "primary": "bailian-token-plan/auto"
    },
    "models": {
      "bailian-token-plan/auto": {},
      "bailian-token-plan/qwen3.8-max": {},
      "bailian-token-plan/qwen3.8-flash": {},
      "bailian-token-plan/qwen3.7-max": {},
      "bailian-token-plan/qwen3.7-plus": {},
      "bailian-token-plan/qwen3.6-plus": {},
      "bailian-token-plan/qwen3.6-flash": {},
      "bailian-token-plan/deepseek-v4-pro": {},
      "bailian-token-plan/deepseek-v4-pro-0813": {},
      "bailian-token-plan/deepseek-v4-flash-0731": {},
      "bailian-token-plan/deepseek-v4.1-flash": {},
      "bailian-token-plan/kimi-k2.7-code": {},
      "bailian-token-plan/kimi-k2.6": {},
      "bailian-token-plan/kimi-k2.5": {},
      "bailian-token-plan/glm-5.3": {},
      "bailian-token-plan/glm-5.2": {},
      "bailian-token-plan/glm-5.1": {},
      "bailian-token-plan/glm-5": {},
      "bailian-token-plan/MiniMax-M2.5": {}
    }
  }
},

Para adicionar mais modelos, adicione definições de modelo em providers.bailian-token-plan.modelse adicione agents.defaults.models entradas em "bailian-token-plan/model-ID": {}.

**qwen3.8-max modo de pensamento **:

pensando: Suporta habilitado e desabilitado (modo de pensamento híbrido).
temperatura: o padrão é 0,6 no modo de pensamento. Valores abaixo de 0,6 são ajustados automaticamente para 0,6.
reasoning_effort: Controla a profundidade do raciocínio. Opções: xalto, médio, baixo. Padrão: xalto.

Pague conforme o uso

Substituir YOUR_API_KEY com o seu QwenCloud Chave API. Para modelos disponíveis, consulte modelos suportados. Modelos de áudio e vídeo não podem ser chamados através do OpenClaw.

Parâmetro	Valor
Chave de API	Seu QwenCloud Chave API
URL base	`https://maas.qwencloudapi.com/apps/anthropic/v1`
Modelos disponíveis	Modelos suportados, excluindo modelos de áudio e vídeo

"models": {
  "mode": "merge",
  "providers": {
    "qwencloud": {
      "baseUrl": "https://maas.qwencloudapi.com/apps/anthropic/v1",
      "apiKey": "YOUR_API_KEY",
      "api": "anthropic-messages",
      "models": [
        {
          "id": "qwen3.7-plus",
          "name": "qwen3.7-plus",
          "reasoning": false,
          "input": ["text", "image"],
          "contextWindow": 1000000,
          "maxTokens": 65536,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "compat": { "thinkingFormat": "openai" }
        },
        {
          "id": "qwen3.6-plus",
          "name": "qwen3.6-plus",
          "reasoning": false,
          "input": ["text", "image"],
          "contextWindow": 1000000,
          "maxTokens": 65536,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "compat": { "thinkingFormat": "openai" }
        },
        {
          "id": "MiniMax-M2.5",
          "name": "MiniMax-M2.5",
          "reasoning": false,
          "input": ["text"],
          "contextWindow": 204800,
          "maxTokens": 131072,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }
        },
        {
          "id": "glm-5",
          "name": "glm-5",
          "reasoning": false,
          "input": ["text"],
          "contextWindow": 202752,
          "maxTokens": 16384,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "compat": { "thinkingFormat": "openai" }
        },
        {
          "id": "deepseek-v4.1-flash",
          "name": "deepseek-v4.1-flash",
          "reasoning": false,
          "input": ["text"],
          "contextWindow": 163840,
          "maxTokens": 16384,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "compat": { "thinkingFormat": "openai" }
        }
      ]
    }
  }
},
"agents": {
  "defaults": {
    "model": {
      "primary": "qwencloud/qwen3.7-plus"
    },
    "models": {
      "qwencloud/qwen3.7-plus": {},
      "qwencloud/qwen3.6-plus": {},
      "qwencloud/MiniMax-M2.5": {},
      "qwencloud/glm-5": {},
      "qwencloud/deepseek-v4.1-flash": {}
    }
  }
},

Verifique a configuração

Habilite o gateway local

Execute o seguinte comando para ativar o gateway local:

openclaw config set gateway.mode local

Iniciar e testar

openclaw gateway  # Start the gateway
openclaw tui      # Open terminal UI

Digite uma mensagem para confirmar se o modelo responde normalmente. Se isso acontecer, a configuração estará concluída.

Comandos comuns

Comando	Descrição	Exemplo
`/help`	Exibir comandos disponíveis	`/help`
`/status`	Visualize o modelo atual, a sessão e o status do gateway	`/status`
`/model <model_name>`	Mudar o modelo para a sessão atual	`/model qwen3.7-max`
`/new`	Iniciar uma nova sessão	`/new`
`/compact`	Compacte o histórico de conversas para liberar janela de contexto	`/compact`
`/think <level>`	Definir profundidade de pensamento (raciocínio): desligado, baixo, médio, alto	`/think high`
`/skills`	Exibir todas as habilidades disponíveis	`/skills`

Perguntas frequentes

Códigos de erro

Se você encontrar erros durante a configuração, consulte a documentação de perguntas frequentes do plano de cobrança correspondente:

Pagamento conforme o uso: Códigos de erro e solução de problemas
Plano de token (edição pessoal): Perguntas frequentes sobre o plano de token (edição pessoal)
Token Plan Team Edition: Perguntas frequentes sobre o Token Plan Team Edition

Erro "Início do gateway bloqueado"

Corre openclaw config set gateway.mode local para ativar o gateway local ou passar o --allow-unconfigured bandeira: openclaw gateway --allow-unconfigured.

Como visualizar modelos configurados

Corre openclaw tui para abrir a IU do terminal e digite /model para visualizar a lista de modelos. Pressione Enter para selecionar um modelo ou pressione Esc para sair.

Adicionando novos modelos de plano com segurança sem perder as configurações existentes

Não substitua todo ~/.openclaw/openclaw.json arquivo. Em vez disso, faça modificações parciais – edite apenas os campos que precisam ser alterados e mantenha a configuração existente intacta. Após salvar, reinicie o gateway com openclaw gateway restart.

Erro "Identidade do dispositivo necessária"

Mensagem de erro:

code=1008 reason=device identity required

O cliente não forneceu informações de identidade do dispositivo ao conectar-se ao gateway. Isso geralmente acontece na primeira visita ao navegador, depois de limpar o cache do navegador ou quando os arquivos principais no ~/.openclaw/identity/ estão faltando.

Solução: Execute os seguintes comandos para aprovar o dispositivo e gerar novamente o URL de acesso do navegador:

openclaw devices approve --latest
openclaw dashboard --no-open

Se o problema persistir, limpe os registros pendentes do dispositivo e tente novamente:

openclaw devices clear --pending --yes
openclaw dashboard --no-open

O consumo de token ocorre mesmo quando o OpenClaw não está em uso ativo

Causa: O OpenClaw possui um mecanismo de pulsação integrado. Enquanto o gateway está em execução, ele chama automaticamente o modelo configurado em um intervalo fixo (a cada 30 minutos por padrão) para verificar tarefas pendentes. Cada pulsação consome um pequeno número de tokens.

Como verificar: Verifique os arquivos de log da sessão (.jsonl) no ~/.openclaw/agents/main/sessions/ diretório. As chamadas de pulsação são marcadas com [OpenClaw heartbeat poll].

Soluções:

Pare o gateway: Execute openclaw gateway stop quando não estiver em uso. Isso interrompe os batimentos cardíacos imediatamente.
Aumentar o intervalo de batimentos cardíacos: Definir agents.defaults.heartbeat.every em ~/.openclaw/openclaw.json. Por exemplo, "2h" define o intervalo para cada 2 horas.