Use modelos do Alibaba Cloud Model Studio no OpenClaw.
Início rápido
- 1
Instale o plugin Qwen
Se o plugin não puder ser instalado, consulte Configurar com um arquivo de configuração. - 2
Obtenha uma chave de API
- Token Plan
- Pagamento conforme o uso
- Coding Plan
Obtenha uma chave de API do Token Plan de acordo com sua edição:- Token Plan Personal Edition: Criar ou visualizar API Key
- Token Plan Team Edition: Atribuir assento e obter API Key
- 3
Configure o modelo
Execute o comando correspondente ao seu plano de cobrança e insira a chave de API quando solicitado.- Token Plan
- Pagamento conforme o uso
- Coding Plan
- 4
Verifique
Execute os comandos a seguir para verificar a lista de modelos e fazer uma chamada de teste:
Configurar com um arquivo de configuração
Use este método se o plugin Qwen não puder ser instalado ou se você preferir gerenciar a configuração manualmente.
- 1
Abra ou crie o arquivo de configuração
~/.openclaw/openclaw.jsonAtualize apenas os campos relevantes emmodels,agentsegateway. Não substitua o arquivo inteiro. - 2
Grave a configuração
- Token Plan Edição Pessoal
- Token Plan Edição de Equipe
- Pagamento conforme o uso
- Coding Plan
SubstituaYOUR_API_KEYpela chave de API da Edição Pessoal do Token Plan.Ao usar qwen4-max-preview, useparams.cacheRetentionpara definirshort,longounone;longusa um TTL de 1 hora.Ao usar qwen4-max, definaparams.cacheRetentioncomoshort,longounone.longcorresponde a um TTL de 1 hora. qwen4-max tem contexto de 1 M de tokens. A saída máxima é de 131.072 tokens no modo sem pensamento e de 262.144 tokens para pensamento e resposta final combinados. Os padrões são reasoning_effort=high e thinking_budget=131072.
gateway.auth.mode: none é adequado apenas para uso local em uma única máquina. Para compartilhar ou acessar remotamente, execute openclaw doctor --generate-gateway-token para gerar um token e reinicie o Gateway.Conectar canais de mensagens
- DingTalk
- WeChat
- QQ
- 1
Crie um aplicativo DingTalk e obtenha as credenciais
- Faça login na DingTalk Open Platform, selecione uma organização na qual você tenha permissões de desenvolvedor ou crie uma organização e então obtenha permissões de desenvolvedor.
- Na barra de menu superior, selecione Desenvolvimento de Aplicativos, clique em Criar Aplicativo, insira um nome e uma descrição para o aplicativo e clique em Salvar.
- Na página Adicionar Recursos do Aplicativo, adicione um Bot. Ative a Configuração do Bot, preencha os campos obrigatórios, mantenha o Modo Stream padrão para o modo de recebimento de mensagens e clique em Publicar.
- Na página Credenciais e Informações Básicas, obtenha o Client ID e o Client Secret.
- Na página Gerenciamento de Versões e Lançamento, crie uma versão, defina o intervalo de visibilidade, salve e publique.
- 2
Instale o plugin do canal DingTalk
A saída deve incluir o plugindingtalkcom o statusloaded. - 3
Configure o canal DingTalk
Adicione as configurações a seguir a~/.openclaw/openclaw.json. SubstituaYOUR_DINGTALK_APPKEYeYOUR_DINGTALK_APPSECRETpelas credenciais da Etapa 1. Não sobrescreva configurações existentes, comomodelseagents.DefinirdmPolicyegroupPolicycomoopené adequado para testes ou uso pessoal. Em um ambiente de produção, defina-os comoallowliste adicione o campoallowFrom: - 4
Verifique
Na seção Canais, o DingTalk deve estarONcom o statusOK - configured. Envie uma mensagem para o bot em um grupo do DingTalk para testar a conexão.
Lark
- 1
Crie um aplicativo Lark
- Acesse a Lark Open Platform, clique em Criar Aplicativo Corporativo Personalizado, insira um nome e uma descrição para o aplicativo, selecione um ícone e clique em Criar.
- Na página Credenciais e Informações Básicas, copie o App ID (no formato
cli_xxx) e o App Secret. - Na página Gerenciamento de Permissões, clique em Importar/Exportar Permissões em Lote, cole o JSON a seguir, clique em Avançar, Confirmar Novas Permissões e clique em Solicitar Ativação.
- Na página Adicionar Recursos do Aplicativo, selecione a guia Adicionar por Capacidade, localize o cartão Robô e clique em Configurar.
- Em Eventos e Callbacks, na guia Configuração de Eventos, defina Método de Assinatura como Usar conexão de longa duração para receber eventos e salve. Em seguida, adicione o evento
im.message.receive_v1. - Na página Gerenciamento de Versões e Lançamento, crie uma versão, insira o número da versão e a descrição da atualização, salve e envie para revisão e publicação.
- 2
Configure o bot Lark
Executeopenclaw channels add, selecione Feishu e insira o App ID e o App Secret. Em seguida, reinicie o gateway:Adicione o bot a um grupo do Lark ou envie uma mensagem para o bot. O bot responde com uma mensagem contendo um código de emparelhamento. Copie a última linha e envie-a no chat do OpenClaw para concluir o emparelhamento. - 3
Verifique
Na seção Canais, o Lark deve estarONcom o statusOK. Envie uma mensagem no Lark para testar a conexão.
Códigos de erro
Se você encontrar erros durante a configuração, consulte a documentação de perguntas frequentes do seu plano de cobrança:
- Token Plan: FAQ da Edição Pessoal · FAQ da Edição de Equipe
- Pagamento conforme o uso: Códigos de erro
- Coding Plan: FAQ do Coding Plan
FAQ
Como usar um plano de economia com pagamento conforme o uso?
Como usar um plano de economia com pagamento conforme o uso?
Como posso visualizar os modelos configurados?
Como posso visualizar os modelos configurados?
openclaw tui no terminal para iniciar a linha de comando do terminal do OpenClaw e, em seguida, digite /model para visualizar a lista de modelos. Pressione Enter para selecionar um modelo e Esc para sair da lista.Por que recebo os erros HTTP 401: Incorrect API key provided., No API key found for provider xxx ou HTTP 401: invalid_iam_token?
Por que recebo os erros HTTP 401: Incorrect API key provided., No API key found for provider xxx ou HTTP 401: invalid_iam_token?
- A chave de API é inválida, expirou, está vazia, tem formato incorreto ou é para o endpoint errado. Verifique se a chave de API corresponde ao seu método de pagamento, se foi copiada por completo sem espaços extras e se sua assinatura está ativa.
- O OpenClaw está usando uma configuração incorreta e desatualizada do cache de configuração. Exclua o item de configuração
providersde~/.openclaw/agents/main/agent/models.jsone reinicie o OpenClaw. invalid_iam_tokenindica que a chave de API falhou na autenticação IAM. Cenários comuns incluem: a chave de API foi revogada ou desativada; a região da chave de API não corresponde à região da Base URL (por exemplo, a chave de API foi criada em Singapura, mas a Base URL aponta para outra região); ou uma credencial temporária do STS expirou. Verifique se a chave de API e a Base URL pertencem à mesma região e se o status da chave de API está ativo.
Já configurei outros canais, como o DingTalk. Como posso adicionar modelos de um novo plano com segurança?
Já configurei outros canais, como o DingTalk. Como posso adicionar modelos de um novo plano com segurança?
- Não use uma função de substituir tudo. Ela sobrescreve configurações personalizadas. Modifique apenas as seções relevantes.
- 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
~/.openclaw/openclaw.json. Modifique apenas os campos relevantes e deixe a configuração existente inalterada.
O que devo fazer se receber um erro device identity required?
O que devo fazer se receber um erro device identity required?
- Você está acessando a URL em um navegador pela primeira vez e o emparelhamento do dispositivo não foi concluído.
- O cache do navegador foi limpo, fazendo com que a chave do dispositivo fosse perdida.
- 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 dispositivos emparelhados.O consumo de tokens ocorre mesmo quando o OpenClaw não está em uso ativo
O consumo de tokens ocorre mesmo quando o OpenClaw não está em uso ativo
~/.openclaw/agents/main/sessions/. As chamadas de heartbeat são marcadas com [OpenClaw heartbeat poll].Soluções:- Pare o gateway: execute
openclaw gateway stopquando não estiver em uso. Isso interrompe o heartbeat imediatamente. - Aumente o intervalo do heartbeat: defina
agents.defaults.heartbeat.everyem~/.openclaw/openclaw.json. Por exemplo,"2h"define o intervalo para a cada 2 horas.