什么是 Crunch Protocol CLI 技能？

Crunch Protocol CLI 技能充当了人类语言与 Crunch Protocol 生态系统技术命令之间的高级桥梁。通过利用 Openclaw Skills，开发人员和协调者可以管理“crunch”的整个生命周期——从创建和奖励存入到检查点管理——而无需手动构建复杂的 CLI 字符串。它通过将对话短语直接映射到底层的 crunch-cli 工具，简化了区块链交互。

该技能旨在通过本地配置文件处理特定环境的配置来提高生产力。无论您是在 Solana 主网上操作还是在测试网上进行测试，您的 Openclaw Skills 库中的这一新增功能都能确保自动处理浅包路径、RPC URL 和多签地址，从而以开发者友好的方式无缝执行管理和运营任务。

下载入口:https://github.com/openclaw/skills/tree/main/skills/philippwassibauer/crunch-protocol-skill

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

Crunch Protocol CLI 技能 应用场景

• 通过“显示 crunch Synth”等简单查询坚控竞赛状态和奖池。
• 在不同的网络环境中管理协调者配置和证书更新。
• 在竞赛结束期间自动分配奖励并清理代币账户。
• 提供专门为 Slack 和 Discord 等团队沟通工具格式化的实时竞赛更新。
• 在无需手动输入标志的情况下，为去中心化财库管理提议多签交易。

1. 用户输入自然语言命令，例如“列出 devnet 的 crunches”。
2. 技能识别动作和目标，然后引用本地 profiles.json 以查找匹配的网络配置。
3. 它根据解析出的配置文件自动添加必要的 RPC URL、浅包路径和多签地址。
4. 使用高速直接映射表将请求映射到特定的 crunch-cli 命令。
5. 命令在系统 shell 中执行，并与 Crunch Protocol 智能合约交互。
6. 捕获原始 CLI 输出，并将其重新格式化为用户要求的介质（如 T@elegrimm、Discord 或纯文本）后返回。

Crunch Protocol CLI 技能 配置指南

要在您的 Openclaw Skills 环境中使用此技能，请先确保您的系统已全局安装官方 CLI：

npm install -g @crunchdao/crunch-cli

通过检查版本来验证安装：

crunch-cli --version

您还必须在技能目录中配置 profiles.json 文件，以便将您的 Solana 浅包和 RPC 端点映射到易于使用的别名。

Crunch Protocol CLI 技能 数据架构与分类体系

该技能通过基于 JSON 的配置文件系统管理持久化配置。这使得 Openclaw Skills 能够在不同的区块链环境中保持上下文。

name: crunch-protocol-skill
description: Natural language interface for Crunch Protocol CLI. Maps user requests to CLI commands for managing coordinators, competitions (crunches), rewards, and checkpoints. Supports output formatting for Slack, T@elegrimm, Discord, or plain text.

Crunch Protocol CLI Skill

This skill translates natural language queries into crunch-cli CLI commands and formats outputs for various mediums.

Setup

Ensure the CLI is installed globally:

npm install -g @crunchdao/crunch-cli

Verify installation:

crunch-cli --version

Profiles

Profiles are stored in profiles.json (next to this file). Each profile maps a short name to a set of CLI flags so users can say things like "list crunches for m-jeremy" instead of typing full addresses every time.

Profile file format

{
  "profiles": {
    "m-jeremy": {
      "url": "https://mainnet.helius-rpc.com/?api-key=...",
      "wallet": "/path/to/keypair.json",
      "multisigAddress": "9WzDXwBbmkg8...",
      "coordinatorWallet": "5abc..."
    },
    "devnet": {
      "url": "devnet",
      "wallet": "/path/to/dev-keypair.json",
      "coordinatorWallet": ""
    }
  }
}

Profile fields → CLI flags

How to resolve a profile

When a user references a profile name:

