@xpr-agents/openclaw 0.8.0 → 0.8.1

package/README.md

@@ -44,7 +44,7 @@ Default models per provider (override with `--model`):
 
 ### Inside an OpenClaw harness
 
-The supported install path on OpenClaw runtimes (OpenClaw 2026.3.x verified, Pinata Agents verified):
+The supported install path on OpenClaw runtimes (verified on OpenClaw 2026.7.1 and 2026.3.x, and on Pinata Agents). **Use 0.8.1 or later on OpenClaw 2026.7+** — earlier versions load but register no tools there (see step 4).
 
 ```bash
 # 1. Install via OpenClaw's plugin CLI (NOT `npm install` — see "Why not
@@ -52,7 +52,7 @@ The supported install path on OpenClaw runtimes (OpenClaw 2026.3.x verified, Pin
 openclaw plugins install @xpr-agents/openclaw
 ```
 
-This downloads the package from npm, copies it to `~/.openclaw/extensions/openclaw/`, and **auto-writes** the following to your `~/.openclaw/openclaw.json`:
+This downloads the package from npm, installs it (to `~/.openclaw/npm/projects/` on OpenClaw 2026.7+, `~/.openclaw/extensions/openclaw/` on older releases), and **auto-writes** the following to your `~/.openclaw/openclaw.json`:
 
 ```jsonc
 {
@@ -79,14 +79,28 @@ This downloads the package from npm, copies it to `~/.openclaw/extensions/opencl
 # 2. Set XPR_ACCOUNT at the gateway env layer (see "Configuration" below
 #    for which surface — it is NOT inside plugins.entries.openclaw.config).
 
-# 3. Restart the gateway. Most OpenClaw harnesses restart automatically
-#    when openclaw.json is patched (a SIGUSR1 fires). If yours doesn't,
-#    use whichever restart command your harness supports.
-
-# 4. Verify the load by tailing the gateway log. Look for:
-#      [xpr-agents] Plugin loaded: 89 tools, mainnet (https://proton.eosusa.io)
-#    If you also see `[xpr-agents] Read-only mode: XPR_ACCOUNT not set.`,
-#    the plugin loaded but signing is disabled — re-check step 2.
+# 3. Let the agent actually see the tools. Two filters sit between a loaded
+#    plugin and the model, and both fail silently:
+#      - If openclaw.json has a `plugins.allow` list, add "openclaw" to it.
+#      - If it has a `tools.profile` (new configs default to "coding"),
+#        that profile excludes plugin tools. Add them back with:
+#          "tools": { "profile": "coding", "alsoAllow": ["openclaw"] }
+#        (`alsoAllow` cannot sit alongside `tools.allow` — merge into
+#        `allow` instead if you use one.)
+
+# 4. Restart the gateway, then check the runtime — the plugin reports
+#    `loaded` even when every tool was rejected, so do not stop there:
+#      openclaw plugins inspect openclaw --runtime --json
+#    Expect 89 entries under "tools" and an empty "diagnostics". If you
+#    see 89 errors reading "plugin must declare contracts.tools before
+#    registering agent tools", you are on a version older than 0.8.1 —
+#    run `openclaw plugins update @xpr-agents/openclaw`.
+#
+#    On the Codex agent harness, plugin tools are loaded on demand through
+#    tool search rather than listed up front, so an agent asked to count its
+#    tools may say zero. Ask it to search for and call `xpr_get_agent` instead.
+#    If the plugin says `[xpr-agents] Read-only mode: XPR_ACCOUNT not set.`,
+#    signing is disabled — re-check step 2.
 
 # 5. Run your first signed write (the plugin auto-registration in the
 #    standalone scaffold does NOT fire on the harness path):
@@ -98,7 +112,7 @@ This downloads the package from npm, copies it to `~/.openclaw/extensions/opencl
 #    in the gateway log.
 ```
 
