convez.ai
AgenteAutomaçãoIntermediário
gargantuan-bibliothec390

claudeclaw - Agentes Multi-Claude com Telegram/Discord

gargantuan-bibliothec390/claudeclaw

Agentes Claude persistentes com Telegram/Discord e memória de sessão

Ver no GitHub
InicialPluginScore · de 0 a 100

Framework 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/claudeclaw

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 1 mês
Versão
—
Issues abertas
0
Contribuidores
2

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

Download claudeclaw

🚀 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:

  1. Find the download option on the repository page.
  2. Save the files to a folder on your Windows PC.
  3. If the download comes in a ZIP file, right-click it and choose Extract All.
  4. Open the extracted folder.
  5. Look for a setup file, project file, or README file with run steps.
  6. Follow the on-screen prompts if the project includes an installer.
  7. 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:

  1. Download the project from the link above.
  2. Extract the files if needed.
  3. Open the folder in File Explorer.
  4. Read any setup file included in the project.
  5. Run the main app or startup script.
  6. Sign in to Telegram or Discord if the setup asks for it.
  7. 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 files
  • config/ for settings
  • agents/ for agent prompts or agent roles
  • logs/ for run history
  • sessions/ for saved state
  • scripts/ 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:

  1. Open the app or project folder.
  2. Start the main process.
  3. Send a short message from Telegram or Discord.
  4. Check that the reply comes back.
  5. Confirm that the task log updates.
  6. 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:

  • .exe for a Windows app
  • .bat for a Windows batch script
  • .zip for a compressed download
  • .json for settings
  • .md for instructions
  • .env for 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

  1. Open the project page
  2. Download the files
  3. Extract them on Windows
  4. Find the run instructions
  5. Start the main app
  6. Connect Telegram or Discord
  7. Send a test message

Open claudeclaw on GitHub

🗂️ 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:

  1. Download from the project link
  2. Extract the files
  3. Read the included instructions
  4. Start the app
  5. Connect Telegram or Discord
  6. Send a test command
  7. Keep the app running while you use it
Ver o original no GitHub

Bom para

Relacionados