Towns协议机器人开发

技能简介

Towns Protocol Bot SDK是一套用于构建去中心化聊天机器人的开发工具，基于Bun运行时和Base区块链网络，支持斜杠命令、消息处理、交互表单和链上操作。

能做什么

• 初始化机器人并注册斜杠命令
• 处理频道消息和提及事件
• 发送消息、编辑消息、添加表情反应
• 创建交互式表单和交易请求
• 执行链上合约读写操作
• 验证交易状态和用户权限

使用说明

安装步骤：

1. 确保已安装Bun运行时
2. 执行初始化命令：bunx towns-bot init my-bot
3. 进入项目目录：cd my-bot
4. 安装依赖：bun install

环境配置：

APP_PRIVATE_DATA=<base64_credentials>
JWT_SECRET=<webhook_secret>
PORT=3000
BASE_RPC_URL=https://base-mainnet.g.alchemy.com/v2/KEY

基础代码模板：

import { makeTownsBot } from '@towns-protocol/bot'
const bot = await makeTownsBot(
  process.env.APP_PRIVATE_DATA!,
  process.env.JWT_SECRET!,
  { commands: [{ name: 'ping', description: 'Check if alive' }] }
)
bot.onSlashCommand('ping', async (handler, event) => {
  await handler.sendMessage(event.channelId, 'Pong!')
})
export default bot.start()

输入与输出

见下方输入与输出表格。

风险提示

• Gas钱包必须预先充值Base ETH，否则交易失败
• 用户ID为以太坊地址格式，不可使用用户名
• 斜杠命令与普通消息互斥触发，需分别处理
• 交易哈希不代表成功，必须验证receipt.status
• 提及消息需同时使用文本格式和mentions数组

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/andreyz/towns-protocol/SKILL.md
来源类型：GitHub开源项目