Casper Blockchain OpenClaw Plugin

Skill-based OpenClaw plugin for the Casper Network. 32 tools cover read queries, on-chain writes, and local monitoring alerts. See FEATURES.md for the full capability matrix.

Architecture

plugin-casper-openclaw/
├── src/                     # Runtime: tools + RPC client
│   ├── index.ts             # definePluginEntry registration
│   ├── tools/query.ts       # Read-only chain tools
│   └── tools/transfer.ts    # Optional signed transfer tool
├── skills/
│   ├── casper-query/        # Read workflows + reference
│   └── casper-transfer/     # Transfer safety + slash dispatch
└── openclaw.plugin.json     # Manifest + skills root

| Layer | Responsibility | | --- | --- | | Skills (SKILL.md) | Routing tables, workflows, safety checks, slash commands | | Tools (src/tools/*) | Deterministic RPC calls and transaction signing | | Manifest | Tool ownership, config schema, bundled skill paths |

Bundled skills

| Skill | Purpose | | --- | --- | | casper-query | Balance, account, block, deploy, validator, and status queries | | casper-transfer | Confirmed CSPR transfers; gated on configured private key |

Skills load when the plugin is enabled. See OpenClaw skills docs.

Tools (v0.3.0)

| Category | Count | Examples | | --- | --- | --- | | Read queries | 23 | casper_get_balance, casper_query_global_state, casper_get_validators | | Write (optional) | 9 | casper_transfer_cspr, casper_staking_delegate, casper_contract_call |

Contract-heavy features (CEP-18/47/78, DeFi, governance, counter, RWA, DEX) use casper_contract_call with standard entry points documented in FEATURES.md.

Configuration

{
  plugins: {
    entries: {
      casper: {
        enabled: true,
        config: {
          rpcUrl: "https://node.mainnet.casper.network/rpc",
          chainName: "casper",
          privateKeyHex: "YOUR_PRIVATE_KEY_HEX",
          privateKeyAlgorithm: "secp256k1",
        },
      },
    },
  },
  tools: {
    allow: ["casper_transfer_cspr"],
  },
  agents: {
    defaults: {
      skills: ["casper-query", "casper-transfer"],
    },
  },
}

Common RPC endpoints:

• Mainnet: https://node.mainnet.casper.network/rpc
• Testnet: https://node.testnet.casper.network/rpc

Keep private keys in plugin config or a secret store. Do not paste them into agent prompts.

Install

openclaw plugins install .

After install, restart the gateway or start a new session so bundled skills appear in the agent prompt.

Build

npm install
npm run plugin:build
npm run plugin:validate
npm test

详细手工与集成测试步骤见 TEST.md。

Example prompts

• "Check the CSPR balance for public key 02... on Casper mainnet."
• "Look up deploy hash 3fac... and summarize the execution result."
• "Transfer 1.5 CSPR to recipient public key 01...." (requires transfer skill, tool allowlist, and configured private key)

Security

• Query skill + tools are safe for default exposure.
• Transfer skill is gated on privateKeyHex and the tool remains optional.
• Review plugin and skill source before installing third-party packages.

License

Apache-2.0