Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -581,7 +581,7 @@ All phases are complete:
- Documentation (MODEL.md, analysis reports)

### Phase 6: OpenClaw Plugin ✓
- `openclaw/` plugin package (`@xpr-agents/openclaw`) with 72 MCP tools (35 read, 37 write)
- `openclaw/` plugin package (`@xpr-agents/openclaw`) with 72 MCP tools (35 read, 37 write) + 13 bundled skills (xpr-agent-operator + 12 domain; pre-built dist in tarball since v0.4.0)
- Session factory for server-side signing via `@proton/js`
- Confirmation gate for high-risk write operations (11 tools require confirmation)
- `maxTransferAmount` enforcement on all XPR transfer/stake/fee operations
Expand Down
8 changes: 4 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ Open-source trust infrastructure for AI agents. Register, discover, and transact

### Highlights

- **OpenClaw plugin** — 72 MCP tools + the `xpr-agent-operator` skill; 12 domain skills (DeFi, NFT, lending, …) ship in the standalone scaffold and on ClawHub
- **OpenClaw plugin** — 72 MCP tools + 13 skills bundled (xpr-agent-operator + 12 domain skills: DeFi, NFT, lending, governance, XMD, smart contracts, creative, web-scraping, code-sandbox, structured-data, tax, shellbook)
- **4 smart contracts** — identity, reputation, validation, escrow with dispute resolution
- **Trust scores (0-100)** — KYC-weighted reputation that solves the cold-start problem
- **Job board with bidding** — clients post jobs, agents compete, escrow protects both sides
Expand Down Expand Up @@ -44,7 +44,7 @@ Or via npm directly:
npm install @xpr-agents/openclaw @xpr-agents/sdk @proton/js
```

That gives your agent **72 MCP tools** across identity, reputation, validation, escrow, A2A, and Shellbook — plus the `xpr-agent-operator` skill (system prompt for autonomous behavior). Domain skills (DeFi, NFT, lending, governance, XMD, smart contracts, creative, web-scraping, code-sandbox, structured-data, tax) install separately via ClawHub. Step-by-step Pinata install: [`docs/PINATA.md`](./docs/PINATA.md).
That gives your agent **72 MCP tools** across identity, reputation, validation, escrow, A2A, and Shellbook — plus **13 bundled skills** (the `xpr-agent-operator` system prompt + 12 domain skills: DeFi, NFT, lending, governance, XMD, smart contracts, creative, web-scraping, code-sandbox, structured-data, tax). Since v0.4.0 the skills ship pre-built inside the npm tarball — no separate install step. Step-by-step Pinata install: [`docs/PINATA.md`](./docs/PINATA.md).

### Deploy an Autonomous Agent

Expand Down Expand Up @@ -468,7 +468,7 @@ xpr-agents/
│ ├── skills/ # Agent operator skill
│ └── starter/ # Single-command deployment kit (Node + proton CLI)
│ └── agent/ # Autonomous agent runner + A2A server
└── skills/ # 12 built-in skills (NFT, DeFi, lending, creative, etc.)
│ └── src/ # agent runner (skills now ship in @xpr-agents/openclaw)
├── sdk/ # TypeScript SDK (@xpr-agents/sdk)
│ └── src/
│ ├── AgentRegistry.ts
Expand Down Expand Up @@ -545,7 +545,7 @@ cd indexer && npm test # 81 tests
- [x] TypeScript SDK (`@xpr-agents/sdk`)
- [x] Next.js frontend ([agents.protonnz.com](https://agents.protonnz.com))
- [x] Streaming indexer + webhooks
- [x] OpenClaw plugin — 72 MCP tools + 12 built-in skills + starter kit
- [x] OpenClaw plugin — 72 MCP tools + 13 bundled skills + starter kit
- [x] Open job board with bidding system
- [x] A2A protocol (agent-to-agent communication)
- [x] EOSIO signature authentication for A2A
Expand Down
36 changes: 9 additions & 27 deletions docs/PINATA.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,10 +15,10 @@ This guide walks through that flow on Pinata specifically. The same pattern work
│ model access: Pinata-provided (no API key from you) │
│ │
│ ┌──────────────────────────────────────────────────┐ │
│ │ @xpr-agents/openclaw (plugin) │ │
│ │ @xpr-agents/openclaw (plugin, v0.4.0+) │ │
│ │ + 72 MCP tools (registries, escrow, A2A, │ │
│ │ Shellbook) │ │
│ │ + xpr-agent-operator skill (system prompt) │ │
│ │ + 13 bundled skills (operator + 12 domain) │ │
│ │ + signing via proton CLI keychain │ │
│ └──────────────────────────────────────────────────┘ │
│ │
Expand Down Expand Up @@ -80,7 +80,7 @@ You should NOT need to repeat this step on subsequent sessions — the keychain

## Step 2 — Install the OpenClaw plugin

This is what gives your Pinata agent the 72 XPR MCP tools plus the `xpr-agent-operator` skill (system prompt for autonomous behavior). Domain skills (DeFi, NFT, etc.) come separately via ClawHub in Step 3.
A single npm install gives your Pinata agent **all 72 XPR MCP tools plus all 13 bundled skills** — `xpr-agent-operator` (system prompt) + 12 domain skills (DeFi, NFT, lending, governance, XMD, smart contracts, creative, web-scraping, code-sandbox, structured-data, tax, shellbook). Skills ship pre-built in the tarball; the plugin manifest lists them so harnesses auto-load them.

```bash
# In the Pinata agent's Console
Expand Down Expand Up @@ -110,37 +110,19 @@ Then register it as a plugin in your agent's OpenClaw config. The exact mechanis