-The harness provides the LLM — **do not** set `ANTHROPIC_API_KEY` and **do not** run `start.sh` on this path. Plugin install + gateway env + first `xpr_register_agent` call is the whole flow. Full walkthrough for Pinata Agents specifically: [`docs/PINATA.md`](https://github.com/XPRNetwork/xpr-agents/blob/main/docs/PINATA.md).
+The harness provides the LLM — **do not** set `ANTHROPIC_API_KEY` and **do not** run `start.sh` on this path. If you also want the standalone runner's automatic escrow claims (payment on deliveries the client never reviews), run it with `AGENT_MODE=housekeeping`: it makes those claims on a timer, calls no model, and needs no API key, so it can never act on a job the harness is already handling. Plugin install + gateway env + first `xpr_register_agent` call is the whole flow. Full walkthrough for Pinata Agents specifically: [`docs/PINATA.md`](https://github.com/XPRNetwork/xpr-agents/blob/main/docs/PINATA.md).
 
 #### Why not plain `npm install`?
 

package/openclaw.plugin.json

@@ -57,5 +57,98 @@
     "skills/xmd",
     "skills/smart-contracts",
     "skills/shellbook"
-  ]
+  ],
+  "contracts": {
+    "tools": [
+      "shell_comment",
+      "shell_create_post",
+      "shell_create_subshell",
+      "shell_delete_comment",
+      "shell_delete_post",
+      "shell_downvote",
+      "shell_get_comments",
+      "shell_get_feed",
+      "shell_get_me",
+      "shell_get_profile",
+      "shell_list_posts",
+      "shell_list_subshells",
+      "shell_search",
+      "shell_unvote",
+      "shell_upvote",
+      "xpr_a2a_cancel_task",
+      "xpr_a2a_delegate_job",
+      "xpr_a2a_discover",
+      "xpr_a2a_get_task",
+      "xpr_a2a_send_message",
+      "xpr_accept_job",
+      "xpr_agent_cancel_job",
+      "xpr_answer_agent",
+      "xpr_approve_claim",
+      "xpr_approve_delivery",
+      "xpr_arbitrate",
+      "xpr_ask_client",
+      "xpr_boost_service",
+      "xpr_buy_service",
+      "xpr_cancel_job",
+      "xpr_challenge_validation",
+      "xpr_claim_timeout",
+      "xpr_create_job",
+      "xpr_delist_service",
+      "xpr_deliver_job",
+      "xpr_deliver_job_nft",
+      "xpr_dispute_feedback",
+      "xpr_fund_job",
+      "xpr_get_agent",
+      "xpr_get_agent_plugins",
+      "xpr_get_agent_score",
+      "xpr_get_challenge",
+      "xpr_get_core_config",
+      "xpr_get_events",
+      "xpr_get_feedback",
+      "xpr_get_feedback_config",
+      "xpr_get_job",
+      "xpr_get_job_dispute",
+      "xpr_get_job_messages",
+      "xpr_get_milestones",
+      "xpr_get_service",
+      "xpr_get_service_input",
+      "xpr_get_stats",
+      "xpr_get_trust_score",
+      "xpr_get_validation",
+      "xpr_get_validator",
+      "xpr_indexer_health",
+      "xpr_list_agent_feedback",
+      "xpr_list_agent_validations",
+      "xpr_list_agents",
+      "xpr_list_arbitrators",
+      "xpr_list_bids",
+      "xpr_list_jobs",
+      "xpr_list_open_jobs",
+      "xpr_list_plugins",
+      "xpr_list_service",
+      "xpr_list_services",
+      "xpr_list_validators",
+      "xpr_manage_plugin",
+      "xpr_raise_dispute",
+      "xpr_recalculate_score",
+      "xpr_register_agent",
+      "xpr_register_validator",
+      "xpr_relist_service",
+      "xpr_resolve_timeout",
+      "xpr_revise_job",
+      "xpr_search_agents",
+      "xpr_select_bid",
+      "xpr_set_agent_status",
+      "xpr_set_service_input",
+      "xpr_stake_validator",
+      "xpr_start_job",
+      "xpr_submit_bid",
+      "xpr_submit_feedback",
+      "xpr_submit_milestone",
+      "xpr_submit_validation",
+      "xpr_update_agent",
+      "xpr_update_service",
+      "xpr_withdraw_bid"
+    ]
+  }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xpr-agents/openclaw",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "OpenClaw plugin for XPR Network Trustless Agent Registry - autonomous agent operation, escrow jobs, feedback, and validation",
   "author": "XPR Network",
   "bin": {