Todos os produtos
Search

Este produto

    Server Migration Center:SMC AI Agent Edition Client (Public Preview)

    Central de documentação

    Server Migration Center:SMC AI Agent Edition Client (Public Preview)

    Última atualização: Oct 13, 2026

    O cliente da edição AI Agent do Server Migration Center (SMC), conhecido como SMCClaw, é um assistente inteligente de migração. Ele transfere servidores para a cloud por meio de conversas. Enquanto o cliente tradicional do SMC opera via linha de comando, o SMCClaw permite que você interaja por chat: importe sources de migração, crie e gerencie tarefas, visualize o status e solucione problemas. O sistema também oferece suporte a canais do DingTalk e a tarefas agendadas.

    smcclaw cron runs --id <jobId>

    Visão geral do cliente

    Recursos

    • Migração orientada por IA: Importe fontes de migração, crie tarefas, consulte o status e solucione problemas por meio de conversas em linguagem natural.

    • Operações da API do SMC: Habilidades integradas de migração do SMC chamam APIs do SMC para gerenciar fontes e tarefas de migração.

    • Tarefas agendadas: Acompanhe e monitore o progresso de tarefas de migração específicas.

      • smcclaw cron runs --id <jobId>

    • Console web: Um painel para conversas com IA, gerenciamento de sessões, configuração de canais, tarefas agendadas, configuração de modelos e visualização de logs.

    • TUI de linha de comando: Uma interface de terminal para conversar diretamente com o assistente de IA.

    • Aprovação de comandos: Um mecanismo de aprovação baseado em lista de permissões que controla a execução de comandos de risco.

    Comparação com o cliente tradicional do SMC

    Item

    Cliente tradicional do SMC

    Cliente da edição AI Agent do SMC

    Interação

    Linha de comando. Você insere os parâmetros manualmente.

    Conversa em linguagem natural. A IA interpreta sua intenção e executa a ação.

    Importar fonte de migração

    Execute manualmente um comando de código de ativação.

    Importe com uma única instrução na conversa.

    Gerenciar tarefas de migração

    Use o console do SMC ou a linha de comando.

    Gerencie por meio de conversa,.

    Monitoramento de status

    Faça login no console manualmente.

    Tarefas agendadas consultam automaticamente.

    Solução de problemas

    Investigue no console ou abra um ticket.

    A IA analisa e corrige erros de migração automaticamente.

    Nível de habilidade

    Requer conhecimento das etapas e parâmetros de migração do SMC.

    Descreva suas necessidades em linguagem simples. A IA orienta você.

    Cenários

    • Migração de servidores: Migre um servidor local ou remoto para a cloud.

    • Monitoramento do progresso da migração: Defina uma tarefa agendada para monitorar o andamento de uma tarefa de migração específica.

    • Solução de problemas de migração: Tire dúvidas sobre questões e troubleshooting de migração.

      • smcclaw cron runs --id <jobId>

    Instalar e configurar o cliente

    Etapa 1: Preparar o ambiente

    1. Prepare um servidor.

      • Linux: Acesso à rede pública para alcançar o Alibaba Cloud SMC e a API do modelo de linguagem grande (LLM) escolhido. Arquitetura x86_64, kernel 5,10 ou posterior, Python 3.9 ou posterior. Recomendamos Alibaba Cloud Linux 3, Ubuntu 22.04, Rocky Linux 9 ou versões mais recentes.

      • Windows: Acesso à rede pública para alcançar o Alibaba Cloud SMC e a API do LLM escolhido. Arquitetura x86_64, Windows Server 2016 ou posterior. Recomendamos Windows Server 2016, Windows 10 ou versões mais recentes.

    2. Prepare uma conta Alibaba Cloud com o SMC ativado. O SMC em si é gratuito, mas as instâncias intermediárias, discos cloud e tráfego de rede usados durante a migração podem gerar cobranças.

    3. Prepare uma chave de API de LLM. Recomendamos o Token Plan ou Coding Plan da Alibaba Cloud (Qwen Cloud).

    Etapa 2: Baixar e instalar

    Linux

    A instalação e a configuração inicial exigem privilégios de administrador. Execute os comandos a seguir como usuário root para baixar e instalar o cliente.

    Você também pode baixar o pacote diretamente do instalador Linux x64 e fazer upload dele para o servidor.

    1. Baixe o cliente da edição AI Agent.

      smcclaw cron runs --id <jobId>

    2. Extraia e instale o cliente.

      Execute ls para ver as versões no diretório atual. Substitua &lt;version&gt; pelo número da versão. Por exemplo, 2026.9.5.
      smcclaw cron runs --id <jobId>

    3. Verifique a versão do cliente.

      smcclaw cron runs --id <jobId>

    Windows

    A instalação e a configuração inicial exigem privilégios de administrador. Execute os comandos a seguir como administrador no PowerShell para baixar e instalar o cliente.

    Você também pode baixar o pacote diretamente do instalador Windows x64 e fazer upload dele para o servidor.

    1. Baixe o cliente da edição AI Agent.

      smcclaw cron runs --id <jobId>

    2. Extraia e instale o cliente.

      Substitua pelo número da versão. Por exemplo, 2026.9.5.
      smcclaw cron runs --id <jobId>

    3. Verifique a versão do cliente.

      smcclaw cron runs --id <jobId>
    Nota: Para chamar o smcclaw globalmente, adicione seu caminho à variável de ambiente PATH . Caso contrário, acesse o diretório bin e execute .\smcclaw.cmd . Este tópico pressupõe que o PATH já esteja configurado.

    Etapa 3: Configurar o cliente

    1. Configure o LLM.

      One-click setup (recommended)

      Os exemplos a seguir usam o Coding Plan (Global) com o modelo qwen/qwen3.7-plus . Para mais planos e modelos, consulte Mais configurações de modelos .

      Use apenas um plano. Não passe várias chaves de modelo em um único comando setup.

      Parâmetro

      Descrição

      <AccessToken ID>

      O AccessToken ID do código de ativação do SMC. Para obtê-lo, consulte obter um código de ativação.

      <AccessToken Code>

      O AccessToken Code do código de ativação do SMC. Para obtê-lo, consulte obter um código de ativação.

      <API_KEY>

      Para a chave de API Global, consulte First API call.

      --model

      O modelo a ser usado, no formato provider/model. Por exemplo, --model "qwen/qwen3.7-plus".

       
      smcclaw setup --modelstudio-api-key "<API_KEY>" --model "qwen/qwen3.7-plus" --accesstokenid "<AccessToken ID>" --accesstokencode "<AccessToken Code>"
      smcclaw cron runs --id <jobId>
      smcclaw cron runs --id <jobId>
      Importante

      O código de ativação é uma credencial sensível. Inseri-lo diretamente em um comando pode salvá-lo no histórico do shell. Gerencie as credenciais de acordo com seus requisitos de segurança.

      Interactive setup with onboard

      Os exemplos a seguir usam o Coding Plan (Global) com o modelo qwen/qwen3.7-plus .

      1. Inicie a configuração interativa.

        Para obter o &lt;AccessToken ID&gt; e o &lt;AccessToken Code&gt;, consulte obter um código de ativação.

        smcclaw cron runs --id <jobId>
        Importante

        O código de ativação é uma credencial sensível. Inseri-lo diretamente em um comando pode salvá-lo no histórico do shell. Gerencie as credenciais de acordo com seus requisitos de segurança.

      2. Siga as instruções:

        • Setup mode: OneClick

        • Model/auth provider: Qwen Cloud (se não estiver listado, selecione More.)

        • Qwen Cloud auth method: Coding Plan API Key for Global/Intl

        • API key: Insira sua Coding Plan API key.

        • Default model: Selecione um modelo, como qwen/qwen3.7-plus.

    2. Execute smcclaw gateway status. O status running indica que o service Gateway foi iniciado.

    Etapa 4: Iniciar uma conversa

    O Gateway escuta em 127.0.0.1:18789 por padrão e oferece três pontos de entrada para conversas.

    Dashboard (recommended)

    1. Obtenha o endereço do dashboard.

      smcclaw cron runs --id <jobId>

      A Authenticated Dashboard URL na saída é o endereço do dashboard.

    2. Abra o dashboard em um navegador.

      • Linux: Se o servidor não tiver navegador, execute o comando a seguir em uma máquina que tenha navegador e possa acessar o SMCClaw via SSH para criar um túnel. Mantenha o comando em execução e abra a URL do dashboard no navegador.

        smcclaw cron runs --id <jobId>

      • Windows: Abra a URL do dashboard diretamente no navegador do servidor.

    TUI

    Execute o comando a seguir para iniciar a TUI na máquina local:

    smcclaw cron runs --id <jobId>

    Comandos comuns da TUI

    Comando

    Finalidade

    /help

    Visualizar ajuda.

    /status

    Visualizar status.

    /new

    Iniciar uma sessão.

    /model &lt;model&gt;

    Alternar o modelo.

    /stop

    Parar a tarefa atual.

    /exit

    Sair da TUI.

    A TUI não recebe notificações de tarefas agendadas. Para monitorar o progresso da migração automaticamente, use o dashboard ou um canal de mensagens instantâneas.

    Migrar um servidor pela primeira vez

    O SMCClaw suporta três cenários de migração de servidores:

    • Migração local direta: Migre o servidor que executa o SMCClaw.

    • Migração remota via SSH: Migre um servidor remoto por SSH.

    • Migração assistida remota: O SMCClaw fornece um script de importação que você executa manualmente antes da migração.

    Exemplos de instruções:

    smcclaw cron runs --id <jobId>

    Fluxo de trabalho de migração

    1. Identificar a intenção de migração: A IA interpreta sua conversa e confirma o alvo da migração.

      O registro da fonte de migração, os testes de migração e a sincronização de dados consomem recursos de CPU, disco e rede. Para redução de disco durante a migração, avalie conjuntamente o sistema de arquivos, o layout de partições, o volume real de dados e os resultados dos testes. Em produção, execute a migração fora do horário de pico e faça backup dos dados antes.

    2. Configurar o código de ativação: Na primeira migração, se nenhum código de ativação do SMC estiver salvo localmente, o cliente solicitará o AccessToken ID e o AccessToken Code. Obtenha o código de ativação e forneça-o durante a conversa.

    3. Registrar ou importar a fonte de migração: Após coletar as informações da fonte, a IA importa a fonte de migração e retorna seus detalhes básicos.

    4. Analisar a migração e estimar custos: A IA analisa a migração e estima os custos com base nas informações da fonte e nos preços dos recursos cloud.

      A estimativa serve apenas como referência. As cobranças reais baseiam-se na sua fatura da Alibaba Cloud.

    5. Criar e iniciar a tarefa de migração: Após você confirmar os custos, a IA cria e inicia a tarefa de migração, definindo também uma tarefa agendada para monitorar o progresso automaticamente. A tarefa executa um teste de migração por padrão: primeiro testa a viabilidade da migração e gera um relatório de teste; depois, prossegue automaticamente para a migração formal após a aprovação no teste.

    6. Monitorar o progresso da migração: Durante a migração, a tarefa agendada consulta periodicamente o progresso na sessão atual e o reporta.

    7. Concluir a migração: Quando a tarefa de migração termina, a IA cancela a tarefa agendada de monitoramento de progresso, retorna um resumo da migração e aguarda sua próxima instrução.

    Mais configurações do cliente

    Tarefas agendadas

    Quando a migração começa, o SMCClaw cria uma tarefa agendada para monitorar a tarefa de migração especificada por padrão. Você também pode criar tarefas agendadas personalizadas por meio de conversa:

    smcclaw cron runs --id <jobId>

    Visualize as tarefas agendadas criadas no console do dashboard.

    Comandos comuns de gerenciamento

    smcclaw cron runs --id <jobId>

    Expressões Cron comuns

    Expressão

    Descrição

    0 9 * * *

    Todos os dias às 9:00

    0 9 * * 1-5

    Dias úteis às 9:00

    0 */2 * * *

    A cada 2 horas

    30 22 * * *

    Todos os dias às 22:30
    Importante

    As tarefas agendadas dependem de um Gateway em execução. Execute smcclaw cron runs --id &lt;jobId&gt; para visualizar o histórico de execução.

    Políticas de segurança

    • Vinculação do Gateway: O Gateway se vincula apenas ao endereço de loopback local por padrão. Para acesso remoto, use primeiro um túnel SSH.

    • Token do Gateway: O token do Gateway e qualquer URL de dashboard que contenha o token são credenciais sensíveis. Não os compartilhe nem os mantenha em capturas de tela sem redação.

    • Código de ativação: O código de ativação do SMC é uma credencial sensível. Forneça-o apenas em uma TUI local ou em uma sessão privada do dashboard, e limpe documentos, capturas de tela e logs regularmente.

      • smcclaw cron runs --id <jobId>

    • Origem dos comandos: Não envie comandos de fontes desconhecidas para a IA. Verifique o comando completo e o caminho de destino antes de executar uma operação destrutiva.

    • Política de execução: A política padrão é allowlist + on-miss: qualquer comando fora da lista de permissões requer aprovação. Recomendamos mantê-la ativada.

    Para visualizar a configuração de segurança, execute:

    smcclaw cron runs --id <jobId>

    Iniciar e parar o service

    smcclaw cron runs --id <jobId>

    Desinstalar o cliente

    • Linux: Execute os comandos a seguir para desinstalar o cliente.

      smcclaw cron runs --id <jobId>
      Importante

      Se você usou um diretório personalizado durante a instalação, especifique o mesmo diretório --prefix ao desinstalar. Caso contrário, a limpeza falhará. Por exemplo: bash /usr/local/smcclaw/install.sh --prefix /usr/local/smcclaw --uninstall

    • Windows: Execute smcclaw gateway uninstall para remover o service Gateway e, em seguida, exclua o diretório extraído do SMCClaw.

    Limpar configurações e dados

    Execute os comandos a seguir para fazer backup e excluir a configuração ou o diretório de trabalho:

    smcclaw cron runs --id <jobId>

    O smcclaw uninstall remove o service Gateway e os dados locais selecionados. Ele não exclui os arquivos de programa da CLI. Para excluir os arquivos de programa da CLI, consulte desinstalar o cliente.

    Consulta de status e diagnósticos

    smcclaw cron runs --id <jobId>

    Perguntas frequentes

    Como obter um código de ativação?

    1. Acesse a página Server Migration no console do SMC.

    2. Na página Server Migration, clique em Import Source Servers.

    3. Na página Import Source Servers, clique em Use Client to Import Server.

    4. Na página Import Migration Source, selecione Client Import.

    5. Em Description, selecione o tipo de sistema operacional e clique em Generate.

    6. Copie o Access Token ID e o Access Token Code gerados.

    Como personalizar o diretório de instalação no Linux?

    Por padrão, o script de instalação:

    • Instala em /opt/smcclaw.

    • Cria um link simbólico em /usr/local/bin/smcclaw.

    • Tenta instalar as dependências Python para as habilidades de migração do SMC.

    Para personalizar o diretório de instalação, execute:

    Substitua &lt;version&gt; pelo número da versão. Por exemplo, 2026.9.5.
    smcclaw cron runs --id <jobId>

    Mais configurações de modelo

    Recomendado: Alibaba Cloud (Qwen Cloud)

    O provedor Qwen já vem integrado. A configuração inicial não solicita o download de plugin via npm. Caso tenha atualizado de uma versão anterior que baixava o plugin Qwen automaticamente, execute primeiro smcclaw doctor --fix para limpar o registro antigo de instalação do plugin. Escolha um comando conforme seu plano e site:

    Plano

    Site

    Comando de configuração rápida

    Token Plan (recomendado)

    China

    smcclaw setup --qwen-token-plan-api-key-cn "&lt;API_KEY&gt;" --model "qwen/qwen3.7-plus" --accesstokenid "&lt;AccessToken ID&gt;" --accesstokencode "&lt;AccessToken Code&gt;"

    Coding Plan

    China

    smcclaw setup --modelstudio-api-key-cn "&lt;API_KEY&gt;" --model "qwen/qwen3.7-plus" --accesstokenid "&lt;AccessToken ID&gt;" --accesstokencode "&lt;AccessToken Code&gt;"

    Coding Plan

    Global

    smcclaw setup --modelstudio-api-key "&lt;API_KEY&gt;" --model "qwen/qwen3.7-plus" --accesstokenid "&lt;AccessToken ID&gt;" --accesstokencode "&lt;AccessToken Code&gt;"

    Standard API

    China

    smcclaw setup --modelstudio-standard-api-key-cn "&lt;API_KEY&gt;" --model "qwen/qwen3.7-plus" --accesstokenid "&lt;AccessToken ID&gt;" --accesstokencode "&lt;AccessToken Code&gt;"

    Standard API

    Global

    smcclaw setup --modelstudio-standard-api-key "&lt;API_KEY&gt;" --model "qwen/qwen3.7-plus" --accesstokenid "&lt;AccessToken ID&gt;" --accesstokencode "&lt;AccessToken Code&gt;"
    Importante

    • Escolha apenas um comando. Não informe múltiplas chaves de modelo em um único comando setup.

    • O Token Plan utiliza o endpoint compatível com OpenAI https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1. Obtenha a chave de API no console do Model Studio.

    • O parâmetro --model especifica o modelo no formato provider/model. Por exemplo, --model "qwen/qwen3.7-plus".

    Outros modelos principais

    Service de modelo

    Comando de configuração rápida

    OpenAI

    smcclaw setup --openai-api-key "&lt;API_KEY&gt;"

    Anthropic Claude

    smcclaw setup --anthropic-api-key "&lt;API_KEY&gt;"

    Google Gemini

    smcclaw setup --gemini-api-key "&lt;API_KEY&gt;"

    DeepSeek

    smcclaw setup --deepseek-api-key "&lt;API_KEY&gt;"

    Moonshot/Kimi (China)

    smcclaw setup --auth-choice moonshot-api-key-cn --moonshot-api-key "&lt;API_KEY&gt;"

    Moonshot/Kimi (Global)

    smcclaw setup --moonshot-api-key "&lt;API_KEY&gt;"

    Zhipu Z.AI

    smcclaw setup --zai-api-key "&lt;API_KEY&gt;"

    Volcengine

    smcclaw setup --volcengine-api-key "&lt;API_KEY&gt;"

    MiniMax (China)

    smcclaw setup --auth-choice minimax-cn-api --minimax-api-key "&lt;API_KEY&gt;"

    Mistral

    smcclaw setup --mistral-api-key "&lt;API_KEY&gt;"

    Endpoint personalizado compatível com OpenAI

    smcclaw setup --custom-base-url "&lt;BASE_URL&gt;" --custom-model-id "&lt;MODEL_ID&gt;" --custom-api-key "&lt;API_KEY&gt;"

    Após configurar, verifique o status:

    smcclaw cron runs --id <jobId>
    Importante

    Inserir uma chave de API diretamente em um comando pode salvá-la no histórico do shell. Gerencie as credenciais conforme seus requisitos de segurança.

    Como verificar o uso do modelo?

    Abra a página de uso do painel em http://127.0.0.1:18789/usage para visualizar o consumo de tokens de API e o custo de cada modelo.

    O painel exibe falha de conexão. O que fazer?

    Se aparecer a mensagem "The browser cannot complete the Gateway connection. Check the target and transport before you retry the credentials", verifique se o token do Gateway está correto.

    A resposta da IA falha com "Agent failed before reply." O que fazer?

    Verifique se a configuração do modelo está correta. Confirme se você usou a chave de API do modelo errada ou o nome provider/model incorreto.

    A conexão com o Gateway falha. O que fazer?

    1. Confirme o status do service.

      Execute smcclaw gateway status para verificar se o Gateway está em execução.

    2. Verifique a porta de escuta.

      O Gateway escuta na porta 18789 por padrão. Verifique se a porta está em uso, bloqueada por firewall ou se o Gateway não está escutando nela.

    3. Execute o autodiagnóstico do ambiente.

      Execute smcclaw doctor para identificar problemas na configuração do ambiente.

    4. Visualize os logs de execução para encontrar a causa da falha de conexão. Execute smcclaw logs --follow.

    A chamada ao modelo falha. O que fazer?

    1. Verifique se o status do modelo está normal.

      smcclaw cron runs --id <jobId>

    2. Execute o autodiagnóstico do ambiente.

      smcclaw cron runs --id <jobId>

    3. Visualize os logs de execução.

      smcclaw cron runs --id <jobId>

    4. Verifique a chave de API.

      Confirme se o AccessKey é válido, expirou ou foi desativado.

    smcclaw cron runs --id <jobId>

  • Confirme se o modo de recebimento de mensagens do bot é Stream.

  • Verifique as permissões de cartão do DingTalk.

    O SMCClaw responde com cartões interativos de IA (formato de mensagem rich text). Se o aplicativo não tiver permissões de cartão, a mensagem não será enviada. Confirme na DingTalk Open Platform se o aplicativo possui as permissões de cartão.

  • Verifique o status de publicação do aplicativo.

    Um aplicativo DingTalk precisa estar publicado para funcionar. Se estiver em desenvolvimento ou tiver sido removido, o bot não responderá. Verifique o status de publicação na DingTalk Open Platform.

  • Verifique o Client ID e o Secret.

    O Client ID e o Secret são as credenciais de identidade do aplicativo. Se estiverem incorretos, expirados ou redefinidos, o aplicativo não conseguirá se conectar ao DingTalk.

  • Investigue erros 403 de AI Card no log.

    Um erro 403 de AI Card significa que o DingTalk rejeitou a mensagem de cartão, geralmente devido a permissões insuficientes. Retorne à DingTalk Open Platform para confirmar se as permissões do aplicativo estão completas.

    • Uma tarefa agendada não foi executada. Como solucionar?

    1. Visualize a lista de tarefas.

      smcclaw cron runs --id <jobId>

      Confirme se a tarefa foi criada, está ativada e possui o agendamento correto.

    2. Visualize os detalhes de uma tarefa específica.

      smcclaw cron runs --id <jobId>

      Verifique a regra de agendamento, a última execução, a próxima execução programada e a configuração.

    3. Confirme o status do Gateway.

      smcclaw cron runs --id <jobId>

      O Gateway é responsável pelo agendamento das tarefas. Se ele não estiver em execução ou apresentar anomalias, nenhuma tarefa agendada será acionada.

    4. Verifique o fuso horário do servidor.

      Os horários de execução dependem do fuso horário do servidor. Se o fuso horário for diferente do esperado, as tarefas serão executadas no horário errado e parecerão não ter rodado.

    5. Visualize o histórico de execuções.

      smcclaw cron runs --id <jobId>

    Como adicionar o smcclaw ao PATH do sistema no Windows?

    Adicione o caminho do executável smcclaw à variável de ambiente PATH para chamá-lo globalmente pela linha de comando. O exemplo a seguir

    utiliza o Windows Server 2022.

    1. Clique com o botão direito no ícone image.png e selecione System.

    2. Pesquise e abra View advanced system settings no painel de navegação à esquerda.

    3. Na aba Advanced da janela System Properties, clique em Environment Variables.

    4. Em System variables, localize a variável Path. Selecione-a, clique em Edit, depois em New e adicione C:\smcclaw\smcclaw-&lt;version&gt;-win32-x64\bin.

      Substitua pelo número da versão. Por exemplo, 2026.9.5.

    5. Teste se a variável de ambiente foi configurada corretamente.

      • Clique com o botão direito no ícone image.png e selecione Run. Insira PowerShell para abrir uma nova janela do PowerShell.

      • Execute smcclaw --version. Se a versão da ferramenta aparecer, a variável de ambiente está configurada corretamente.

    Tópicos relacionados