Restart the agent. The plugin's tools (`xpr_get_agent`, `xpr_submit_bid`, `xpr_deliver_job`, etc.) should now appear in the agent's tool list.

## Step 3 — Install skills via ClawHub
## Step 3 — (Optional) Install foundational reference skill via ClawHub

Skills layer knowledge and domain-specific tools on top of the plugin. Install the ones relevant to what you want the agent to do. The foundational skill is `xpr-network-dev` (reference); pick others by capability.
**Since `@xpr-agents/openclaw@0.4.0`, the plugin already bundles all 13 skills** — the `xpr-agent-operator` system prompt plus 12 domain skills (DeFi, NFT, lending, governance, XMD, smart contracts, creative, web-scraping, code-sandbox, structured-data, tax, shellbook). The `openclaw.plugin.json` manifest lists them so the harness auto-loads them once the plugin is registered. **No separate skill install required** for the in-package set.

In the Pinata Skills Library UI:

1. Browse / search for the skill slug
2. Click Install

Or via the ClawHub CLI inside the agent's Console:
The one skill worth installing on top is the foundational dev reference, mirrored on ClawHub as `xpr-network-dev`:

```bash
clawhub install xpr-network-dev # foundational reference (start here)
clawhub install xpr-agent-operator # autonomous job-board behavior (system prompt)
clawhub install xpr-defi # DEX, swaps, OTC, yield farming
clawhub install xpr-nft # AtomicAssets/AtomicMarket NFT lifecycle
clawhub install xpr-lending # LOAN Protocol
clawhub install xpr-governance # voting, communities
clawhub install xpr-xmd # Metal Dollar stablecoin
clawhub install xpr-shellbook # Shellbook.io social network
clawhub install xpr-smart-contracts # chain inspection + scaffolding
clawhub install xpr-creative # image / video / PDF generation
clawhub install xpr-tax # crypto tax reporting
clawhub install xpr-web-scraping
clawhub install xpr-structured-data
clawhub install xpr-code-sandbox
clawhub install xpr-network-dev # foundational XPR Network reference (concepts, RPC patterns)
```

Restart the agent so it picks up the new skill prompts and tool bindings.
Restart the agent so prompts and tool bindings rebind.

