OpenClaw
Fonte: https://docs.qwencloud.com/coding-plan/tools/openclaw - extraído do HTML público arquivado.
Plataforma de assistente de IA de código aberto Openclaw permite interagir com IA através 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: pagamento, Token Plan (Edição Pessoal) e Token Plan Team Edition.
Instale Openclaw
Openclaw requer Node.js 24,16+ ou 26,1+. Para verificar sua versão: Entendido.
node --version
Se Node.js não estiver instalado ou não atender ao requisito, visite o site [Node.js] (https://nodejs.org/) para baixar e instalar.
macOS / Linux
Janelas Recomendamos usar o script oficial de instalação: Entendido.
curl -fsSL https://openclaw.ai/install.sh | bash
Ou instalar globalmente via NPM: Entendido.
npm install -g openclaw@latest
Execute o seguinte em PowerShell: Entendido.
iwr -useb https://openclaw.ai/install.ps1 | iex
Ou instalar globalmente via NPM: Entendido.
npm install -g openclaw@latest
Após a primeira instalação, Openclaw inicia a configuração guiada. Em 2026.7.1 e depois, corra. openclaw onboard Para a configuração guiada ou openclaw onboard --classic para o mágico clássico. Em 2026.6.35 e antes, openclaw onboard abre o mágico clássico.
A seguir, as escolhas chave no assistente de configuração. Os passos variam por versão, siga as instruções na tela. Este documento se conecta através do arquivo de configuração, então selecione Skip por enquanto para o fornecedor do modelo.
- Alerta de segurança: se mostrado, selecione "Sim".
- Modo de inicialização: selecione ** Início rápido** / ** Início rápido**.
- O que criar: selecione Um agente (se mostrado).
- Fornecedor de modelos: selecione Skip por enquanto (este documento usa o arquivo de configuração; não selecione um provedor aqui).
- Modelo padrão: se mostrado, selecione ** Mantenha o atual**.
- Canais, habilidades, ganchos: pule ou configure mais tarde, conforme necessário.
Depois do mago, edite.
~/.openclaw/openclaw.jsonComo descrito em Configurar credenciais de acesso para conectar QwenCloud.
Configure credenciais de acesso.
Openclaw fornece dois métodos de configuração: terminal (recomendado) ou interface Web.
O exemplo desativa a autenticação do gateway (auth.mode: noneÉ adequado apenas para uso local de uma máquina. Para acesso compartilhado ou remoto, corra. openclaw doctor --fix para ativar a autenticação do símbolo.
Método 1: Terminal
Método 2: UI Web
Editar ~/.openclaw/openclaw.json E adicione a configuração para o seu plano escolhido.
- Em seu terminal, execute o seguinte comando para iniciar a interface Web: Entendido.
openclaw dashboard
O navegador abrirá automaticamente a página do console (normalmente http://127.0.0.1:18789).
- No menu esquerdo, escolha Configuração > Configurações > Avançada, e clique em Abrir para abrir o editor de configuração.
- Substitua o
"agents": {...}Seção com a configuração para o seu plano escolhido, e substituaYOUR_API_KEYcom sua chave API. Para manter as configurações existentes, não sobrescreva o arquivo inteiro. Mesclar omodelseagentsSeções com cuidado.
Token Plan (Edição Pessoal)
Substituir YOUR_API_KEY com o Token Plan (Edição Pessoal) dedicado [Chave API] (https://home.qwencloud.com/api-keys). Para modelos disponíveis, veja [Token Plan apoiado (Edição Pessoal) modelos] (https://www.qwencloud.com/token-plan/personal/token-plan-personal-overview#supported-models).
| Parâmetro | Valor |
|---|---|
| Chave da API | Token Plan (Edição Pessoal) Chave de API dedicadahttps://home.qwencloud.com/api-keys |
| URL base | https://token-plan.maas.qwencloudapi.com/compatible-mode/v1 |
| Modelos disponíveis | Todos os modelos incluídos no plano Token (Edição Pessoal)https://www.qwencloud.com/token-plan/personal/token-plan-personal-overview#supported-models |
O arquivo de configuração está localizado em ~/.openclaw/openclaw.json. Openclaw lê automaticamente este arquivo na inicialização.
O exemplo desativa a autenticação do gateway (auth.mode: noneÉ adequado apenas para uso local de uma máquina. Para acesso compartilhado ou remoto, corra. openclaw doctor --fix para ativar a autenticação do símbolo.
** Para uma nova configuração**: Copie o seguinte conteúdo no arquivo de configuração. Substituir YOUR_API_KEY Para uma configuração existente**: Para preservar suas configurações atuais, não substitua todo o conteúdo do arquivo. Veja como modificar uma configuração existente.
Entendido.
{
"models": {
"mode": "merge",
"providers": {
"qwencloud-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 }
},
{
"id": "deepseek-v4.1-flash-1017",
"name": "deepseek-v4.1-flash-1017",
"reasoning": false,
"input": ["text", "image"],
"contextWindow": 1000000,
"maxTokens": 393216,
"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "qwencloud-token-plan/auto"
},
"models": {
"qwencloud-token-plan/auto": {},
"qwencloud-token-plan/qwen3.8-max": {},
"qwencloud-token-plan/qwen3.8-flash": {},
"qwencloud-token-plan/qwen3.7-max": {},
"qwencloud-token-plan/qwen3.7-plus": {},
"qwencloud-token-plan/qwen3.6-flash": {},
"qwencloud-token-plan/glm-5.3": {},
"qwencloud-token-plan/glm-5.2": {},
"qwencloud-token-plan/deepseek-v4-pro": {},
"qwencloud-token-plan/deepseek-v4-pro-0813": {},
"qwencloud-token-plan/deepseek-v4.1-flash": {},
"qwencloud-token-plan/deepseek-v4.1-flash-1017": {}
}
}
},
"gateway": {
"mode": "local",
"auth": { "mode": "none" }
}
}
qwen3.8-max Modo de pensamento:
- Suporta tanto habilitado quanto desativado (modo de pensamento híbrido).
- Temperatura: por padrão de 0,6 no modo de pensar. Valores abaixo de 0,6 são ajustados automaticamente para 0,6.
- Controla a profundidade do raciocínio. Opções: Xhigh, médio, baixo. Padrão: Xhigh.
Edição da Equipe do Token Plan
Substituir YOUR_API_KEY com a edição da equipe do plano Token dedicada [Chave API] (https://home.qwencloud.com/api-keys). Para os modelos disponíveis, veja Token Plan Team Edition (modelos apoiados) (https://www.qwencloud.com/token-plan/team/token-plan-team-overview#supported-models).
| Parâmetro | Valor |
|---|---|
| Chave da API | Equipe de Token Edição dedicada à API Keyhttps://home.qwencloud.com/api-keys |
| URL base | https://token-plan.maas.qwencloudapi.com/apps/anthropic/v1 |
| Modelos disponíveis | Equipe de Token Plan Edição suporta modeloshttps://www.qwencloud.com/token-plan/team/token-plan-team-overview#supported-models |
Entendido.
"models": {
"mode": "merge",
"providers": {
"qwencloud-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": "deepseek-v4.1-flash-1017",
"name": "deepseek-v4.1-flash-1017",
"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": "qwencloud-token-plan/auto"
},
"models": {
"qwencloud-token-plan/auto": {},
"qwencloud-token-plan/qwen3.8-max": {},
"qwencloud-token-plan/qwen3.8-flash": {},
"qwencloud-token-plan/qwen3.7-max": {},
"qwencloud-token-plan/qwen3.7-plus": {},
"qwencloud-token-plan/qwen3.6-plus": {},
"qwencloud-token-plan/qwen3.6-flash": {},
"qwencloud-token-plan/deepseek-v4-pro": {},
"qwencloud-token-plan/deepseek-v4-pro-0813": {},
"qwencloud-token-plan/deepseek-v4-flash-0731": {},
"qwencloud-token-plan/deepseek-v4.1-flash": {},
"qwencloud-token-plan/deepseek-v4.1-flash-1017": {},
"qwencloud-token-plan/kimi-k2.7-code": {},
"qwencloud-token-plan/kimi-k2.6": {},
"qwencloud-token-plan/kimi-k2.5": {},
"qwencloud-token-plan/glm-5.3": {},
"qwencloud-token-plan/glm-5.2": {},
"qwencloud-token-plan/glm-5.1": {},
"qwencloud-token-plan/glm-5": {},
"qwencloud-token-plan/MiniMax-M2.5": {}
}
}
},
Para adicionar mais modelos, adicione definições de modelos em providers.qwencloud-token-plan.models, e adicionar agents.defaults.models entradas em "qwencloud-token-plan/model-ID": {}.
qwen3.8-max Modo de pensamento:
- Suporta tanto habilitado quanto desativado (modo de pensamento híbrido).
- Temperatura: por padrão de 0,6 no modo de pensar. Valores abaixo de 0,6 são ajustados automaticamente para 0,6.
- Controla a profundidade do raciocínio. Opções: Xhigh, médio, baixo. Padrão: Xhigh.
Pagar como você vai
Substituir YOUR_API_KEY com o seu [QwenCloud API Key] (https://home.qwencloud.com/api-keys). Para os modelos disponíveis, veja [modelos suportados] (https://www.qwencloud.com/developer-guides/getting-started/text-generation-models). Modelos de áudio e vídeo não podem ser chamados através do OpenClaw.
| Parâmetro | Valor |
|---|---|
| Chave da API | Seu. QwenCloud Chave da APIhttps://home.qwencloud.com/api-keys |
| URL base | https://maas.qwencloudapi.com/apps/anthropic/v1 |
| Modelos disponíveis | Modelos apoiados.https://www.qwencloud.com/developer-guides/getting-started/text-generation-models, excluindo modelos de áudio e vídeo |
Entendido.
"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" }
},
{
"id": "deepseek-v4.1-flash-1017",
"name": "deepseek-v4.1-flash-1017",
"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": {},
"qwencloud/deepseek-v4.1-flash-1017": {}
}
}
},
Conecte-se aos canais de mensagens.
Passo 1: Instale o plugin WhatsApp
O canal WhatsApp está conectado através de um plugin. Execute o seguinte comando para instalá-lo: Entendido.
openclaw plugins install @openclaw/whatsapp
Passo 2: Configure o canal WhatsApp
Digite o seguinte aviso em seu chat OpenClaw. Openclaw vai pedir seu número de telefone no formato E.164 (a + sinal seguido pelo código e número do país, então automaticamente adicione o número à configuração e complete a configuração.
Entendido.
Please help me configure the WhatsApp channel. First, ask for my phone number, and then automatically fill it into the allowFrom and groupAllowFrom fields in the following configuration to complete the setup.
{
"channels": {
"whatsapp": {
"dmPolicy": "pairing",
"allowFrom": ["<phone_number>"],
"groupPolicy": "allowlist",
"groupAllowFrom": ["<phone_number>"]
}
}
}
Recomendamos usar um número de telefone separado para o canal WhatsApp para evitar que o robô responda às suas conversas diárias. Se usar seu número de telefone pessoal, pode digitar um comando no chat OpenClaw para habilitar selfChatMode. O robô responderá apenas na sua conversa de "Mensagem de si mesmo", deixando outras conversas sem afeto.
Passo 3: Link com WhatsApp
- Comece o processo de ligação WhatsApp. O terminal exibe um código QR. Entendido.
openclaw channels login --channel whatsapp
- Abra o WhatsApp no seu telefone e escaneie o código QR no terminal para ligar sua conta.
- Reinicie o portal. Entendido.
openclaw gateway restart
Passo 4: Teste
- Verifique o status do canal WhatsApp: Entendido.
openclaw status
Na seção de canais, WhatsApp deveria ser ON com um status de OK2. No WhatsApp, envie uma mensagem para você mesmo para verificar se o robô responde corretamente.
Telegrama
- Crie um robô usando um BotPatherhttps://t.me/BotFather- Envie o
/newbotcomando, siga as instruções para inserir um nome de bot e nome de usuário (o nome de usuário deve terminar combotE copie e salve o token de bots devolvido (formato:123456789:ABCdefGHIjklMNOpqrsTUVwxyz). - No seu chat Openclaw, digite o seguinte prompt e substitua
xxxxcom seu símbolo de robô. Openclaw irá aplicar automaticamente a configuração. Entendido.
Please help me configure Telegram with the following settings. My bot token is xxxx.
{
"channels": {
"telegram": {
"enabled": true,
"botToken": "xxxx",
"dmPolicy": "pairing"
}
}
}
- Depois que a configuração estiver completa, reinicie o portal. Entendido.
openclaw gateway restart
- No Telegram, envie uma mensagem para o seu robô. Quando enviar sua primeira mensagem, receberá um código de emparelhamento.
- Em seu terminal, execute o seguinte comando, substituindo
xxxcom o código de emparelhamento: Entendido.
openclaw pairing approve telegram xxx
Discórdia
Passo 1: Crie uma aplicação de discórdia e bot
- Criar uma aplicação Discord Ir para o [Portal Desenvolvedor Discord]https://discord.com/developers/applications), clique em New Application, insira um nome de aplicativo, e depois clique em Criar.
- Crie um robô e permita permissões
- No painel de navegação esquerdo, clique em Bot e defina um nome de usuário para o bot.
- Na página Bot, role até a Privilegiada Intenção de Portão e permita as seguintes intenções: - Intenção de conteúdo da mensagem - Intenção de membros do servidor - Intenção de Presença Quando terminar, clique em Salvar mudanças.
- ** Obter o token bot** No topo da página Bot, clique em Reiniciar Token para gerar um token. Este símbolo é exibido apenas uma vez, então copie-o e guarde-o em um local seguro imediatamente.
- ** Adicione o bot a um servidor**
- No painel de navegação esquerdo, clique em OAuth2 e desça até o gerador de URL OAuth2.
- Sob o escopo, selecione o
boteapplications.commandsCaixas de seleção. - Na seção de Permissões Bot que aparece, selecione as seguintes permissões: - Ver Canais - Envie mensagens - Leia o Histórico de Mensagens - Incorpore Links - Anexar arquivos
- Copie a URL gerada na parte inferior da página, abra-a no seu navegador, selecione o servidor de destino e clique em Continuar para adicionar o bot.
Passo 2: Configure Discórdia em OpenClaw
- Na máquina onde Openclaw está funcionando, defina o token de bot como uma variável de ambiente. Entendido.
export DISCORD_BOT_TOKEN="YOUR_BOT_TOKEN"
- Complete a configuração da Discórdia: Entendido.
openclaw config set channels.discord.token --ref-provider default --ref-source env --ref-id DISCORD_BOT_TOKEN
openclaw config set channels.discord.enabled true --strict-json
- Reinicie o portal para aplicar a configuração. Entendido.
openclaw gateway restart
Passo 3: Emparelhe e teste
- Em Discórdia, envie uma mensagem direta para o robô. Quando enviar sua primeira mensagem, receberá um código de emparelhamento.
- Em seu terminal, execute o seguinte comando para completar o emparelhamento, substituindo
xxxcom o código de emparelhamento: Entendido.
openclaw pairing approve discord xxx
O código de emparelhamento é válido por uma hora. Se expirar, você deve enviar outra mensagem para conseguir uma nova.
- Verifique o status do canal Discord: Entendido.
openclaw status
Na seção de canais, Discórdia deve ser ON com um status de OK. 4. Envie uma mensagem em Discórdia para testar a conexão.
Comandos comuns.
| Comando | Descrição | Exemplo |
|---|---|---|
/help |
Mostrar comandos disponíveis | /help |
/status |
Veja o status atual do modelo, sessão e gateway | /status |
/model <model_name> |
Mude o modelo para a sessão atual | /model qwen3.7-max |
/new |
Comece uma nova sessão. | /new |
/compact |
Comprima o histórico de conversas para liberar a janela de contexto. | /compact |
/think <level> |
Profundidade de pensamento: baixo, médio, alto | /think high |
/skills |
Mostre todas as habilidades disponíveis. | /skills |
Use casos.
Use o caso 1: Automatize X (Twitter)
Você pode usar Openclaw para automatizar sua conta X (Twitter), incluindo postagem, resposta, pesquisa e navegação na sua linha do tempo. Passos de configuração
- Instale o twitter-cli: Entendido.
uv tool install twitter-cli
- Digite o seguinte comando em uma janela OpenClaw para instalar automaticamente a Habilidade. Entendido.
Install this skill: https://github.com/public-clis/twitter-cli
- Reinicie o portal para ativar a habilidade. Entendido.
openclaw gateway restart
- Verifique a instalação: Entendido.
openclaw skills list
- twitter-cli usa cookies do navegador para autenticação. Certifique-se de que você está logado em [x.com] (https://x.com/) em um navegador suportado, como Chrome, Edge, Firefox, Arc, ou Brave. twitter-cli recupera automaticamente os cookies. Alternativamente, você pode definir manualmente as informações de autenticação usando variáveis de ambiente: Entendido.
export TWITTER_AUTH_TOKEN="your_auth_token"
export TWITTER_CT0="your_ct0_token"
Para obter os cookies, abra x.com em seu navegador, abra ferramentas de desenvolvimento, mude para o painel de aplicativos, e na seção de cookies, encontre os valores para auth_token e ct0.
Exemplo 1: Publicar automaticamente um post
Entre Check Sam Altman's recent tweets, summarize the key points, and then help me post a tweet with my thoughts em um diálogo Openclaw. Openclaw automaticamente pega o feed, analisa o conteúdo e publica o post.
Exemplo 2: Procure por tópicos de tendências
Entre Search for tweets about harness engineering from yesterday. Openclaw procura tweets relevantes e resume seus pontos-chave.
Use o caso 2: Analise e baixe vídeos do YouTube.
Você pode usar Openclaw para procurar vídeos no YouTube, extrair informações de vídeo e baixar vídeos. Ele suporta a busca por palavras-chave, ordenação por data, e metadados de vídeo em massa. Passos de configuração
- Instale yt-dlp: Entendido.
pip install yt-dlp
- Verifique a instalação: Entendido.
yt-dlp --version
- Configure a autenticação de cookies. Isso é necessário para acessar vídeos restritos, só para membros ou privados. Certifique-se de que você está conectado ao [youtube.com] (https://youtube.com/) em seu navegador, e depois digite o seguinte em um diálogo OpenClaw: Entendido.
I need to configure YouTube cookie authentication. Please use yt-dlp to extract YouTube cookies from my browser.
Depois da instalação, você pode usar esse recurso diretamente em um diálogo Openclaw. Openclaw automaticamente roda o yt-dlp Comando para executar operações relacionadas com vídeo.
Exemplo 1: Resumir conteúdo de vídeo
Entre Summarize the main points of this video: https://www.youtube.com/watch?v=XRgGFQ0EgM0 em um diálogo Openclaw. Openclaw recupera a informação do vídeo e gera um resumo.
Exemplo 2: Baixe um vídeo
Entre Download this video: https://www.youtube.com/watch?v=XRgGFQ0EgM0 em um diálogo Openclaw. Openclaw faz o download do vídeo para sua máquina local.
Use o caso 3: Agendar diariamente a entrega de notícias da IA
Você pode usar o recurso de cron OpenClaw para automaticamente pegar as últimas notícias da IA e pressioná-lo para WhatsApp diariamente. Passos de configuração
- Em seu terminal: Entendido.
openclaw cron add \
--name "ai-daily-news" \
--cron "0 9 * * *" \
--tz "UTC" \
--message "Please visit https://techcrunch.com/category/artificial-intelligence/ to get today's AI news. Summarize the top 10 most important AI stories in a concise list format, each with a title and a one-sentence summary in English." \
--channel whatsapp \
--to "<your_phone_number>" \
--announce
Parâmetros:
| Parâmetro | Descrição |
|---|---|
--name |
O nome da tarefa. |
--cron |
A expressão de Cron."0 9 * * *" Significa que a tarefa é às 9h00 todos os dias. |
--tz |
O fuso horário. - Pronto para..."UTC"para o Tempo Universal Coordenado. Você pode substituir isso por seu fuso horário local, como"America/New_York"or"Europe/London". |
--message |
O alerta enviado ao agente, que especifica o conteúdo para buscar e como resumir. |
--channel |
O canal de empurrão. - Pronto para...whatsapp. |
--announce |
Empurra a saída da tarefa para o destinatário especificado. |
--to |
O número de telefone WhatsApp do destinatário no formato E.164, que inclui um sinal de adição, código de país e número de telefone. |
No sucesso, o comando devolve um objeto JSON contendo a tarefa ID e o próximo tempo de execução programado. 2. Depois de criar a tarefa, você pode acionar manualmente uma vez para verificar se ela funciona.
- Listar todas as tarefas para obter a identificação da tarefa: Entendido.
openclaw cron list
- Acionar manualmente a tarefa: Entendido.
openclaw cron run <task_I D> --timeout 120000
- Verifique o resultado da execução: Entendido.
openclaw cron runs --id <task_I D>
Se a saída aparecer "status": "ok" e "delivered": true, as notícias foram entregues com sucesso para WhatsApp.
Caso de uso 4: Análise do mercado de ações
Você pode usar Openclaw para analisar tendências de ações e receber análises técnicas e sugestões de investimento. O conteúdo gerado pela IA é apenas para referência e não constitui um conselho de investimento real ou uma base para a tomada de decisão. Passos de configuração
- Instale a habilidade. Digite as instruções seguintes em um diálogo Openclaw. Openclaw irá completar automaticamente a instalação. Entendido.
Install the manus-stock-analysis skill
- Reinicie o portal para ativar a habilidade. Entendido.
openclaw gateway restart
Verifique a instalação: Entendido.
openclaw skills list
- Em um diálogo Openclaw, faça perguntas relacionadas com ações, como
Analyze NVDA stock.
Saiba mais.
Habilidade
Habilidades são módulos extensíveis que fornecem novas capacidades. O agente automaticamente combina e carrega a habilidade apropriada com base no pedido do usuário. Openclaw permite que você visualize e habilite habilidades integradas, instale habilidades comunitárias de [ClawHub] (https://clawhub.com/), ou criar habilidades personalizadas.
Vendo habilidades existentes
- Veja suas habilidades instaladas e seu status: Entendido.
# List installed Skills
openclaw skills list
# Check Skill status (enabled, disabled, missing dependencies, etc.)
openclaw skills check
# View detailed information for a specific Skill
openclaw skills info <skill-nam e>
- Habilidades incorporadas estão desabilitadas por padrão. Para habilitá-los, você deve adicioná-los ao
skills.allowBundled- A lista de espera está pronta.~/.openclaw/openclaw.json. Openclaw carrega apenas as habilidades incorporadas listadas nesta matriz. Entendido.
{
"skills": {
"allowBundled": [
"github",
"weather",
"summarize",
"coding-agent",
"clawhub",
"nano-pdf",
"google-web-search",
"image-lab"
]
}
}
Algumas habilidades integradas requerem uma chave de API de terceiros para funcionar. Configure estas chaves no skills.entries Campo de ~/.openclaw/openclaw.json. Para detalhes, consulte a documentação de configuração de habilidades (https://docs.openclaw.ai/zh-CN/tools/skills-config).
Encontrar mais habilidades
Você pode encontrar e instalar mais habilidades usando um dos seguintes métodos.
- Pesquise e instale a partir de ClawHub [ClawHub] (https://clawhub.com/) oferece mais de 3.000 habilidades comunitárias. Você pode procurar no site ou procurar por eles na linha de comando. Entendido.
# Search by keyword
npx clawhub search [keyword]
# Browse recently updated Skills
npx clawhub explore
Depois de encontrar uma habilidade adequada, execute o seguinte comando para instalá-la. Então, reinicie o portal para aplicar a habilidade. Entendido.
npx clawhub install <skill-nam e>
- Pergunte ao Openclaw diretamente Descreva suas necessidades diretamente no chat, por exemplo,
Help me find a Skill that can check the weather. Openclaw automaticamente procurará e instalará uma habilidade correspondente.
Criando uma habilidade personalizada
- Crie um diretório para sua habilidade. Entendido.
mkdir -p ~/.openclaw/workspace/skills/my-custom-skill
- Neste diretório, crie o
SKILL.mdArquivo. O arquivo é composto por duas partes: IMAML matéria dianteira e instruções de marcação. OnameedescriptionOs campos são necessários. O agente usa odescriptionpara determinar se carregará a habilidade. Certifique-se de que a descrição seja exata. Entendido.
---
name: my-custom-skill
description: Short description
---
# My Custom Skill
When a user requests XXX, do the following:
1. Use the bash tool to run the xxx command
2. Parse the output
3. Return the result to the user as a table
- Reinicie o portal para aplicar a habilidade. Entendido.
# Restart the gateway
openclaw gateway restart
# Check if the Skill is active
openclaw skills list
Para mais informações sobre a configuração de Habilidade, veja a [Documentação Oficial OpenClaw] (https://docs.openclaw.ai/tools/creating-skills).
FAQ
Como posso ver meus modelos configurados?
Para iniciar a linha de comando de terminal Openclaw, digite openclaw tui em seu terminal. Então, entre. /model para ver a lista de modelos. Pressione Enter para selecionar um modelo e Esc para sair da lista.
Por que eu recebo o erro HTTP 401: chave incorreta API fornecida., Nenhuma chave API encontrada para provedor xxx, ou HTTP 401: inválido_iam_token?
Causas possíveis incluem:
- A chave API pode ser inválida, expirada, vazia, incorretamente formatada, ou para o ponto final errado. Certifique-se de que a chave API corresponde ao seu método de pagamento, é copiado completamente sem espaços extras, e que sua assinatura de conta está ativa.
- Openclaw pode estar usando uma configuração incorreta e sem graça do cache de configuração. Para resolver isso, delete o
providersitem de configuração do~/.openclaw/agents/main/agent/models.jsonArquivar e reiniciar Openclaw. invalid_iam_tokenindica que a chave API falhou na autenticação do IAM. Cenários comuns incluem: a chave da API foi revogada ou desativada; a chave da API não corresponde à URL da base; ou uma credencial temporária expirou. Verifique se a chave da API e o URL base combinam, e que o status da chave da API está ativo. Já configurei outros canais de mensagens, como WhatsApp. Como posso adicionar modelos para um novo plano sem perder minha configuração?
- ** Não use uma função "Substituir Todos"**, pois isso irá substituir sua configuração personalizada. Em vez disso, modifique apenas as seções relevantes.
- Use um dos seguintes métodos para completar a configuração:
- Se Openclaw está respondendo normalmente: Digite os comandos diretamente em um chat Openclaw para mesclar a configuração.
- Se Openclaw não tem modelos configurados ou não está respondendo:
~/.openclaw/openclaw.jsonArquivo. Modifique apenas os campos relevantes e deixe sua configuração existente inalterada. Após reiniciar o portal, as sessões existentes podem não funcionar corretamente. Comece uma nova sessão. O que devo fazer se eu tiver um erro de identidade do dispositivo? Mensagem de erro: Entendido.
http://127.0.0.1:18791/15:05:56 [ws] closed before connect conn=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx remote=127.0.0.1 fwd=n/a origin=n/a host=127.0.0.1:18789 ua=n/a code=1008 reason=device identity required
**Causa:**Este erro ocorre quando um cliente se conecta ao portal sem fornecer uma identidade de dispositivo. Causas comuns incluem:
- Você está acessando a URL em um navegador pela primeira vez, e o emparelhamento de dispositivos ainda não está completo.
- O cache do navegador foi limpo, fazendo a chave do dispositivo ser perdida.
- Depois de reinstalar ou atualizar Openclaw, o arquivo chave no
~/.openclaw/identity/O diretório está faltando. **Solution:**Execute os seguintes comandos no terminal para aprovar a conexão do dispositivo e gerar uma nova URL de acesso do navegador: Entendido.
openclaw devices approve --latest
openclaw dashboard --no-open
Se o problema persistir, limpe os registros do dispositivo e tente novamente: Entendido.
openclaw devices clear --pending --yes
openclaw dashboard --no-open
Corra. openclaw devices list para confirmar que o dispositivo aparece na lista de pares.
O consumo de token ocorre mesmo quando Openclaw não está ativamente em uso.
Openclaw tem um mecanismo de batimento cardíaco integrado. Enquanto o gateway está rodando, ele automaticamente chama o modelo configurado em um intervalo fixo (a cada 30 minutos por padrão) para verificar as tarefas pendentes. Cada batimento cardíaco consome um pequeno número de fichas. ~/.openclaw/agents/main/sessions/ Diretório. As chamadas do coração estão marcadas com [OpenClaw heartbeat poll].Soluções:
- ** Pare o portão**: Corra
openclaw gateway stopquando não está em uso. Isso para o batimento cardíaco imediatamente. - Aumente o intervalo de batimentos cardíacos
agents.defaults.heartbeat.everyEm~/.openclaw/openclaw.json. Por exemplo,"2h"define o intervalo para cada 2 horas. [Anterior] (https://www.qwencloud.com/developer-guides/administration/dynamic-rate-limits[Agente Hermes Terminal Al assistente de codificação de Nous Research Next] (https://www.qwencloud.com/developer-guides/clients-and-developer-tools/hermes-agent)