Crie um bot do DingTalk
Selecione ou crie uma organização
Acesse a DingTalk Open Platform. Ao selecionar uma organização, escolha aquela em que você tem permissões de desenvolvedor. Alternativamente, selecione uma organização e obtenha permissões de desenvolvedor.
-
Se não houver organizações disponíveis, escaneie o código QR abaixo com o aplicativo móvel do DingTalk para criar uma organização.
O aplicativo móvel do DingTalk deve estar na versão 6.5.45 ou superior.
Crie um bot OpenClaw com um clique
Acesse a DingTalk Open Platform. Na lista de aplicativos do DingTalk no console do desenvolvedor, localize o banner com a mensagem Automatically create an OpenClaw bot application with one click and start your intelligent collaboration journey e clique em Create Now.
-
A plataforma preenche automaticamente as informações do bot OpenClaw. Modifique a configuração conforme as necessidades do seu negócio e clique em OK para criar o aplicativo.
Se você planeja criar vários aplicativos, altere o nome ou o ícone do bot durante a criação para diferenciá-los facilmente depois.
-
Após criar o aplicativo, copie e salve o Client ID (AppKey) e o Client Secret (AppSecret).
Se fechar a caixa de diálogo, você ainda poderá encontrar o Client ID e o Client Secret abrindo o aplicativo criado e selecionando credentials and basic information no painel de navegação à esquerda.
Bot personalizado
Crie um aplicativo: No console do desenvolvedor, clique em Create App. Insira o App Name e a App Description, faça upload de um ícone para o aplicativo e salve.
Adicione um bot: Na página de detalhes do aplicativo, clique em Add App Capability no painel de navegação à esquerda e selecione Add bot.
Configure o bot: Na página de detalhes do bot, defina as informações, como nome, ícone, perfil e descrição. Certifique-se de que o modo de recebimento de mensagens esteja definido como stream mode. Ao terminar, clique em Publish.
-
Configure as permissões: Clique em permission management no painel de navegação à esquerda. O aplicativo deve ter pelo menos as seguintes permissões. Adicione outras conforme necessário:
Permissão básica necessária para chamar a API SNS (snsapi_base)
Permissão básica necessária para chamar a API empresarial (qyapi_base)
Permissão para bots da organização enviarem mensagens (qyapi_robot_sendmsg)
Permissão de escrita para instâncias de cartões interativos (Card.Instance.Write)
Permissão de atualização via streaming para cartões de IA (Card.Streaming.Write)
Configure o modo de assinatura de eventos: Clique em event subscription no painel de navegação à esquerda. No gerenciamento de assinaturas, defina o Push Mode como stream mode.
Publique o aplicativo: Clique em version management and release no painel de navegação à esquerda, crie uma versão e publique o aplicativo.
Configure uma instância DataClaw no console do DataWorks
Retorne ao console do DataWorks e crie uma instância do serviço AI Assistant. Para mais informações, consulte o Guia de configuração do serviço AI Assistant.
Teste o bot
Crie um grupo de chat ou adicione o bot a um grupo existente e mencione @bot no grupo do DingTalk para iniciar uma conversa. Você também pode pesquisar o bot para iniciar um chat privado e testá-lo.
Group chat
Acesse a página Group Settings do grupo no DingTalk e clique na área do cartão Bot. Na página Bot Management, clique em Add Bot. Na caixa de texto Search da janela Add Bot, insira o nome do bot desejado e selecione-o na lista. Clique em Add e, em seguida, em Finish.
No grupo do DingTalk, mencione @bot para interagir com ele. Outra opção é pesquisar o nome do bot na barra de pesquisa do DingTalk, localizá-lo na página de resultados e iniciar um chat privado.
Private chat
Pesquise o nome do bot na barra de pesquisa na parte superior do DingTalk e clique no avatar do bot para iniciar um chat privado.
Na página de chat privado, interaja diretamente com o bot.
Outros
Se estiver usando uma versão não comercial do DingTalk, atente-se às seguintes configurações do bot para evitar problemas:
Tanto o Message Receiving Mode do bot quanto o Push Mode em Event Subscription > Standard Subscription devem estar definidos como stream mode.
Não configure uma lista de permissões nas Security Settings do aplicativo DingTalk.
Verifique se o aplicativo DingTalk tem a Write permission for interactive card instances e a Streaming update permission for AI cards.