@agentlayer.tech/wallet 0.1.13 → 0.1.15

package/RELEASING.md

@@ -12,6 +12,13 @@ The public install command is:
 npx @agentlayer.tech/wallet install --yes
 ```
 
+The repo also ships two native OpenClaw plugin packages for ClawHub:
+
+```text
+@agentlayertech/agent-wallet-plugin
+@agentlayertech/pay-bridge-plugin
+```
+
 ## When npm Publishes
 
 Normal commits and pushes do not publish new npm versions. They only run the
@@ -31,6 +38,9 @@ agent-wallet/pyproject.toml
 ```
 
 If those versions do not match the tag, the workflow fails before publishing.
+The same `v*` tag can also trigger the ClawHub plugin publish workflow, so keep
+the root installer versions aligned with the ClawHub plugin package versions
+when you want one GitHub release to ship both surfaces together.
 
 ## Stable Release
 
@@ -174,6 +184,66 @@ OpenClaw secrets
 
 The package allowlist lives in `package.json` under `files`.
 
+## ClawHub Plugin Packages
+
+The OpenClaw plugin packages are published separately from the npm installer.
+They are additive and do not replace `@agentlayer.tech/wallet`.
+
+Before publishing either package, build and validate the runtime artifacts:
+
+```bash
+npm run build:openclaw-plugins
+npm run check:openclaw-plugins
+```
+
+Dry-run the package contents from each plugin directory:
+
+```bash
+(cd .openclaw/extensions/agent-wallet && npm pack --dry-run)
+(cd .openclaw/extensions/pay-bridge && npm pack --dry-run)
+```
+
+Publish to ClawHub with the package-specific command documented by OpenClaw:
+
+```bash
+clawhub package publish .openclaw/extensions/agent-wallet --dry-run
+clawhub package publish .openclaw/extensions/agent-wallet
+
+clawhub package publish .openclaw/extensions/pay-bridge --dry-run
+clawhub package publish .openclaw/extensions/pay-bridge
+```
+
+Users then install them natively through OpenClaw:
+
+```bash
+openclaw plugins install clawhub:@agentlayertech/agent-wallet-plugin
+openclaw plugins install clawhub:@agentlayertech/pay-bridge-plugin
+```
+
+GitHub Actions can publish the same packages automatically from tags and manual
+dispatch through `.github/workflows/clawhub-plugins.yml`.
+
+Required repository secret:
+
+```text
+CLAWHUB_TOKEN
+```
+
+Workflow behavior:
+
+- `pull_request`: packs both plugins and runs ClawHub `--dry-run`
+- `workflow_dispatch`: publishes or dry-runs based on the `dry_run` input
+- `push` on `v*` tags: publishes both plugins automatically
+
+The workflow currently publishes:
+
+- `.openclaw/extensions/agent-wallet` as `bundle-plugin`
+- `.openclaw/extensions/pay-bridge` as `code-plugin`
+
+`agent-wallet` stays on `bundle-plugin` because that package name was first
+published to ClawHub with that family, and ClawHub does not allow family
+changes for an existing package record.
+
 ## Runtime Layout
 
 Installer releases are copied into the user's OpenClaw home:

package/agent-wallet/README.md

@@ -558,6 +558,20 @@ It forwards tool execution to the Python bridge CLI:
 
 This keeps the official OpenClaw-facing layer in TypeScript while the actual wallet/security logic remains in the Python backend.
 
+If you want OpenClaw to install the plugin through ClawHub instead of a repo-local path, use:
+
+```bash
+openclaw plugins install clawhub:@agentlayertech/agent-wallet-plugin
+```
+
+That native plugin package is additive. Keep the existing runtime installer for the actual wallet backend:
+
+```bash
+npx @agentlayer.tech/wallet install --yes
+```
+
+The ClawHub plugin package auto-checks `~/.openclaw/agent-wallet-runtime/current/agent-wallet` before it falls back to a local workspace checkout.
+
 Public-safe helper scripts are available in `agent-wallet/scripts/`:
 
 - `install_openclaw_local_config.py`

package/agent-wallet/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "openclaw-agent-wallet"
-version = "0.1.13"
+version = "0.1.15"
 description = "Plugin-friendly wallet backend for OpenClaw agents"
 requires-python = ">=3.10"
 dependencies = [

package/agent-wallet/scripts/install_openclaw_local_config.py

@@ -1,10 +1,11 @@
-"""Patch an OpenClaw config file for the agent-wallet plugin."""
+"""Patch an OpenClaw config file for the AgentLayer OpenClaw plugins."""
 
 from __future__ import annotations
 
 import argparse
 import json
 import os
+import shutil
 import sys
 from datetime import datetime, timezone
 from pathlib import Path
@@ -44,6 +45,15 @@ OPTIONAL_TOOLS = [
     "request_devnet_airdrop",
 ]
 
+PAY_BRIDGE_PLUGIN_ID = "pay-bridge"
+PAY_BRIDGE_TOOLS = [
+    "pay_status",
+    "pay_wallet_info",
+    "pay_search_services",
+    "pay_get_service_endpoints",
+    "pay_api_request",
+]
+
 
 def _default_config_path() -> Path:
     return Path(os.path.expanduser("~/.openclaw/openclaw.json"))
@@ -83,6 +93,13 @@ def _default_extension_path() -> Path:
     return _repo_root() / ".openclaw" / "extensions" / "agent-wallet"
 
 
+def _default_pay_bridge_extension_path() -> Path:
+    runtime_root = _trusted_runtime_root()
+    if runtime_root is not None:
+        return runtime_root / ".openclaw" / "extensions" / PAY_BRIDGE_PLUGIN_ID
+    return _repo_root() / ".openclaw" / "extensions" / PAY_BRIDGE_PLUGIN_ID
+
+
 def _default_package_root() -> Path:
     runtime_root = _trusted_runtime_root()
     if runtime_root is not None:
@@ -105,6 +122,14 @@ def _default_python_bin() -> str:
     return sys.executable
 
 
+def _default_pay_binary() -> str:
+    explicit = os.getenv("OPENCLAW_PAY_BINARY", "").strip()
+    if explicit:
+        return explicit
+    resolved = shutil.which("pay")
+    return resolved or "pay"
+
+
 def _default_user_id() -> str:
     return f"{os.getenv('USER', 'openclaw-user')}-local"
 
@@ -142,8 +167,10 @@ def build_parser() -> argparse.ArgumentParser:
         default=True,
     )
     parser.add_argument("--extension-path", default=str(_default_extension_path()))