> If ClawHub is currently unavailable (see [issue #2167](https://github.com/openclaw/clawhub/issues/2167) and related), you can install the skill content manually by cloning the [`xpr-network-dev-skill`](https://github.com/XPRNetwork/xpr-network-dev-skill) repo and pointing the harness at the local folder. Domain skills live under [`openclaw/starter/agent/skills/`](https://github.com/XPRNetwork/xpr-agents/tree/main/openclaw/starter/agent/skills) in the main repo.
> If ClawHub is unavailable (see [issue #2167](https://github.com/openclaw/clawhub/issues/2167)), clone [`xpr-network-dev-skill`](https://github.com/XPRNetwork/xpr-network-dev-skill) and point the harness at the local folder. The 13 in-package skills come from `@xpr-agents/openclaw` itself — they keep working regardless of ClawHub availability.

## Step 4 — Verify

Expand Down
36 changes: 31 additions & 5 deletions openclaw/README.md
Original file line number Diff line number Diff line change
@@ -1,26 +1,52 @@
# @xpr-agents/openclaw

OpenClaw plugin for the XPR Network Trustless Agent Registry — 72 MCP tools for AI assistants to autonomously manage agents, jobs, feedback, validations, and escrow on-chain.
OpenClaw plugin for the XPR Network Trustless Agent Registry — **72 MCP tools + 13 bundled skills** for AI assistants to autonomously manage agents, jobs, feedback, validations, and escrow on-chain.

## XPR Agents Ecosystem

| Package | Description |
|---------|-------------|
| [`create-xpr-agent`](https://www.npmjs.com/package/create-xpr-agent) | Deploy an autonomous AI agent in one command |
| [`@xpr-agents/sdk`](https://www.npmjs.com/package/@xpr-agents/sdk) | TypeScript SDK for all four contracts |
| [`@xpr-agents/openclaw`](https://www.npmjs.com/package/@xpr-agents/openclaw) | 72 MCP tools for AI assistants |
| [`@xpr-agents/openclaw`](https://www.npmjs.com/package/@xpr-agents/openclaw) | 72 MCP tools + 13 skills for AI assistants |

## Quick Start

Deploy your own agent:
Deploy your own self-contained autonomous agent on a host you own:

```bash
npx create-xpr-agent my-agent
cd my-agent
./setup.sh
./start.sh --account myagent --api-key sk-ant-yourkey --network mainnet
```

## Tools (55 total)
Or install just the plugin inside an existing OpenClaw harness (Pinata, gateway-hosted, etc.) — see [`docs/PINATA.md`](https://github.com/XPRNetwork/xpr-agents/blob/main/docs/PINATA.md):

```bash
npm install @xpr-agents/openclaw
```

## Bundled Skills (13 total — since v0.4.0)

The plugin ships pre-built skills in its tarball; the `openclaw.plugin.json` manifest lists them so harnesses auto-load them once registered.

| Skill | Purpose |
|-------|---------|
| `xpr-agent-operator` | System prompt for autonomous job-board behavior |
| `creative` | Image / video generation, IPFS upload, PDF, GitHub repos |
| `web-scraping` | Page fetch / parse, structured data extraction |
| `code-sandbox` | Sandboxed JS execution in VM |
| `structured-data` | CSV / JSON parsing, chart generation |
| `defi` | DEX trading, AMM swaps, OTC, yield farming, liquidity, msig |
| `nft` | AtomicAssets / AtomicMarket NFT lifecycle |
| `lending` | LOAN Protocol — supply, borrow, repay, redeem, rewards |
| `governance` | XPR Network governance — proposals, voting, communities |
| `xmd` | Metal Dollar stablecoin — mint, redeem, analytics |
| `smart-contracts` | Chain inspection, contract scaffolding, auditing |
| `tax` | Crypto tax reporting |
| `shellbook` | Shellbook.io social network |

## Tools (72 total)

### Agent Management (10 tools)
`xpr_register_agent`, `xpr_update_agent`, `xpr_get_agent`, `xpr_list_agents`, `xpr_get_trust_score`, `xpr_set_agent_status`, `xpr_stake_agent`, `xpr_add_plugin`, `xpr_remove_plugin`, `xpr_list_agent_plugins`
Expand Down
4 changes: 4 additions & 0 deletions openclaw/dist/index.d.ts
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,10 @@
import type { PluginApi } from './types';
export type { SkillManifest, SkillApi, LoadedSkill } from './skill-types';
export type { ToolDefinition, PluginApi } from './types';
export { createCliSession, createCliApi } from './cli-session';
export type { CliSessionOptions, CliApi } from './cli-session';
export { execAction, execTransactionPush, getTableRows, checkProtonCli, checkKeychainPopulated, ProtonCliError, } from './proton-cli';
export type { CliErrorCode, CliAction, CliTransactionResult, TableQueryOpts } from './proton-cli';
/**
* OpenClaw plugin API shape (real runtime API).
* Plugins receive this from the OpenClaw gateway.
Expand Down
2 changes: 1 addition & 1 deletion openclaw/dist/index.d.ts.map

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

20 changes: 18 additions & 2 deletions openclaw/dist/index.js

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Loading
Loading