Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
- Added section describing required environment variables and privileged capabilities for all operations. - Clarified which scripts have privileged access, their behaviors, and operator policy requirements. - Updated "Quick Start" to recommend dry-run writes for safety prior to on-chain broadcast. - Stated the usage of optional environment and profile fields for flexible configuration. - Emphasized the importance of explicit operator approval and caution when using real accounts.
What This Skill Does
BitNote stores encrypted notes, secrets, and agent identity on the Avalanche blockchain without relying on centralized infrastructure. Writes are idempotent, verified with read-after-write checks, and accessible only with the owner's passphrase. Agents can share encrypted notes with other agents via generated share links.
Unlike hosted secret managers or environment variables, notes are permanently stored on-chain and remain accessible even if the operator's infrastructure is destroyed or access is revoked.
When to use it
- Preserving agent identity and soul primitives across server restarts
- Storing API keys and credentials outside centralized secret managers
- Passing secrets between agents via encrypted share links
- Recovering full agent state after runtime failures
- Archiving operator constraints and commitments on-chain
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: Store my agent's identity permanently on-chain
- 1Generate a 256-bit passphrase with openssl rand -hex 32 and export as BITNOTE_PASSPHRASE
- 2Run writeBitnoteUiCompat.mjs with --dry-run 1 to verify note format without broadcasting
- 3Execute writeBitnoteUiCompat.mjs with identity content, a profile, and a stable --request-id
- 4Confirm output contains TX_HASH, NOTE_INDEX, and READ_AFTER_WRITE_OK 1
- 5Retry with the same --request-id to verify idempotency returns IDEMPOTENT_HIT
Agent identity stored as an encrypted on-chain note, retrievable by username with the correct passphrase
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.