bots

Build and deploy Towns Protocol bots using the @towns-protocol/bot SDK.

Updated Jan 5, 2026
One-click install
npx skills add https://github.com/towns-protocol/skills --skill bots
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bots
Source: https://github.com/towns-protocol/skills/tree/main/skills/bots
Command: npx skills add https://github.com/towns-protocol/skills --skill bots

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a complete toolkit for building and deploying Towns Protocol bots, consolidating SDK access, event handling, and deployment guidance to reduce boilerplate and accelerate bot development.

Core Features & Use Cases

  • SDK initialization and configuration for Towns bots
  • Event handlers for messages, slash commands, reactions, and tips
  • Messaging API and interactive components (forms, transactions)
  • Blockchain operations and contract interactions
  • Deployment and local development workflows

Quick Start

Install the Towns Bot project scaffold and start a new bot: bunx towns-bot init my-bot cd my-bot bun install

Then customize the generated template and run the local dev server to begin testing. Ensure Bun runtime is installed and a Base RPC URL is configured.

Frequently Asked Questions about bots

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build and deploy a Towns Protocol bot?

You can build a Towns Protocol bot by running the bunx towns-bot init scaffold command, customizing the template, and deploying it via local or cloud workflows using the @towns-protocol/bot SDK.

What do I need to configure before developing a Towns bot?

Before developing a Towns bot, you need to install the Bun runtime, configure a Base RPC URL for blockchain interactions, and set up the @towns-protocol/bot SDK to handle messages and slash commands.

Can a Towns Protocol bot respond to blockchain events and slash commands?

Yes, Towns Protocol bots can respond to blockchain events and slash commands. The SDK provides event handlers for messages, reactions, tips, and blockchain operations across local and cloud environments.

Does Towns bot development require a specific runtime environment?

Yes, Towns bot development requires the Bun runtime. You must install Bun to execute the project scaffold, run bun install, and start the local development server for testing bot event handlers.

What is the best way to handle messages and transactions in a Towns bot?

The best way to handle messages and transactions in a Towns bot is using the SDK's messaging API and interactive components. These provide built-in event handlers for forms, transactions, and blockchain contract interactions.