AstrBot: plataforma de acesso a chatbot de IA com WebUI

Introdução geral

AstrBot é uma estrutura de desenvolvimento de chatbot de código aberto, compatível com QQ, Telegram, WeChat e outras plataformas de mensagens, e pode acessar facilmente OpenAI, DeepSeek, Google Gêmeos O AstrBot é uma estrutura para o desenvolvimento de chatbots inteligentes, como o Large Language Model (LLM). A estrutura oferece um sistema de plug-in, um painel de gerenciamento visual e recursos multimodais, como compreensão de imagem e conversão de fala em texto. O AstrBot foi projetado para permitir que os usuários criem rapidamente chatbots inteligentes e é adequado para desenvolvedores e entusiastas de tecnologia. Ele usa a licença AGPL-v3, tem código aberto e uma comunidade ativa.

Lista de funções

• Suporta acesso a mensagens em várias plataformas, incluindo QQ, QQ Channel, Telegram, WeChat (WeChat pessoal e empresarial), Flybook, Nail e muito mais.
• Integrar vários modelos de linguagem grandes, como OpenAI, Google Gemini, DeepSeek, Claude, Ollama, etc., e oferecer suporte a modelos locais.
• Oferece várias rodadas de diálogo com personalidades configuráveis, suporte para compreensão de imagens e conversão de fala em texto (com base no Whisper).
• Painel de administração visual integrado para configuração de bots, visualização de registros e gerenciamento de plug-ins.
• As extensões de plug-in são compatíveis e os usuários podem desenvolver funções personalizadas, como check-in ou execução de código.
• Oferece funcionalidade de agente, incluindo pesquisa na Web, lista de tarefas em linguagem natural e encaixe Dify Plataforma.
• Inclui gerenciamento de segurança de conteúdo, como filtragem de palavras-chave e auditoria de conteúdo do Baidu.
• A WebUI é fornecida para que os usuários possam conversar com o robô diretamente por meio da página da Web.

Usando a Ajuda

O processo de instalação e uso do AstrBot é claro, a documentação oficial fornece uma variedade de métodos de implantação. A seguir, uma descrição detalhada das etapas de instalação e dos principais recursos da operação.

Processo de instalação

O AstrBot oferece suporte à implantação de código-fonte, implantação do Docker, instalação com um clique no Windows, implantação do painel Pagoda e assim por diante. Aqui está um exemplo de implantação de código-fonte e implantação do Docker.

Implementação do código-fonte

1. Preparação do ambiente
   Certifique-se de que o Git e o Python 3.11+ estejam instalados; os usuários do Windows podem fazer download do Python no site oficial do Python, e os usuários do Linux podem fazer download do Python no site oficial do Python. sudo apt install python3 Instalação.
2. Código de download
   É executado no terminal:

git clone https://github.com/AstrBotDevs/AstrBot
cd AstrBot

Ou baixe o arquivo ZIP do GitHub e extraia-o.

3. Instalação de dependências
   Recomendado uv Ferramentas:

pip install uv
uv run main.py

Ou da maneira tradicional:

pip install -r requirements.txt
python main.py

4. procedimento de acionamento
   Após a execução, o terminal exibirá o endereço do painel de gerenciamento, como http://localhost:6185. Usar a conta padrão astrbot e senhas astrbot Faça o login.

Implementação do Docker

1. Instalando o Docker
   Certifique-se de que o Docker esteja instalado e disponível docker --version Verificar.
2. Extraia a imagem e execute
   Digite-o no terminal:

docker run -d -p 6185:6185 -v astrbot-data:/app/data soulter/astrbot:latest

-p 6185:6185 porta de mapeamento.-v Crie um volume de dados para salvar a configuração.

3. painel de acesso
   Abra seu navegador e digite http://localhost:6185Faça login com a senha padrão da conta.

Funções principais

Configuração do modelo do Big Language

1. Faça login no painel de administração e clique em Configurações do provedor.
2. Selecione o tipo de modelo, por exemplo openai_chat_completion.
3. Digite a chave de API (obtida de uma plataforma como a OpenAI) e o endereço (padrão). https://api.openai.com/v1).
4. Selecione o modelo específico (por exemplo gpt-3.5-turbo), salve-o e ele entrará em vigor.

Acesso multiplataforma

1. Selecione uma plataforma, como o Telegram, na opção Plataformas de mensagens no painel de administração.
2. Insira as informações necessárias (por exemplo, o Bot Token do Telegram, obtido do BotFather).
3. Salve a configuração e o bot poderá responder às mensagens na plataforma correspondente. Por exemplo, no Telegram, digite /start, o robô responderá.

Uso de plug-ins

1. Faça o download do plug-in (por exemplo, Telegram Adaptor) e coloque-o no diretório <AstrBot目录>/data/plugins.
2. Reinicie o AstrBot e o plug-in será carregado automaticamente.
3. Ative o plug-in no painel de administração e configure os parâmetros, como a definição de limites de taxa de mensagens.

capacidade multimodal

• Compreensão de imagensImagem: Envie uma imagem para o bot com um aviso (por exemplo, "Explique esta imagem") e o bot a analisará e responderá.
• conversão de voz em textoPara enviar um arquivo de voz, ative o Whisper nas Configurações do provedor e o bot o converterá em texto e responderá.

Função do agente

• Pesquisa na WebEnviar "search weather forecast" (pesquisar previsão do tempo) e o bot retornará os resultados.
• execução de códigoPara enviar um trecho de código (por exemplo, Python), você precisa ativar o executor de código em área restrita, que o bot executará e retornará o resultado.

advertência

• A implementação do servidor exige que o localhost para o IP do servidor.
• Para acessar o número pessoal do WeChat usando o Gewechat, é recomendável usar uma conta alternativa para evitar o bloqueio.
• A implantação do Docker requer mapeamento /var/run/docker.sockcaso contrário, o executor de código não estará disponível.
• A primeira execução gera um arquivo de configuração <AstrBot目录>/data/config.jsonque pode ser editado manualmente.

Com essas etapas, os usuários podem implementar e usar o AstrBot com facilidade.

cenário do aplicativo

1. Assistente pessoal
   Defina lembretes, verifique mensagens e esteja pronto para ajudar no Telegram com o AstrBot.
2. Gerenciamento de bate-papo em grupo
   No grupo QQ ou no Flybook, o robô pode responder automaticamente a perguntas, gerenciar check-ins e aumentar a eficiência.
3. Ferramentas de aprendizado
   Os alunos podem usar o AstrBot para analisar fórmulas de imagens ou transcrever anotações de voz para ajudar no aprendizado.
4. testes de desenvolvimento
   Os desenvolvedores podem testar os efeitos dos diálogos do LLM ou desenvolver novas extensões de plug-in.

QA

1. Quais plataformas já são compatíveis?
   O QQ (oficial e OneBot), o QQ Channel, o Telegram, o WeChat (WeChat pessoal e empresarial), o Flybook e o Nail já são compatíveis, enquanto o Discord e outros estão em desenvolvimento.
2. Como faço para adicionar um novo modelo?
   Adicione-o no painel de administração "Providers" (Provedores), por exemplo, digite Ollama O endereço local e o nome do modelo são suficientes.
3. E se a inicialização falhar?
   Verifique os registros do terminal, pois pode haver dependências ausentes ou portas ocupadas. Certifique-se de que requirements.txt A instalação está concluída.
4. Como os plug-ins são desenvolvidos?
   Consulte a documentação oficial <https://astrbot.app/dev/plugin.html>para colocar o código no data/plugins Reinicie depois.