O OpenClaw é uma plataforma de assistente pessoal de IA open source que permite interagir com inteligência artificial por meio de diversos canais de mensagens. Você pode configurá-lo para acessar modelos de IA do Alibaba Cloud Model Studio. A plataforma oferece quatro modalidades de acesso: pagamento conforme o uso, Coding Plan, Token Plan Personal Edition e Token Plan Team Edition.
Instalar o OpenClaw
O OpenClaw exige o Node.js 22.19.0 ou superior. Para verificar sua versão:
- macOS / Linux
- Windows
openclaw onboard para realizar a configuração manualmente.
Parâmetro | Recomendação |
I understand this is powerful and inherently risky. Continue? | Selecione Yes |
Onboarding mode | Selecione QuickStart |
Model/auth provider | Selecione Skip for now (é possível configurar um modelo do Model Studio posteriormente) |
Filter models by provider | Selecione All providers |
Default model | Selecione Keep current |
Select channel (QuickStart) | Selecione Skip for now (é possível configurar um canal posteriormente) |
Configure skills now? (recommended) | Selecione No |
Enable hooks? | Pressione a barra de espaço para marcar uma opção e, em seguida, pressione Enter. |
How do you want to hatch your bot? | Selecione Do this later |
Configurar credenciais de acesso
Token Plan Personal Edition
Item | Descrição |
|---|---|
API Key | API Key dedicada ao Token Plan Personal Edition |
Base URL |
|
Modelos disponíveis | Todos os modelos incluídos no Token Plan Personal Edition |
~/.openclaw/openclaw.json. O OpenClaw lê esse arquivo automaticamente durante a inicialização.
auth.mode: none), sendo adequado apenas para uso local em uma única máquina. Para acesso compartilhado ou remoto, execute openclaw doctor --fix para ativar a autenticação por token.YOUR_API_KEY pela sua API Key do Token Plan Personal Edition.
Para uma configuração existente: Para preservar suas configurações atuais, não substitua todo o conteúdo do arquivo. Consulte Como modificar com segurança uma configuração existente.
Token Plan Team Edition
Item | Descrição |
|---|---|
API Key | API Key dedicada para o Token Plan Team Edition |
Base URL |
|
Modelos disponíveis | Todos os modelos incluídos no Token Plan Team Edition |
~/.openclaw/openclaw.json. O OpenClaw lê esse arquivo automaticamente durante a inicialização.
auth.mode: none), o que é adequado apenas para uso local em uma única máquina. Para acesso compartilhado ou remoto, execute openclaw doctor --fix para ativar a autenticação por token.- Método 1: Terminal
- Método 2: Web UI
- Abra o arquivo de configuração
-
Adicione a configuração
Para uma nova configuração: Copie o conteúdo abaixo para o arquivo de configuração. Substitua
YOUR_API_KEYpela sua API Key do Token Plan Team Edition. Para uma configuração existente: Para preservar suas configurações atuais, não substitua todo o conteúdo do arquivo. Consulte Como modificar com segurança uma configuração existente.
-
Salve e saia
Pressione
Ctrl+X, pressioneYpara confirmar o salvamento e, em seguida, pressioneEnterpara confirmar o nome do arquivo. - Aplique a configuração Para aplicar as alterações, reinicie o gateway com o seguinte comando:
Plano de Codificação
Item | Descrição |
|---|---|
API Key | API Key dedicada ao Plano de Codificação, no formato |
Base URL | |
Modelos disponíveis | Todos os modelos incluídos no Plano de Codificação |
~/.openclaw/openclaw.json. O OpenClaw lê esse arquivo automaticamente durante a inicialização.
auth.mode: none), o que é adequado apenas para uso local em uma única máquina. Para acesso compartilhado ou remoto, execute openclaw doctor --fix para ativar a autenticação por token.- Método 1: Terminal
- Método 2: Web UI
- Abra o arquivo de configuração
-
Adicione a configuração
Para uma nova configuração: Copie o conteúdo abaixo para o arquivo de configuração. Substitua
YOUR_API_KEYpela sua API Key do Plano de Codificação. Para uma configuração existente: Para preservar suas configurações atuais, não substitua todo o conteúdo do arquivo. Consulte Como modificar com segurança uma configuração existente.
-
Salve e saia
Pressione
Ctrl+X, pressioneYpara confirmar o salvamento e, em seguida, pressioneEnterpara confirmar o nome do arquivo. - Aplique a configuração Para aplicar as alterações, reinicie o gateway com o seguinte comando:
Pagamento conforme o uso
Item | Descrição |
|---|---|
API Key | API Key do Model Studio, no formato |
Base URL | Certifique-se de que sua Base URL, API Key e modelo correspondam todos à mesma região:
|
Modelos disponíveis | Todos os modelos disponíveis no Model Market |
~/.openclaw/openclaw.json. O OpenClaw lê esse arquivo automaticamente durante a inicialização. Os exemplos a seguir usam a região China (Beijing). Se você utilizar uma região diferente, substitua a baseUrl pela URL correspondente na tabela acima.
auth.mode: none), o que é adequado apenas para uso local em uma única máquina. Para acesso compartilhado ou remoto, execute openclaw doctor --fix para ativar a autenticação por token.- Método 1: Terminal
- Método 2: Web UI
- Abra o arquivo de configuração
-
Adicione a configuração
Para uma nova configuração: Copie o conteúdo abaixo para o arquivo de configuração. Substitua
YOUR_API_KEYpela sua API Key do Model Studio. Para uma configuração existente: Para preservar suas configurações atuais, não substitua todo o conteúdo do arquivo. Consulte Como modificar com segurança uma configuração existente.
-
Salve e saia
Pressione
Ctrl+X, pressioneYpara confirmar o salvamento e, em seguida, pressioneEnterpara confirmar o nome do arquivo. - Aplique a configuração Para aplicar as alterações, reinicie o gateway com o seguinte comando:
Conectar a canais de mensagens
WhatsApp
Etapa 1: Instalar o plugin do WhatsApp
A conexão com o canal WhatsApp é feita por meio de um plugin. Execute o comando abaixo para instalá-lo:
Etapa 2: Configurar o canal WhatsApp
Digite o prompt abaixo no chat do OpenClaw. O sistema solicitará seu número de telefone no formato E.164 (sinal + seguido do código do país e do número), adicionará automaticamente o número à configuração e concluirá a setup.
selfChatMode. Assim, o bot responderá apenas no chat "Message yourself", sem interferir nas demais conversas.Etapa 3: Vincular ao WhatsApp
- Inicie o processo de vinculação do WhatsApp. O terminal exibirá um QR code.
- Abra o WhatsApp no celular e escaneie o QR code exibido no terminal para vincular sua conta.
- Reinicie o gateway.
Etapa 4: Testar
- Verifique o status do canal WhatsApp:
ON com status OK.
2. No WhatsApp, envie uma mensagem para si mesmo e verifique se o bot responde corretamente.
Telegram
-
Criar um bot usando oBotFather
Envie o comando
/newbot, siga as instruções para definir o nome e o username do bot (o username deve terminar combot) e copie o token retornado (formato:123456789:ABCdefGHIjklMNOpqrsTUVwxyz). Salve-o em um local seguro. -
No chat do OpenClaw, digite o prompt abaixo e substitua
xxxxpelo token real do seu bot. O OpenClaw aplicará a configuração automaticamente.
- Após concluir a configuração, reinicie o gateway.
- No Telegram, envie uma mensagem para o seu bot. Ao enviar a primeira mensagem, você receberá um pairing code.
- No terminal, execute o comando abaixo, substituindo
xxxpelo pairing code recebido:
Discord
Etapa 1: Criar um aplicativo e bot no Discord
- Criar um aplicativo no Discord Acesse o Portal de Desenvolvedores do Discord, clique em New Application, insira o nome do aplicativo e clique em Create.
-
Criar o bot e habilitar permissões
- No painel de navegação à esquerda, clique em Bot e defina um username para ele.
-
Na página Bot, role até Privileged Gateway Intents e ative as seguintes intenções:
- Message Content Intent
- Server Members Intent
- Presence Intent
- Obter o token do bot No topo da página Bot, clique em Reset Token para gerar um novo token. Como ele é exibido apenas uma vez, copie-o e armazene-o imediatamente em um local seguro.
-
Adicionar o bot a um servidor
- No painel de navegação à esquerda, clique em OAuth2 e role até OAuth2 URL Generator.
-
Em Scopes, marque as caixas de seleção
boteapplications.commands. -
Na seção Bot Permissions que aparecer, selecione as seguintes permissões:
- View Channels
- Send Messages
- Read Message History
- Embed Links
- Attach Files
- Copie a URL gerada na parte inferior da página, abra-a no navegador, selecione o servidor desejado e clique em Continue para adicionar o bot.
Etapa 2: Configurar o Discord no OpenClaw
- Na máquina onde o OpenClaw está em execução, defina o token do bot como variável de ambiente.
- Conclua a configuração do Discord:
- Reinicie o gateway para aplicar a configuração.
Etapa 3: Parear e testar
- No Discord, envie uma mensagem direta ao bot. Ao enviar a primeira mensagem, você receberá um pairing code.
- No terminal, execute o comando abaixo para concluir o pareamento, substituindo
xxxpelo pairing code recebido:
- Verifique o status do canal Discord:
ON com status OK.
4. Envie uma mensagem no Discord para testar a conexão.
Comandos comuns
Comando | Descrição | Exemplo |
|---|---|---|
/help | Lista os comandos disponíveis. | /help |
/status | Exibe o modelo atual, a sessão e o status do gateway. | /status |
/model <model_name> | Alterna o modelo da sessão atual. | /model qwen3.7-max |
/new | Inicia uma nova sessão. | /new |
/compact | Compacta o histórico de conversas para liberar espaço na janela de contexto. | /compact |
/think <level> | Define a profundidade de inferência. Os níveis disponíveis são off, low, medium e high. | /think high |
/skills | Lista as skills disponíveis. | /skills |
Casos de uso
Caso de uso 1: Automatizar o X (Twitter)
É possível usar o OpenClaw para automatizar sua conta no X (Twitter), incluindo publicação de posts, respostas, buscas e navegação pela timeline.
Etapas de configuração
Etapas de configuração
- Instale o twitter-cli:
- Digite o comando abaixo em um diálogo do OpenClaw para instalar a Skill automaticamente.
- Reinicie o gateway para ativar a Skill.
- Verifique a instalação:
- O twitter-cli utiliza cookies do navegador para autenticação. Certifique-se de estar conectado ao x.com em um navegador compatível, como Chrome, Edge, Firefox, Arc ou Brave. O twitter-cli recuperará os cookies automaticamente. Alternativamente, defina manualmente as informações de autenticação usando variáveis de ambiente:
auth_token e ct0.Exemplo 1: Publicar um post automaticamente
Exemplo 1: Publicar um post automaticamente
Check Sam Altman's recent tweets, summarize the key points, and then help me post a tweet with my thoughts em um diálogo do OpenClaw. O OpenClaw buscará automaticamente o feed, analisará o conteúdo e publicará o post.Exemplo 2: Pesquisar tópicos em alta
Exemplo 2: Pesquisar tópicos em alta
Search for tweets about harness engineering from yesterday. O OpenClaw pesquisará tweets relevantes e resumirá os pontos principais.Caso de uso 2: Analisar e baixar vídeos do YouTube
O OpenClaw permite pesquisar vídeos no YouTube, extrair informações e realizar downloads. O recurso oferece suporte a busca por palavra-chave, ordenação por data e obtenção em massa de metadados de vídeo.
Etapas de configuração
Etapas de configuração
- Instale o yt-dlp:
- Verifique a instalação:
- (Opcional) Configure a autenticação por cookie. Esse passo é necessário para acessar vídeos com restrição de idade, exclusivos para membros ou privados. Certifique-se de estar conectado ao youtube.com em seu navegador e insira o seguinte comando em um diálogo do OpenClaw:
yt-dlp para realizar operações relacionadas a vídeos.Exemplo 1: Resumir o conteúdo de um vídeo
Exemplo 1: Resumir o conteúdo de um vídeo
Summarize the main points of this video: https://www.youtube.com/watch?v=XRgGFQ0EgM0 em um diálogo do OpenClaw. O sistema recupera as informações do vídeo e gera um resumo.Exemplo 2: Baixar um vídeo
Exemplo 2: Baixar um vídeo
Download this video: https://www.youtube.com/watch?v=XRgGFQ0EgM0 em um diálogo do OpenClaw. O OpenClaw executa o yt-dlp para baixar o vídeo em sua máquina local.Caso de uso 3: Agendar entrega diária de notícias sobre IA
Utilize o recurso cron do OpenClaw para buscar automaticamente as últimas notícias sobre IA e enviá-las diariamente pelo WhatsApp.
Etapas de configuração
Etapas de configuração
- Execute o comando abaixo no terminal:
Parâmetro | Descrição |
|---|---|
| Nome da tarefa. |
| Expressão cron. |
| Fuso horário. Defina como |
| Prompt enviado ao agente, especificando qual conteúdo buscar e como resumi-lo. |
| Canal de envio. Defina como |
| Envia a saída da tarefa para o destinatário especificado. |
| Número de telefone do WhatsApp do destinatário no formato E.164, incluindo sinal de mais, código do país e número de telefone. |
- Liste todas as tarefas para obter o ID da tarefa:
- Acione a tarefa manualmente:
- Verifique o resultado da execução:
"status": "ok" e "delivered": true, as notícias foram entregues com sucesso no WhatsApp.Caso de uso 4: Análise do mercado de ações
O OpenClaw possibilita analisar tendências de ações e receber análises técnicas e sugestões de investimento.
Etapas de configuração
Etapas de configuração
- Instale a Skill. Insira a seguinte instrução em um diálogo do OpenClaw. A instalação será concluída automaticamente.
- Reinicie o gateway para ativar a Skill.
- Em um diálogo do OpenClaw, faça perguntas relacionadas a ações, como
Analyze NVDA stock.
Saiba mais
Skill
Skills são módulos extensíveis que fornecem novas capacidades. O agente seleciona e carrega automaticamente a Skill apropriada com base na solicitação do usuário. O OpenClaw permite visualizar e ativar Skills integradas, instalar Skills da comunidade no ClawHub ou criar Skills personalizadas.
Visualização das skills existentes
- Visualize suas Skills instaladas e seus respectivos status:
- As Skills integradas vêm desativadas por padrão. Para ativá-las, adicione-as à lista de permissões
skills.allowBundledno arquivo~/.openclaw/openclaw.json. O OpenClaw carrega apenas as Skills integradas listadas nesse array.
skills.entries do arquivo ~/.openclaw/openclaw.json. Para mais detalhes, consulte a documentação de Configuração de Skills.
Busca de mais skills
Encontre e instale mais Skills utilizando um dos métodos a seguir.
- Pesquisa e instalação via ClawHub ClawHub oferece mais de 3.000 Skills da comunidade. Navegue pelo site ou pesquise pela linha de comando.
-
Solicitação direta ao OpenClaw
Descreva sua necessidade diretamente no chat, por exemplo:
Help me find a Skill that can check the weather. O OpenClaw pesquisará e instalará automaticamente uma Skill correspondente.
Criação de uma skill personalizada
- Crie um diretório para sua Skill.
- Nesse diretório, crie o arquivo
SKILL.md. O arquivo consiste em duas partes: front matter YAML e instruções Markdown. Os camposnameedescriptionsão obrigatórios. O Agente utiliza adescriptionpara decidir se deve carregar a Skill. Garanta que a descrição seja precisa.
- Reinicie o gateway para aplicar a Skill.
Perguntas frequentes
Como visualizo meus modelos configurados?
Como visualizo meus modelos configurados?
openclaw tui no terminal. Em seguida, digite /model para ver a lista de modelos. Pressione Enter para selecionar um modelo e Esc para sair da lista.Por que recebo o erro HTTP 401: Incorrect API key provided. , No API key found for provider xxx ou HTTP 401: invalid_iam_token ?
Por que recebo o erro HTTP 401: Incorrect API key provided. , No API key found for provider xxx ou HTTP 401: invalid_iam_token ?
- A chave de API pode ser inválida, expirada, estar vazia, formatada incorretamente ou destinada ao endpoint errado. Verifique se a chave corresponde ao seu método de pagamento, se foi copiada integralmente sem espaços extras e se a assinatura da sua conta está ativa.
- O OpenClaw pode estar usando uma configuração incorreta ou obsoleta do cache. Para resolver, exclua o item de configuração
providersdo arquivo~/.openclaw/agents/main/agent/models.jsone reinicie o OpenClaw. invalid_iam_tokenindica falha na autenticação IAM da chave de API. Cenários comuns incluem: chave revogada ou desativada; região da chave diferente da região da Base URL (por exemplo, chave criada em China (Beijing), mas Base URL apontando para Singapore); ou credencial temporária STS expirada. Confirme se a chave de API e a Base URL pertencem à mesma região e se o status da chave está ativo.
Já configurei outros canais como DingTalk. Como adiciono modelos de um novo plano com segurança, sem perder minha configuração atual?
Já configurei outros canais como DingTalk. Como adiciono modelos de um novo plano com segurança, sem perder minha configuração atual?
- Não utilize a função "Substituir Tudo", pois isso sobrescreverá sua configuração personalizada. Em vez disso, modifique apenas as seções relevantes.
-
Use um dos métodos a seguir para concluir a configuração:
- Se o OpenClaw estiver respondendo normalmente: Insira os comandos diretamente em um chat do OpenClaw para mesclar a configuração.
- Se o OpenClaw não tiver modelos configurados ou não estiver respondendo: Edite manualmente o arquivo
~/.openclaw/openclaw.json. Modifique apenas os campos relevantes e mantenha sua configuração existente inalterada.
O que fazer ao receber o erro device identity required ?
O que fazer ao receber o erro device identity required ?
- Você está acessando a URL no navegador pela primeira vez e o pareamento de dispositivos ainda não foi concluído.
- O cache do navegador foi limpo, causando a perda da chave do dispositivo.
- Após reinstalar ou atualizar o OpenClaw, o arquivo de chave no diretório
~/.openclaw/identity/está ausente.
openclaw devices list para confirmar que o dispositivo aparece na lista de pareados.Consumo de tokens mesmo com o OpenClaw ocioso
Consumo de tokens mesmo com o OpenClaw ocioso
~/.openclaw/agents/main/sessions/. As chamadas de heartbeat são marcadas com [OpenClaw heartbeat poll].Soluções:- Parar o gateway: Execute
openclaw gateway stopquando não estiver utilizando o serviço. Isso interrompe o heartbeat imediatamente. - Aumentar o intervalo do heartbeat: Defina
agents.defaults.heartbeat.everyno arquivo~/.openclaw/openclaw.json. Por exemplo,"2h"define o intervalo para cada 2 horas.