← 返回 Skills 市场
1758
总下载
1
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install towns-protocol
功能描述
Use when building Towns Protocol bots - covers SDK initialization, slash commands, message handlers, reactions, interactive forms, blockchain operations, and deployment. Triggers: "towns bot", "makeTownsBot", "onSlashCommand", "onMessage", "sendInteractionRequest", "webhook", "bot deployment", "@towns-protocol/bot"
安全使用建议
This skill's instructions look like a legitimate Towns Protocol bot SDK reference, but take these precautions before installing or running it:
- Verify provenance: the skill has no homepage and an unknown source. Prefer an official repo or NPM package for @towns-protocol/bot and install only from trusted origins.
- Secrets: the SKILL.md requires APP_PRIVATE_DATA and JWT_SECRET. Treat these as sensitive: store them in a secrets manager, do not paste them into public places, and rotate them if exposed. Confirm APP_PRIVATE_DATA was issued by the official Towns developer portal.
- Minimize RPC key scope: use a dedicated RPC key (BASE_RPC_URL) with minimal privileges and rate limits. For read-only operations use a read-only key when possible; keep the funded gas wallet separate and funded with minimal ETH required for operations.
- Isolate runtime: run the bot in a sandboxed environment (separate VM/container) and avoid exposing debug endpoints in production. The health endpoint prints the gas wallet address — consider removing or restricting access to that endpoint.
- Audit logging and attachments: the docs suggest logging message content and reading local files for attachments; ensure logs do not capture PII and attachments are validated before upload.
- Confirm declared requirements: the registry metadata claims no env vars but the docs do — ask the publisher to correct metadata or provide the official package source. If you cannot verify the publisher, do not provide secrets to the skill.
- Code review: because this is instruction-only here, request or review the actual @towns-protocol/bot SDK source and any bot code you intend to run. Pin package versions and audit dependencies.
If you cannot confirm the skill's origin or reconcile the missing metadata, treat it as untrusted and avoid supplying APP_PRIVATE_DATA and JWT_SECRET to any code derived from this skill.
功能分析
Type: OpenClaw Skill
Name: towns-protocol
Version: 2.0.0
The skill bundle provides comprehensive documentation and code examples for building a Towns Protocol bot, covering SDK usage, blockchain operations, messaging, interactive components, debugging, and deployment. It consistently promotes good security practices, such as verifying blockchain transactions on-chain before granting access. All code snippets and instructions are aligned with the stated purpose, using standard libraries and tools without any evidence of data exfiltration, malicious execution, persistence, or harmful prompt injection attempts against the agent. The use of environment variables is for bot configuration, and file access examples (e.g., `readFileSync` in `references/MESSAGING.md`) are for legitimate bot functionalities like sending attachments, not for arbitrary file access or exfiltration.
能力评估
Purpose & Capability
The SKILL.md and reference files consistently describe Towns Protocol bot capabilities (handlers, blockchain ops, interactions, deployment). The required capabilities (blockchain RPC, Bun, @towns-protocol/bot SDK) align with the described purpose. However the registry metadata declares no required env vars or primary credential while the runtime docs explicitly require APP_PRIVATE_DATA and JWT_SECRET (and recommend BASE_RPC_URL), creating an inconsistency between declared metadata and actual runtime needs.
Instruction Scope
Runtime instructions stay within the scope of building and deploying bots (message handling, interaction requests, verifying tx receipts, webhooks, deployment, debugging). They do instruct reading local files for chunked attachments, logging incoming messages, and exposing a health endpoint that prints the gas wallet address — these are reasonable for bot dev but can expose PII or wallet addresses if left enabled in production. There are no explicit instructions to read unrelated system secrets or exfiltrate data to unknown endpoints.
Install Mechanism
This is an instruction-only skill with no install spec and no code files to execute on install, which reduces installation risk. The SKILL.md assumes external dependencies (Bun runtime, @towns-protocol/bot SDK) but does not provide an automated installer — that is consistent with an instruction-only reference.
Credentials
The documentation requires sensitive environment values (APP_PRIVATE_DATA — base64 app credentials from app.towns.com; JWT_SECRET — min 32 chars; BASE_RPC_URL / RPC key; optional DATABASE_URL). The registry metadata however lists no required env vars or primary credential. Requiring APP_PRIVATE_DATA and JWT_SECRET is proportionate to a bot that authenticates to the Towns developer platform, but the omission from declared metadata and the unknown skill source are red flags. Also the guidance to log message contents and expose gasWallet in health endpoints can leak sensitive data.
Persistence & Privilege
The skill does not request always:true, does not modify other skills, and is user-invocable only. There is no claim of persistent platform-level privileges; autonomous invocation is allowed (platform default) but not combined here with other high-risk indicators.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install towns-protocol - 安装完成后,直接呼叫该 Skill 的名称或使用
/towns-protocol触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v2.0.0
towns-protocol v2.0.0 changelog
- Major documentation overhaul: new unified SKILL.md focused on SDK usage for bot development on Towns Protocol.
- Added critical rules section to clarify address formats, wallet separation, permission handling, and transaction best practices.
- Expanded quick reference with handler method signatures, bot properties, and code import examples.
- Included detailed setup, environment, and config validation guides for Bun and Base network.
- Documented all main event handlers (onMessage, onSlashCommand, onReaction, onTip, onInteractionResponse) with practical code samples.
- Listed common developer mistakes with troubleshooting fixes.
- Resources and documentation links updated for developer ease-of-use.
元数据
常见问题
Towns Protocol Skills 是什么?
Use when building Towns Protocol bots - covers SDK initialization, slash commands, message handlers, reactions, interactive forms, blockchain operations, and deployment. Triggers: "towns bot", "makeTownsBot", "onSlashCommand", "onMessage", "sendInteractionRequest", "webhook", "bot deployment", "@towns-protocol/bot". 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 1758 次。
如何安装 Towns Protocol Skills?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install towns-protocol」即可一键安装,无需额外配置。
Towns Protocol Skills 是免费的吗?
是的,Towns Protocol Skills 完全免费(开源免费),可自由下载、安装和使用。
Towns Protocol Skills 支持哪些平台?
Towns Protocol Skills 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Towns Protocol Skills?
由 andriy(@andreyz)开发并维护,当前版本 v2.0.0。
推荐 Skills