@agentlayer.tech/wallet 0.1.14 → 0.1.15

package/README.md

@@ -51,6 +51,15 @@ Install through npm:
 npx @agentlayer.tech/wallet install --yes
 ```
 
+Install the native OpenClaw plugins from ClawHub:
+
+```bash
+openclaw plugins install clawhub:@agentlayertech/agent-wallet-plugin
+openclaw plugins install clawhub:@agentlayertech/pay-bridge-plugin
+```
+
+Those ClawHub packages do not replace the npm installer. Keep `npx @agentlayer.tech/wallet install --yes` for laying down the local wallet runtime, Python backend, and helper services. The ClawHub packages only install the OpenClaw plugin surfaces that point at that runtime.
+
 Or install the CLI globally first:
 
 ```bash
@@ -77,6 +86,29 @@ wallet update --yes
 wallet rollback
 ```
 
+## Native OpenClaw plugin installs
+
+Use ClawHub when you want the plugin itself to be installed through OpenClaw:
+
+```bash
+openclaw plugins install clawhub:@agentlayertech/agent-wallet-plugin
+openclaw plugins install clawhub:@agentlayertech/pay-bridge-plugin
+```
+
+Recommended order:
+
+1. Install or update the local runtime with `npx @agentlayer.tech/wallet install --yes`.
+2. Install the plugin package from ClawHub with `openclaw plugins install clawhub:...`.
+3. Restart the OpenClaw gateway and enable/configure the plugin entry in `openclaw.json`.
+
+The `agent-wallet` ClawHub plugin auto-checks the standard runtime path at:
+
+```bash
+~/.openclaw/agent-wallet-runtime/current/agent-wallet
+```
+
+If your runtime lives elsewhere, set `plugins.entries.agent-wallet.config.packageRoot` explicitly.
+
 Install from a local clone:
 
 ```bash

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.14"
+version = "0.1.15"
 description = "Plugin-friendly wallet backend for OpenClaw agents"
 requires-python = ">=3.10"
 dependencies = [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentlayer.tech/wallet",
-  "version": "0.1.14",
+  "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"