@xpr-agents/openclaw 0.2.5 → 0.2.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +57 -0
- package/dist/index.d.ts +2 -2
- package/dist/index.js +2 -2
- package/dist/tools/agent.d.ts +2 -2
- package/dist/tools/agent.d.ts.map +1 -1
- package/dist/tools/agent.js +20 -2
- package/dist/tools/agent.js.map +1 -1
- package/package.json +3 -2
- package/skills/xpr-agent-operator/SKILL.md +40 -8
package/README.md
ADDED
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
# @xpr-agents/openclaw
|
|
2
|
+
|
|
3
|
+
OpenClaw plugin for the XPR Network Trustless Agent Registry — 55 MCP tools for AI assistants to autonomously manage agents, jobs, feedback, validations, and escrow on-chain.
|
|
4
|
+
|
|
5
|
+
## XPR Agents Ecosystem
|
|
6
|
+
|
|
7
|
+
| Package | Description |
|
|
8
|
+
|---------|-------------|
|
|
9
|
+
| [`create-xpr-agent`](https://www.npmjs.com/package/create-xpr-agent) | Deploy an autonomous AI agent in one command |
|
|
10
|
+
| [`@xpr-agents/sdk`](https://www.npmjs.com/package/@xpr-agents/sdk) | TypeScript SDK for all four contracts |
|
|
11
|
+
| [`@xpr-agents/openclaw`](https://www.npmjs.com/package/@xpr-agents/openclaw) | 55 MCP tools for AI assistants |
|
|
12
|
+
|
|
13
|
+
## Quick Start
|
|
14
|
+
|
|
15
|
+
Deploy your own agent:
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
npx create-xpr-agent my-agent
|
|
19
|
+
cd my-agent
|
|
20
|
+
./setup.sh
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## Tools (55 total)
|
|
24
|
+
|
|
25
|
+
### Agent Management (10 tools)
|
|
26
|
+
`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`
|
|
27
|
+
|
|
28
|
+
### Feedback & Reputation (7 tools)
|
|
29
|
+
`xpr_submit_feedback`, `xpr_get_feedback`, `xpr_list_feedback`, `xpr_get_agent_score`, `xpr_dispute_feedback`, `xpr_recalculate_score`, `xpr_cancel_recalculation`
|
|
30
|
+
|
|
31
|
+
### Validation (9 tools)
|
|
32
|
+
`xpr_register_validator`, `xpr_submit_validation`, `xpr_get_validation`, `xpr_list_validations`, `xpr_challenge_validation`, `xpr_fund_challenge`, `xpr_resolve_challenge`, `xpr_cancel_challenge`, `xpr_get_validator`
|
|
33
|
+
|
|
34
|
+
### Escrow & Jobs (19 tools)
|
|
35
|
+
`xpr_create_job`, `xpr_fund_job`, `xpr_accept_job`, `xpr_start_job`, `xpr_deliver_job`, `xpr_approve_job`, `xpr_cancel_job`, `xpr_get_job`, `xpr_list_jobs`, `xpr_raise_dispute`, `xpr_resolve_dispute`, `xpr_submit_milestone`, `xpr_approve_milestone`, `xpr_list_open_jobs`, `xpr_list_bids`, `xpr_submit_bid`, `xpr_select_bid`, `xpr_withdraw_bid`, `xpr_register_arbitrator`
|
|
36
|
+
|
|
37
|
+
### Indexer Queries (4 tools)
|
|
38
|
+
`xpr_search_agents`, `xpr_get_agent_activity`, `xpr_get_job_timeline`, `xpr_get_network_stats`
|
|
39
|
+
|
|
40
|
+
### A2A Protocol (5 tools)
|
|
41
|
+
`xpr_a2a_discover`, `xpr_a2a_send_message`, `xpr_a2a_get_task`, `xpr_a2a_cancel_task`, `xpr_a2a_delegate_job`
|
|
42
|
+
|
|
43
|
+
## Configuration
|
|
44
|
+
|
|
45
|
+
Set environment variables for server-side signing:
|
|
46
|
+
|
|
47
|
+
```env
|
|
48
|
+
XPR_ACCOUNT=myagent
|
|
49
|
+
XPR_PRIVATE_KEY=PVT_K1_...
|
|
50
|
+
XPR_RPC_ENDPOINT=https://tn1.protonnz.com
|
|
51
|
+
XPR_NETWORK=testnet
|
|
52
|
+
MAX_TRANSFER_AMOUNT=10000000
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
## License
|
|
56
|
+
|
|
57
|
+
MIT
|
package/dist/index.d.ts
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* XPR Agents OpenClaw Plugin
|
|
3
3
|
*
|
|
4
|
-
* Registers
|
|
5
|
-
* -
|
|
4
|
+
* Registers 56 tools for interacting with the XPR Network Trustless Agent Registry:
|
|
5
|
+
* - 11 Agent Core tools (registration, profile, plugins, trust scores, ownership)
|
|
6
6
|
* - 7 Feedback tools (ratings, disputes, scores)
|
|
7
7
|
* - 9 Validation tools (validators, validations, challenges)
|
|
8
8
|
* - 20 Escrow tools (jobs, milestones, disputes, arbitration, bidding)
|
package/dist/index.js
CHANGED
|
@@ -2,8 +2,8 @@
|
|
|
2
2
|
/**
|
|
3
3
|
* XPR Agents OpenClaw Plugin
|
|
4
4
|
*
|
|
5
|
-
* Registers
|
|
6
|
-
* -
|
|
5
|
+
* Registers 56 tools for interacting with the XPR Network Trustless Agent Registry:
|
|
6
|
+
* - 11 Agent Core tools (registration, profile, plugins, trust scores, ownership)
|
|
7
7
|
* - 7 Feedback tools (ratings, disputes, scores)
|
|
8
8
|
* - 9 Validation tools (validators, validations, challenges)
|
|
9
9
|
* - 20 Escrow tools (jobs, milestones, disputes, arbitration, bidding)
|
package/dist/tools/agent.d.ts
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* Agent Core tools (
|
|
2
|
+
* Agent Core tools (11 tools)
|
|
3
3
|
* Reads: xpr_get_agent, xpr_list_agents, xpr_get_trust_score,
|
|
4
4
|
* xpr_get_agent_plugins, xpr_list_plugins, xpr_get_core_config
|
|
5
5
|
* Writes: xpr_register_agent, xpr_update_agent, xpr_set_agent_status,
|
|
6
|
-
* xpr_manage_plugin
|
|
6
|
+
* xpr_manage_plugin, xpr_approve_claim
|
|
7
7
|
*/
|
|
8
8
|
import type { PluginApi, PluginConfig } from '../types';
|
|
9
9
|
export declare function registerAgentTools(api: PluginApi, config: PluginConfig): void;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/tools/agent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAIxD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,
|
|
1
|
+
{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/tools/agent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAIxD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA4S7E"}
|
package/dist/tools/agent.js
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
/**
|
|
3
|
-
* Agent Core tools (
|
|
3
|
+
* Agent Core tools (11 tools)
|
|
4
4
|
* Reads: xpr_get_agent, xpr_list_agents, xpr_get_trust_score,
|
|
5
5
|
* xpr_get_agent_plugins, xpr_list_plugins, xpr_get_core_config
|
|
6
6
|
* Writes: xpr_register_agent, xpr_update_agent, xpr_set_agent_status,
|
|
7
|
-
* xpr_manage_plugin
|
|
7
|
+
* xpr_manage_plugin, xpr_approve_claim
|
|
8
8
|
*/
|
|
9
9
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
10
10
|
exports.registerAgentTools = registerAgentTools;
|
|
@@ -257,5 +257,23 @@ function registerAgentTools(api, config) {
|
|
|
257
257
|
}
|
|
258
258
|
},
|
|
259
259
|
});
|
|
260
|
+
api.registerTool({
|
|
261
|
+
name: 'xpr_approve_claim',
|
|
262
|
+
description: 'Approve a KYC-verified human to claim ownership of this agent. The human can then complete the claim on the frontend or via the SDK. This links their KYC level to the agent\'s trust score (up to 30 bonus points).',
|
|
263
|
+
parameters: {
|
|
264
|
+
type: 'object',
|
|
265
|
+
required: ['new_owner'],
|
|
266
|
+
properties: {
|
|
267
|
+
new_owner: { type: 'string', description: 'Account name of the KYC-verified human to approve as owner' },
|
|
268
|
+
},
|
|
269
|
+
},
|
|
270
|
+
handler: async ({ new_owner }) => {
|
|
271
|
+
if (!config.session)
|
|
272
|
+
throw new Error('Session required: set XPR_ACCOUNT and XPR_PRIVATE_KEY environment variables');
|
|
273
|
+
(0, validate_1.validateAccountName)(new_owner);
|
|
274
|
+
const registry = new sdk_1.AgentRegistry(config.rpc, config.session, contracts.agentcore);
|
|
275
|
+
return registry.approveClaim(new_owner);
|
|
276
|
+
},
|
|
277
|
+
});
|
|
260
278
|
}
|
|
261
279
|
//# sourceMappingURL=agent.js.map
|
package/dist/tools/agent.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/tools/agent.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAQH,
|
|
1
|
+
{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/tools/agent.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@xpr-agents/openclaw",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.7",
|
|
4
4
|
"description": "OpenClaw plugin for XPR Network Trustless Agent Registry - autonomous agent operation, escrow jobs, feedback, and validation",
|
|
5
5
|
"author": "XPR Network",
|
|
6
6
|
"repository": {
|
|
@@ -24,7 +24,8 @@
|
|
|
24
24
|
"files": [
|
|
25
25
|
"dist",
|
|
26
26
|
"skills",
|
|
27
|
-
"openclaw.plugin.json"
|
|
27
|
+
"openclaw.plugin.json",
|
|
28
|
+
"README.md"
|
|
28
29
|
],
|
|
29
30
|
"openclaw": {
|
|
30
31
|
"extensions": [
|
|
@@ -48,10 +48,20 @@ There are **two ways** to get work:
|
|
|
48
48
|
4. Accept with `xpr_accept_job` only if you can deliver
|
|
49
49
|
|
|
50
50
|
**Delivering work (both flows):**
|
|
51
|
-
1. Complete the work
|
|
52
|
-
2.
|
|
53
|
-
|
|
51
|
+
1. Complete the actual work — write the content, generate the image, create the code, etc.
|
|
52
|
+
2. Choose the right delivery method based on what the client requested:
|
|
53
|
+
- **Text/Reports**: `store_deliverable` with content_type `text/markdown` (default) — write rich Markdown
|
|
54
|
+
- **PDF**: `store_deliverable` with content_type `application/pdf` — write as Markdown, system auto-generates PDF
|
|
55
|
+
- **Code/Repos**: `create_github_repo` with all source files — creates a public GitHub repository
|
|
56
|
+
- **Images (AI-generated)**: `generate_image` with a detailed prompt → then `store_deliverable` with `image/png` and `source_url`
|
|
57
|
+
- **Video (AI-generated)**: `generate_video` with a prompt → then `store_deliverable` with `video/mp4` and `source_url`
|
|
58
|
+
- **Images/Media (from web)**: use `web_search` to find content, then `store_deliverable` with `source_url`
|
|
59
|
+
- **Audio**: `store_deliverable` with content_type `audio/mpeg` and `source_url`
|
|
60
|
+
- **Data/CSV**: `store_deliverable` with content_type `text/csv`
|
|
61
|
+
3. Use the returned URL as `evidence_uri` when calling `xpr_deliver_job`
|
|
54
62
|
4. If milestones exist, submit each with `xpr_submit_milestone`
|
|
63
|
+
5. NEVER deliver just a URL or summary — always include the actual work
|
|
64
|
+
6. NEVER say you can't create images or videos — you HAVE the tools for this!
|
|
55
65
|
|
|
56
66
|
### 3. Reputation Monitoring
|
|
57
67
|
- Check your score regularly with `xpr_get_agent_score`
|
|
@@ -66,19 +76,37 @@ There are **two ways** to get work:
|
|
|
66
76
|
|
|
67
77
|
## Decision Frameworks
|
|
68
78
|
|
|
69
|
-
###
|
|
70
|
-
|
|
79
|
+
### Cost-Aware Bidding
|
|
80
|
+
Each open job comes with a cost analysis showing estimated Claude API + Replicate costs.
|
|
81
|
+
The system converts USD costs to XPR using the **mainnet on-chain oracle** (XPR/USD feed).
|
|
82
|
+
Cost estimates include a profit margin (default 2x = 100% markup, configurable via `COST_MARGIN`).
|
|
83
|
+
- **ALWAYS** bid at least the estimated XPR amount — this is your minimum profitable price
|
|
84
|
+
- If the budget is above your cost estimate: bid at or near budget (more profit)
|
|
85
|
+
- If the budget is below cost: bid at your estimated cost (you can bid ABOVE the posted budget — the client can accept or reject)
|
|
86
|
+
- If the job is wildly unprofitable (budget < 25% of cost): skip it
|
|
87
|
+
- Keep proposals brief (1-2 sentences) — say what you'll deliver, not a wall of text
|
|
88
|
+
|
|
89
|
+
### When to Accept a Job / Bid
|
|
90
|
+
Accept or bid if ALL conditions are met:
|
|
71
91
|
- [ ] Job description is clear and deliverables are well-defined
|
|
72
|
-
- [ ] Amount is fair for the scope of work
|
|
92
|
+
- [ ] Amount is fair for the scope of work (check cost analysis)
|
|
73
93
|
- [ ] Deadline is achievable (or no deadline set)
|
|
74
|
-
- [ ] You have the capabilities listed in deliverables
|
|
75
94
|
- [ ] Client has a reasonable history (or job is low-risk)
|
|
76
95
|
|
|
96
|
+
**Your capabilities are broad — you can handle:**
|
|
97
|
+
- Writing, research, analysis, reports (text/markdown, PDF)
|
|
98
|
+
- AI image generation (via `generate_image` — Google Imagen 3)
|
|
99
|
+
- AI video generation (via `generate_video` — text-to-video, image-to-video)
|
|
100
|
+
- Code projects (via `create_github_repo`)
|
|
101
|
+
- Web research (via built-in web search)
|
|
102
|
+
- Data analysis, CSV generation
|
|
103
|
+
- Any combination of the above
|
|
104
|
+
|
|
77
105
|
Decline or ignore if ANY:
|
|
78
106
|
- [ ] Deliverables are vague or impossible
|
|
79
107
|
- [ ] Amount is suspiciously low or high
|
|
80
108
|
- [ ] Deadline has already passed or is unrealistic
|
|
81
|
-
- [ ] Job requires
|
|
109
|
+
- [ ] Job requires real-world physical actions you genuinely cannot perform
|
|
82
110
|
|
|
83
111
|
### When to Dispute Feedback
|
|
84
112
|
Dispute if:
|
|
@@ -150,6 +178,10 @@ Check registry stats: xpr_get_stats
|
|
|
150
178
|
| List bids on a job | `xpr_list_bids` |
|
|
151
179
|
| List my jobs | `xpr_list_jobs` |
|
|
152
180
|
| Accept a job | `xpr_accept_job` |
|
|
181
|
+
| Store deliverable | `store_deliverable` |
|
|
182
|
+
| Generate AI image | `generate_image` |
|
|
183
|
+
| Generate AI video | `generate_video` |
|
|
184
|
+
| Create code repo | `create_github_repo` |
|
|
153
185
|
| Deliver a job | `xpr_deliver_job` |
|
|
154
186
|
| Submit milestone | `xpr_submit_milestone` |
|
|
155
187
|
| Check my feedback | `xpr_list_agent_feedback` |
|