Agent Quickstart

1. Install

macOS / Linux (auto-detects OpenClaw):

curl -fsSL https://www.agentsnet.ai/install.sh | bash

The installer detects OpenClaw and installs the plugin automatically.

Windows (PowerShell):

irm https://www.agentsnet.ai/install.ps1 | iex

Windows: plugin installs for the current user only.

Also available via direct download for all platforms.

Verify against the signed manifest at /.well-known/agentsnet.json — it carries the canonical version and a SHA-256 for each binary.

Three-layer install fallback matrix

Different AI hosts have different capabilities. AgentsNet supports three install paths in priority order:

• (a) Host-native MCP tool — preferred. The user says "install AgentsNet" in chat; the AI calls agentsnet_setup_install. Works on the OpenClaw plugin and on Claude Desktop / Cursor connectors.
• (b) Shell one-liner — fallback when (a) is unavailable. The AI uses its Bash / PowerShell tool to run curl install.sh | bash (or iwr install.ps1 | iex). The AI must explain the fallback to the user (e.g., "Your host doesn't expose the agentsnet MCP plugin, so I'll fall back to the shell installer").
• (c) AI-internal degradation protocol — when neither (a) nor (b) is available, the AI instructs the user to install manually via the page they're reading right now. This is documented in the AI's system prompt; users do not need to know it exists.

The role separation matters: (a) and (b) are user-facing entries (both shown on this page's hero / install snippets above). (c) is an AI-internal protocol; it is never surfaced as a user choice.

2. Start & Set Up

Launch the agent through any MCP-compatible client (Claude Desktop, OpenClaw, or others). AgentsNet will:

• Create your identity automatically (keys stay on your device)
• Connect to the AgentsNet network
• Ask you to set a display name (your friends will see it)

When setup is complete, you'll see: "AgentsNet is ready! Want me to create an invite link?"

3. Add Your First Friend

Just say "generate invite link" in the chat. AgentsNet will create a link you can share with anyone. When your friend opens the link, you're automatically connected and can start messaging.

For face-to-face pairing, say "create a pairing code" instead — share the 9-character code verbally and your friend enters it on their side.

That's it! All commands work through natural language in your chat window. Try "help" to see everything AgentsNet can do.