1. Read profiles.json from the skill directory.
2. Look up the profile by name (case-insensitive match).
3. Map each non-empty field to its CLI flag (see table above).
4. Prepend the flags to whatever command is being built.

Example: User says "list crunches for m-jeremy"

1. Load profile mainnet-proposer → { url: "https://mainnet...", wallet: "/path/...", multisigAddress: "9WzDX..." }
2. Build: crunch-cli -u "https://mainnet..." -w "/path/..." -m "9WzDX..." crunches list

Example: User says "show coordinator for devnet"

1. Load profile devnet → { url: "devnet" }
2. Build: crunch-cli -u devnet coordinator get

Managing profiles

• Users can ask to add, update, or remove profiles. When they do, read the current profiles.json, apply the change, and write it back.
• If profiles.json doesn't exist yet, create it with the structure above.
• When a user says "set profile to m-jeremy" or "use profile m-jeremy", remember it for the rest of the conversation and apply those flags to all subsequent commands automatically.

Command Mapping Rules

IMPORTANT: Direct Phrase Mapping

For speed and consistency, map these phrases directly to CLI commands without LLM interpretation:

Name Extraction Rules

• When a crunch name is provided, wrap it in quotes in the CLI command
• Common competition names: Crunch, Competition, Tournament, Challenge

Execution Pattern

1. Parse the user request to identify:

   • The action (get, create, start, end, list, etc.)
   • The target (crunch, coordinator, checkpoint, etc.)
   • The name/identifier if applicable
   • Any additional parameters

2. Map to CLI command using the direct mapping table above

3. Execute the command:

   crunch-cli [options]  [arguments]
   

4. Format The output of the CLI should be kept as close as possible, except if the user told you to post process the data. But map the output for the specified medium (see Output Formatting below as reference to use)

Available Commands Reference

Coordinator Commands

Certificate Commands

Crunch Commands (Competition Management)

Checkpoint Commands

Global Options

• -u, --url - Network: mainnet-beta, devnet, localhost (default: from config)
• -w, --wallet - Wallet keypair file path
• -o, --output json - Output as JSON (useful for parsing)
• -m, --multisig - Create multisig proposal instead of direct execution

Output Formatting

Medium Detection

Detect output medium from user request:

• "for slack" / "slack format" → Slack
• "for telegram" / "telegram format" → T@elegrimm
• "for discord" / "discord format" → Discord
• Default → Plain text / Markdown

Slack Format

*?? Crunch: Synth*
━━━━━━━━━━━━━━━━━
? *Status:* Active
? *Participants:* 142
? *Prize Pool:* 10,000 USDC
? *Checkpoint:* 5
* *Funds:* 3000USDC

T@elegrimm Format

?? Crunch: Synth

?? Status: Active
?? Participants: 142  
?? Prize Pool: 10,000 USDC
?? Checkpoint: 5
?? Funds: 3000USDC

Discord Format

## ?? Crunch: Synth
**Status:** Active
**Participants:** 142
**Prize Pool:** 10,000 USDC
**Checkpoint:** 5

Plain Text / Default

Crunch: Synth
Status: Active
Participants: 142
Prize Pool: 10,000 USDC
Checkpoint: 5
Funds: 3000USDC

Error Handling

If a command fails:

1. Show user-friendly error message
2. Suggest possible fixes:
   • Wrong network? Add -u devnet or -u mainnet-beta
   • Missing wallet? Add -w /path/to/wallet.json
   • Crunch not found? List available crunches with crunches list

Example Workflows

"Get me info about crunch Synth"

crunch-cli crunch get "Synth"

"Show my coordinator on mainnet"

crunch-cli -u mainnet-beta coordinator get

"List all crunches for slack"

crunch-cli crunches list

Then format output for Slack.

"What's the current checkpoint for the Chaos competition?"

crunch-cli crunch checkpoint-get-current "Chaos"

Reference Documentation

For full CLI documentation, see references/cli-reference.md.