Informações gerais
OpenClaw é um framework de AI Agent open source que permite acessar canais de comunicação como DingTalk e modelos de linguagem grande como Bailian Qwen por meio de plug-ins.
Claude Code é uma ferramenta de programação assistida por IA da Anthropic que possibilita interagir com código via linguagem natural diretamente no terminal.
-
A instalação e a configuração dessas duas ferramentas no Agentic OS ECS apresentam alguns desafios:
Não há documentação pública sobre a estrutura do arquivo de configuração do OpenClaw, os canais do DingTalk não possuem suporte oficial e os requisitos de sequência de inicialização do Gateway são rigorosos.
O tutorial oficial do Claude Code foi escrito para macOS/Ubuntu. O Alinux apresenta diferenças de compatibilidade e problemas de permissão no npm.
Ambas as ferramentas carecem de documentação sobre como configurar a API DashScope.
Com o suporte a Skills, o Agent conclui a implantação de ponta a ponta em uma única frase, reduzindo para apenas alguns minutos processos que antes não podiam ser automatizados ou exigiam várias rodadas de tentativa e erro.
Caso 1: Implantar o OpenClaw em uma frase
Pré-requisitos
Uma instância ECS Agentic OS (RAM de 4 GB ou mais) criada e conectada à Internet.
Um aplicativo empresarial interno criado no Backend de Desenvolvedores do DingTalk, com AppKey e AppSecret obtidos.
important: Ative o aplicativo DingTalk no backend de desenvolvedores, habilite as Capacidades de robô e selecione o modo de recebimento de mensagens como Modo Stream . Além disso, ative as seguintes permissões:Card.Streaming.Write,Card.Instance.Writeeqyapi_robot_sendmsg
Chave da API DashScope obtida no console Bailian.
Modo YOLO ativado para evitar a confirmação manual na execução de comandos Shell (
/approval-mode yolo).
Etapas de operação
Etapa 1: Iniciar as instruções de implantação
No terminal do Agentic OS, envie o seguinte comando ao Agent:
Help me install OpenClaw, AppKey is <appkey>, AppSecret is <appsecret>, API Key is <dashscope apikey>-
O Agent executará automaticamente as seguintes ações:
Detectar e instalar o ambiente de execução Node.js.
Instalar o OpenClaw e os plug-ins do DingTalk via npm, adicionando automaticamente espelhos npmmirror para acelerar downloads na rede local.
Inicializar a estrutura do projeto e os arquivos de configuração do OpenClaw.
Configurar o modo Gateway (
gateway.mode).Executar
openclaw doctor --fixpara gerar o token de autenticação.
important: A ordem de inicialização do Gateway é crítica: configure primeiro o parâmetrogateway.modee só então executeopenclaw doctor --fix. A skill já incorpora a ordem correta de execução, sem necessidade de intervenção manual.
Etapa 2: Verifique os resultados da implantação
Após a conclusão da implantação, localize o robô correspondente no DingTalk e envie uma mensagem de teste.
Se o robô responder normalmente, a implantação de ponta a ponta foi bem-sucedida.
Pontos de atenção
Caso a inicialização do gateway falhe durante a implantação, verifique se a sequência de inicialização do Gateway está correta.
Se o Robô do DingTalk não responder, confirme se todas as permissões do aplicativo (Card.Instance.Write, Card.Streaming.Write, etc.) estão ativadas.
Caso 2: Implantar o Claude Code em uma frase
Pré-requisitos
Uma instância ECS Agentic OS (RAM de 4 GB ou mais) criada e conectada à Internet.
important: O Claude Code consome muita memória durante a execução. Certifique-se de que a RAM da instância ECS seja de pelo menos 4 GB.
Chave da API DashScope obtida no console Bailian (caso seja necessário configurar uma API de terceiros).
Modo YOLO ativado para evitar a confirmação manual na execução de comandos Shell (
/approval-mode yolo).
Etapas de operação
Etapa 1: Inicie o comando de instalação
No terminal do Agentic OS, envie o seguinte comando ao Agent:
Help me install a Claude Code and configure the Dashscope APIKey: <dashscope apikey>-
O Agent detectará automaticamente o ambiente atual do sistema e escolherá o método ideal de instalação conforme a seguinte prioridade:
Instalação nativa: Prioriza o uso do gerenciador de pacotes nativo do sistema.
Instalação via npm: Caso o método nativo não esteja disponível, instala globalmente via npm e corrige automaticamente problemas de permissão EACCES.
Instalação via nvm: Se o método npm falhar, instala automaticamente um ambiente Node.js independente via nvm e prossegue com a instalação.
illustrate: Os três métodos de instalação sofrem downgrade automático sem intervenção manual. A Skill lida automaticamente com problemas de compatibilidade do Alinux 4, incluindo correções de permissões EACCES.
Etapa 2: Verifique os resultados da instalação
O Agent executa o comando abaixo para confirmar se o Claude Code foi instalado corretamente:
claude --version
Etapa 3: Configure a APIKey do Dashscope
O Agent configura automaticamente a APIKey do Dashscope para o Claude Code.
Inicie o Claude Code e teste se a interação com o modelo ocorre normalmente.
Pontos de atenção
Obtenha previamente a Chave da API DashScope no console Alibaba Cloud Bailian e ative os serviços relacionados.
Se todos os métodos de instalação falharem, verifique a conectividade de rede e a versão do Node.js (recomenda-se a versão 18+).