+    parser.add_argument("--pay-bridge-extension-path", default=str(_default_pay_bridge_extension_path()))
     parser.add_argument("--package-root", default=str(_default_package_root()))
     parser.add_argument("--python-bin", default=_default_python_bin())
+    parser.add_argument("--pay-binary", default=_default_pay_binary())
     parser.add_argument("--write-master-key", action=argparse.BooleanOptionalAction, default=False)
     return parser
 
@@ -214,12 +241,20 @@ def main() -> None:
 
     plugins = data.setdefault("plugins", {})
     plugins["enabled"] = True
+    allow = plugins.setdefault("allow", [])
+    if args.plugin_id not in allow:
+        allow.append(args.plugin_id)
+    if PAY_BRIDGE_PLUGIN_ID not in allow:
+        allow.append(PAY_BRIDGE_PLUGIN_ID)
 
     load = plugins.setdefault("load", {})
     paths = load.setdefault("paths", [])
     extension_path_text = str(Path(args.extension_path).expanduser().resolve())
     if extension_path_text not in paths:
         paths.append(extension_path_text)
+    pay_bridge_extension_path_text = str(Path(args.pay_bridge_extension_path).expanduser().resolve())
+    if pay_bridge_extension_path_text not in paths:
+        paths.append(pay_bridge_extension_path_text)
 
     entries = plugins.setdefault("entries", {})
     effective_network = _normalize_network(args.backend, args.network)
@@ -272,10 +307,25 @@ def main() -> None:
         "enabled": True,
         "config": plugin_config,
     }
+    existing_pay_entry = entries.get(PAY_BRIDGE_PLUGIN_ID) if isinstance(entries.get(PAY_BRIDGE_PLUGIN_ID), dict) else {}
+    existing_pay_config = (
+        dict(existing_pay_entry.get("config"))
+        if isinstance(existing_pay_entry.get("config"), dict)
+        else {}
+    )
+    pay_bridge_config = {
+        **existing_pay_config,
+        "payBinary": args.pay_binary.strip() or _default_pay_binary(),
+        "requireHttps": bool(existing_pay_config.get("requireHttps", True)),
+    }
+    entries[PAY_BRIDGE_PLUGIN_ID] = {
+        "enabled": True,
+        "config": pay_bridge_config,
+    }
 
     tools = data.setdefault("tools", {})
     also_allow = tools.setdefault("alsoAllow", [])
-    for tool_name in OPTIONAL_TOOLS:
+    for tool_name in OPTIONAL_TOOLS + PAY_BRIDGE_TOOLS:
         if tool_name not in also_allow:
             also_allow.append(tool_name)
 
@@ -291,6 +341,7 @@ def main() -> None:
                 "config_path": str(config_path),
                 "backup_path": str(backup_path),
                 "extension_path": extension_path_text,
+                "pay_bridge_extension_path": pay_bridge_extension_path_text,
                 "python_bin": args.python_bin,
                 "package_root": plugin_config["packageRoot"],
                 "plugin_id": args.plugin_id,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentlayer.tech/wallet",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "NPM installer for the OpenClaw Agent Wallet local runtime.",
   "type": "module",
   "repository": {
@@ -14,6 +14,8 @@
   "bin": "./bin/openclaw-agent-wallet.mjs",
   "scripts": {
     "check": "node --check bin/openclaw-agent-wallet.mjs",
+    "build:openclaw-plugins": "node scripts/manage_openclaw_plugin_packages.mjs build",
+    "check:openclaw-plugins": "node scripts/manage_openclaw_plugin_packages.mjs check",
     "check:release-version": "node scripts/check_release_version.mjs",
     "test:npm-installer": "python3 agent-wallet/tests/smoke_npm_installer.py",
     "pack:dry-run": "npm pack --dry-run"
@@ -38,6 +40,7 @@
     "agent-wallet/pyproject.toml",
     ".openclaw/AGENTS.md",
     ".openclaw/extensions/agent-wallet/",
+    ".openclaw/extensions/pay-bridge/",
     "hermes/plugins/agent_wallet/",
     "wdk-btc-wallet/src/",
     "wdk-btc-wallet/bootstrap.sh",
@@ -69,4 +72,4 @@
     "evm"
   ],
   "license": "SEE LICENSE IN LICENSE"
-}
+}