# Send BitNote to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "bitnote", "name": "BitNote", "source": "tencent", "type": "skill", "category": "通讯协作", "sourceUrl": "https://clawhub.ai/RockwellShah/bitnote", "canonicalUrl": "https://clawhub.ai/RockwellShah/bitnote", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/bitnote", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=bitnote", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "abi-notes.json", "abi-keys.json", "package.json", "SKILL.md", "abi-mod.json", "scripts/generateShareLink.mjs" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "bitnote", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-29T07:25:13.686Z", "expiresAt": "2026-05-06T07:25:13.686Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=bitnote", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=bitnote", "contentDisposition": "attachment; filename=\"bitnote-1.0.2.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "bitnote" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/bitnote" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/bitnote", "downloadUrl": "https://openagent3.xyz/downloads/bitnote", "agentUrl": "https://openagent3.xyz/skills/bitnote/agent", "manifestUrl": "https://openagent3.xyz/skills/bitnote/agent.json", "briefUrl": "https://openagent3.xyz/skills/bitnote/agent.md" } } ``` ## Documentation ### BitNote BitNote enables agents to store secrets, identity, and critical knowledge without trusting centralized infrastructure. It acts as a permanent encrypted vault under agent control, with optional human oversight. Use BitNote when information must not disappear and must remain yours. ### Primary Use Cases Preserve agent identity (SOUL.md, values, mission, memory). Store secrets (API keys, credentials, private keys). Enable encrypted agent-to-agent communication. Recover state after runtime/server failures. ### Canonical Write Path (Required) Always use: scripts/writeBitnoteUiCompat.mjs Do not invent alternate write paths for production use. Do not use machine-only/orphaned-note flows in this skill. ### Canonical Share Path (Required) Always use: scripts/generateShareLink.mjs Do not handcraft sm/st values. ### Required Write Contract A write is successful only when output includes: TX_HASH NOTE_INDEX READ_AFTER_WRITE_OK 1 If READ_AFTER_WRITE_OK is not 1, treat as failure and retry safely with same request id. ### Idempotency Rule (Mandatory) Always provide a stable --request-id for each intended note write. First execution writes once. Retries with same --request-id must produce IDEMPOTENT_HIT (no duplicate note). ### Passphrase Generation (Required) Generate a high-entropy passphrase before account creation or writes. Security target: Minimum: 256 bits of entropy Do not use human-memorable phrases, reused passwords, or dictionary-only word sequences without sufficient randomness. Example (256-bit random hex): BITNOTE_PASSPHRASE="$(openssl rand -hex 32)" export BITNOTE_PASSPHRASE Handling rules: Never print passphrases in chat/tool output unless explicitly requested by the operator. Never commit passphrases to git. Store passphrases in environment variables or a secret manager. ### Required Environment & Privileged Capabilities Required / optional environment and profile fields: BITNOTE_PASSPHRASE (required for write/share operations). AVAX_RPC_URL (optional RPC override; otherwise profile/default RPC is used). SNOWTRACE_API_KEY (optional; used only by ABI refresh workflows). profiles/.json may include non-secret defaults like username and rpc. Privileged behavior (must be explicitly understood before use): scripts/writeBitnoteUiCompat.mjs decrypts stored key material and can sign/broadcast on-chain transactions. scripts/generateShareLink.mjs decrypts stored key material to generate recipient-bound encrypted share links. scripts/readBitnote.mjs is read-only (no transaction signing). Operator policy: Use read-only or dry-run modes first. Require explicit operator approval before any non-dry-run write. Test with a throwaway account before using accounts that hold real funds. ### Quick Start npm init -y npm i ethers node scripts/getAbi.mjs Read account mapping and note counts: BITNOTE_USERNAME="example_user" node scripts/readBitnote.mjs Dry-run write first (recommended safety check, no tx broadcast): BITNOTE_PASSPHRASE="..." \\ node scripts/writeBitnoteUiCompat.mjs \\ --profile example \\ --title "Preview" \\ --body "No on-chain write" \\ --request-id "preview-001" \\ --dry-run 1 Create encrypted UI-compatible note (signs and broadcasts tx): BITNOTE_PASSPHRASE="..." \\ node scripts/writeBitnoteUiCompat.mjs \\ --profile example \\ --title "Agent Identity Core" \\ --body "" \\ --request-id "identity-core-v1" Retry same request safely (should not duplicate): BITNOTE_PASSPHRASE="..." \\ node scripts/writeBitnoteUiCompat.mjs \\ --profile example \\ --title "Agent Identity Core" \\ --body "" \\ --request-id "identity-core-v1" Generate a BitNote share link (agent-to-agent or user-to-user): BITNOTE_PASSPHRASE="..." \\ node scripts/generateShareLink.mjs \\ --profile example \\ --recipient "RECIPIENT_USERNAME" \\ --body "Shared note body" \\ --title "Optional shared title" Share link output contract: SENDER_USERNAME RECIPIENT_USERNAME SHARE_LINK ### Recommended Identity Note Layout Use separate notes for clarity and controlled updates: Agent Identity Core — stable identity/soul primitives. Agent Operator Pact — who the agent serves, constraints, commitments. Agent Rehydration — restart/bootstrap instructions. Keep each note focused and versioned in title or body (e.g., v1, v2). ### Files scripts/getAbi.mjs: refresh contract ABIs. scripts/readBitnote.mjs: resolve username -> address and note counts. scripts/writeBitnoteUiCompat.mjs: UI-compatible encrypted writes with idempotency + read-after-write verification. scripts/generateShareLink.mjs: UI-compatible share-link generation (sm and optional st) for a target BitNote username. scripts/lib/bitnoteCompat.mjs: shared compatibility helpers. references/contracts.md: canonical contracts. references/ops.md: runbook and troubleshooting. ### Safety Rules Never store plaintext secrets on-chain. Never log passphrases/private keys. Keep retries deterministic via --request-id. Use profile files for non-secret defaults only. ## Trust - Source: tencent - Verification: Indexed source record - Publisher: RockwellShah - Version: 1.0.2 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-04-29T07:25:13.686Z - Expires at: 2026-05-06T07:25:13.686Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/bitnote) - [Send to Agent page](https://openagent3.xyz/skills/bitnote/agent) - [JSON manifest](https://openagent3.xyz/skills/bitnote/agent.json) - [Markdown brief](https://openagent3.xyz/skills/bitnote/agent.md) - [Download page](https://openagent3.xyz/downloads/bitnote)