@agenticvault/openclaw 0.1.0 → 0.1.2

package/README.ja.md

@@ -1,4 +1,4 @@
-<!-- Source: packages/openclaw-plugin/README.md | Commit: 96a8dcc | Last synced: 2026-02-16 -->
+<!-- Source: packages/openclaw-plugin/README.md | Last synced: 2026-02-19 -->
 
 # @agenticvault/openclaw
 
@@ -8,29 +8,71 @@
 
 ## インストール
 
+### OpenClaw ホスト設定経由（推奨）
+
+パッケージと peer dependency をインストールし、OpenClaw ホスト設定に登録します：
+
+```bash
+npm install @agenticvault/openclaw openclaw
+```
+
+### `plugins.load.paths` 経由（手動）
+
+プラグインの読み込みを明示的に制御したい場合は、ローカルディレクトリにインストールし、そのパスを OpenClaw に指定します：
+
 ```bash
-npm install @agenticvault/openclaw @agenticvault/agentic-vault
+# ローカルディレクトリにインストール
+mkdir -p ./openclaw-plugins
+cd ./openclaw-plugins
+npm install @agenticvault/openclaw
 ```
 
+次に、OpenClaw ホスト設定にパスを追加します：
+
+```json
+{
+  "plugins": {
+    "load": {
+      "paths": ["./openclaw-plugins/node_modules/@agenticvault/openclaw"]
+    }
+  }
+}
+```
+
+> **ヒント**：本番環境では正確なバージョンを固定してください（`npm install @agenticvault/openclaw@0.1.1`）。予期しないアップグレードを防止します。
+
+> **既知の制限事項**：`openclaw plugins install @agenticvault/openclaw` はインストーラーの ID 不一致が発生する場合があります。上流で修正されるまでは、上記の方法でインストールしてください。
+
 ## 設定
 
-OpenClaw エージェント設定にプラグインを登録します：
+OpenClaw ホスト設定にプラグインを登録します。entries キーはマニフェストの `id`（`"agentic-vault"`）と一致する必要があります：
 
 ```json
 {
   "plugins": {
-    "agentic-vault": {
-      "package": "@agenticvault/openclaw",
-      "config": {
-        "keyId": "arn:aws:kms:us-east-1:123456789:key/your-key-id",
-        "region": "us-east-1",
-        "policyConfigPath": "./policy.json"
+    "entries": {
+      "agentic-vault": {
+        "config": {
+          "keyId": "arn:aws:kms:us-east-1:123456789:key/your-key-id",
+          "region": "us-east-1",
+          "policyConfigPath": "./policy.json",
+          "rpcUrl": "https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY"
+        }
       }
     }
   }
 }
 ```
 
+| オプション | 必須 | 説明 |
+|------------|------|------|
+| `keyId` | はい | AWS KMS キー ARN |
+| `region` | はい | AWS リージョン |
+| `policyConfigPath` | いいえ | ポリシー JSON ファイルパス（未指定時はすべて拒否） |
+| `rpcUrl` | いいえ | 残高/送金ツール用の RPC エンドポイント。`vault_get_balance`、`vault_send_transfer`、`vault_send_erc20_transfer` の使用時に必要。 |
+| `expectedAddress` | いいえ | 検証用の期待されるウォレットアドレス |
+| `enableUnsafeRawSign` | いいえ | 生署名ツールを有効化（デフォルト：`false`） |
+
 ## 利用可能なツール
 
 ### セーフツール（常時登録）
@@ -41,6 +83,9 @@ OpenClaw エージェント設定にプラグインを登録します：
 | `vault_health_check` | Vault 署名器のヘルスステータスを確認します |
 | `vault_sign_defi_call` | calldata デコードとポリシー検証後に DeFi コントラクトインタラクションに署名します |
 | `vault_sign_permit` | ポリシー検証後に EIP-2612 permit に署名します |
+| `vault_get_balance` | ネイティブまたは ERC20 トークン残高を照会します（`rpcUrl` が必要） |
+| `vault_send_transfer` | ポリシー検証付きでネイティブ ETH を送金します（`rpcUrl` が必要） |
+| `vault_send_erc20_transfer` | ポリシー検証付きで ERC20 トークンを送金します（`rpcUrl` が必要） |
 
 ### デュアルゲートツール（`enableUnsafeRawSign: true` が必要）
 
@@ -49,6 +94,18 @@ OpenClaw エージェント設定にプラグインを登録します：
 | `vault_sign_transaction` | 生の EVM トランザクションに署名します（デコーダーパイプラインをバイパス） |
 | `vault_sign_typed_data` | 生の EIP-712 型付きデータに署名します（デコーダーパイプラインをバイパス） |
 
+## プレリリース API からの移行
+
+プラグインのエントリーポイントがプレリリースの `register(api, config)` から公式 SDK コントラクト `export default function(api)` に変更されました：
+
+| 変更前（プレリリース） | 変更後（現在） |
+|------------------------|---------------|
+| `import { register } from "@agenticvault/openclaw"` | `export default function(api)` |
+| `register(api, config)` | 設定は `api.pluginConfig` から読み取り |
+| `api.registerTool(name, config, handler)` | `api.registerTool({ name, description, parameters, label, execute })` |
+
+プラグインは公式の `openclaw/plugin-sdk` 型を使用するようになり、`package.json` の `openclaw` フィールドを通じて OpenClaw ゲートウェイから検出可能です。
+
 ## セキュリティ
 
 - **デフォルト拒否** -- すべての署名操作に明示的なポリシー承認が必要です

package/README.ko.md

@@ -1,4 +1,4 @@
-<!-- Source: packages/openclaw-plugin/README.md | Commit: 96a8dcc | Last synced: 2026-02-16 -->
+<!-- Source: packages/openclaw-plugin/README.md | Last synced: 2026-02-19 -->
 
 # @agenticvault/openclaw
 
@@ -8,29 +8,71 @@
 
 ## 설치
 
+### OpenClaw 호스트 설정을 통한 설치 (권장)
+
+패키지와 peer dependency를 설치한 후 OpenClaw 호스트 설정에 등록합니다:
+
+```bash
+npm install @agenticvault/openclaw openclaw
+```
+
+### `plugins.load.paths`를 통한 설치 (수동)
+
+플러그인 로딩을 명시적으로 제어하려면 로컬 디렉토리에 패키지를 설치하고 OpenClaw에 경로를 지정합니다:
+
 ```bash
-npm install @agenticvault/openclaw @agenticvault/agentic-vault
+# 로컬 디렉토리에 설치
+mkdir -p ./openclaw-plugins
+cd ./openclaw-plugins
+npm install @agenticvault/openclaw
 ```
 
+그런 다음 OpenClaw 호스트 설정에 경로를 추가합니다:
+
+```json
+{
+  "plugins": {
+    "load": {
+      "paths": ["./openclaw-plugins/node_modules/@agenticvault/openclaw"]
+    }
+  }
+}
+```
+
+> **팁**: 프로덕션 환경에서는 정확한 버전을 고정하세요 (`npm install @agenticvault/openclaw@0.1.1`). 예기치 않은 업그레이드를 방지합니다.
+
+> **알려진 제한**: `openclaw plugins install @agenticvault/openclaw`은 설치 프로그램 ID 불일치가 발생할 수 있습니다. 업스트림에서 수정될 때까지 위의 방법을 사용하여 설치하세요.
+
 ## 설정
 
-OpenClaw 에이전트 설정에서 플러그인을 등록합니다:
+OpenClaw 호스트 설정에서 플러그인을 등록합니다. entries 키는 매니페스트 `id`(`"agentic-vault"`)와 일치해야 합니다:
 
 ```json
 {
   "plugins": {
-    "agentic-vault": {
-      "package": "@agenticvault/openclaw",
-      "config": {
-        "keyId": "arn:aws:kms:us-east-1:123456789:key/your-key-id",
-        "region": "us-east-1",
-        "policyConfigPath": "./policy.json"
+    "entries": {
+      "agentic-vault": {
+        "config": {
+          "keyId": "arn:aws:kms:us-east-1:123456789:key/your-key-id",
+          "region": "us-east-1",
+          "policyConfigPath": "./policy.json",
+          "rpcUrl": "https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY"
+        }
       }
     }
   }
 }
 ```
 
+| 옵션 | 필수 | 설명 |
+|------|------|------|
+| `keyId` | 예 | AWS KMS 키 ARN |
+| `region` | 예 | AWS 리전 |
+| `policyConfigPath` | 아니오 | 정책 JSON 파일 경로 (미지정 시 기본 전체 거부) |
+| `rpcUrl` | 아니오 | 잔액/전송 도구용 RPC 엔드포인트. `vault_get_balance`, `vault_send_transfer`, `vault_send_erc20_transfer` 사용 시 필요. |
+| `expectedAddress` | 아니오 | 검증용 예상 지갑 주소 |
+| `enableUnsafeRawSign` | 아니오 | 원시 서명 도구 활성화 (기본값: `false`) |
+
 ## 사용 가능한 도구
 
 ### 안전 도구 (항상 등록됨)
@@ -41,6 +83,9 @@ OpenClaw 에이전트 설정에서 플러그인을 등록합니다:
 | `vault_health_check` | Vault 서명기의 상태를 확인합니다 |
 | `vault_sign_defi_call` | calldata 디코딩 및 정책 검증 후 DeFi 컨트랙트 상호작용에 서명합니다 |
 | `vault_sign_permit` | 정책 검증 후 EIP-2612 permit에 서명합니다 |
+| `vault_get_balance` | 네이티브 또는 ERC20 토큰 잔액을 조회합니다 (`rpcUrl` 필요) |
+| `vault_send_transfer` | 정책 검증과 함께 네이티브 ETH를 전송합니다 (`rpcUrl` 필요) |
+| `vault_send_erc20_transfer` | 정책 검증과 함께 ERC20 토큰을 전송합니다 (`rpcUrl` 필요) |
 
 ### 이중 게이트 도구 (`enableUnsafeRawSign: true` 필요)
 
@@ -49,6 +94,18 @@ OpenClaw 에이전트 설정에서 플러그인을 등록합니다:
 | `vault_sign_transaction` | 원시 EVM 트랜잭션에 서명합니다 (디코더 파이프라인 우회) |
 | `vault_sign_typed_data` | 원시 EIP-712 타입 데이터에 서명합니다 (디코더 파이프라인 우회) |
 
+## 프리릴리스 API에서 마이그레이션
+
+플러그인 진입점이 프리릴리스 `register(api, config)`에서 공식 SDK 계약 `export default function(api)`로 변경되었습니다:
+
+| 변경 전 (프리릴리스) | 변경 후 (현재) |
+|---------------------|---------------|
+| `import { register } from "@agenticvault/openclaw"` | `export default function(api)` |
+| `register(api, config)` | 설정은 `api.pluginConfig`에서 읽음 |
+| `api.registerTool(name, config, handler)` | `api.registerTool({ name, description, parameters, label, execute })` |
+
+플러그인은 이제 공식 `openclaw/plugin-sdk` 타입을 사용하며, `package.json`의 `openclaw` 필드를 통해 OpenClaw 게이트웨이에서 검색됩니다.
+
 ## 보안
 
 - **기본 거부** -- 모든 서명 작업에 명시적인 정책 승인이 필요합니다

package/README.md

@@ -6,29 +6,71 @@ OpenClaw plugin for [Agentic Vault](https://github.com/agenticvault/agentic-vaul
 
 ## Installation
 
+### Via OpenClaw Host Config (Recommended)
+
+Install the package and its peer dependency, then register it in your OpenClaw host config:
+
+```bash
+npm install @agenticvault/openclaw openclaw
+```
+
+### Via `plugins.load.paths` (Manual)
+
+If you prefer explicit control over plugin loading, install the package to a local directory and point OpenClaw to it:
+
 ```bash
-npm install @agenticvault/openclaw @agenticvault/agentic-vault
+# Install to a local directory
+mkdir -p ./openclaw-plugins
+cd ./openclaw-plugins
+npm install @agenticvault/openclaw
 ```
 
+Then add the path to your OpenClaw host config:
+
+```json
+{
+  "plugins": {
+    "load": {
+      "paths": ["./openclaw-plugins/node_modules/@agenticvault/openclaw"]
+    }
+  }
+}
+```
+
+> **Tip**: Pin the exact version in production (`npm install @agenticvault/openclaw@0.1.1`) to avoid unexpected upgrades.
+
+> **Known limitation**: `openclaw plugins install @agenticvault/openclaw` may encounter an installer ID mismatch. Use one of the methods above until this is resolved upstream.
+
 ## Configuration
 
-Register the plugin in your OpenClaw agent configuration:
+Register the plugin in your OpenClaw host configuration. The entries key must match the manifest `id` (`"agentic-vault"`):
 
 ```json
 {
   "plugins": {
-    "agentic-vault": {
-      "package": "@agenticvault/openclaw",
-      "config": {
-        "keyId": "arn:aws:kms:us-east-1:123456789:key/your-key-id",
-        "region": "us-east-1",
-        "policyConfigPath": "./policy.json"
+    "entries": {
+      "agentic-vault": {
+        "config": {
+          "keyId": "arn:aws:kms:us-east-1:123456789:key/your-key-id",
+          "region": "us-east-1",
+          "policyConfigPath": "./policy.json",
+          "rpcUrl": "https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY"
+        }
       }
     }
   }
 }
 ```
 
+| Option | Required | Description |
+|--------|----------|-------------|
+| `keyId` | Yes | AWS KMS key ARN |
+| `region` | Yes | AWS region |
+| `policyConfigPath` | No | Path to policy JSON file (deny-all by default when omitted) |
+| `rpcUrl` | No | RPC endpoint for balance/transfer tools. Required to use `vault_get_balance`, `vault_send_transfer`, `vault_send_erc20_transfer`. |
+| `expectedAddress` | No | Expected wallet address for verification |
+| `enableUnsafeRawSign` | No | Enable raw signing tools (default: `false`) |
+
 ## Available Tools
 
 ### Safe Tools (always registered)
@@ -39,6 +81,9 @@ Register the plugin in your OpenClaw agent configuration:
 | `vault_health_check` | Check the health status of the vault signer |
 | `vault_sign_defi_call` | Sign a DeFi contract interaction after calldata decoding and policy validation |
 | `vault_sign_permit` | Sign an EIP-2612 permit after policy validation |
+| `vault_get_balance` | Query native or ERC20 token balance (requires `rpcUrl`) |
+| `vault_send_transfer` | Send native ETH transfer with policy validation (requires `rpcUrl`) |
+| `vault_send_erc20_transfer` | Send ERC20 token transfer with policy validation (requires `rpcUrl`) |
 
 ### Dual-Gated Tools (requires `enableUnsafeRawSign: true`)
 
@@ -47,6 +92,18 @@ Register the plugin in your OpenClaw agent configuration:
 | `vault_sign_transaction` | Sign a raw EVM transaction (bypasses decoder pipeline) |
 | `vault_sign_typed_data` | Sign raw EIP-712 typed data (bypasses decoder pipeline) |
 
+## Migration from Pre-Release API
+
+The plugin entry point changed from the pre-release `register(api, config)` to the official SDK contract `export default function(api)`:
+
+| Before (pre-release) | After (current) |
+|----------------------|-----------------|
+| `import { register } from "@agenticvault/openclaw"` | `export default function(api)` |
+| `register(api, config)` | Config read from `api.pluginConfig` |
+| `api.registerTool(name, config, handler)` | `api.registerTool({ name, description, parameters, label, execute })` |
+
+The plugin now uses the official `openclaw/plugin-sdk` types and can be discovered by the OpenClaw gateway via the `openclaw` field in `package.json`.
+
 ## Security
 
 - **Deny by default** -- all signing operations require explicit policy approval

package/README.zh-CN.md

@@ -1,4 +1,4 @@
-<!-- Source: packages/openclaw-plugin/README.md | Commit: 96a8dcc | Last synced: 2026-02-16 -->
+<!-- Source: packages/openclaw-plugin/README.md | Last synced: 2026-02-19 -->
 
 # @agenticvault/openclaw
 
@@ -8,29 +8,71 @@
 
 ## 安装
 
+### 通过 OpenClaw 主机配置（推荐）
+
+安装包及其 peer dependency，然后在 OpenClaw 主机配置中注册：
+
+```bash
+npm install @agenticvault/openclaw openclaw
+```
+
+### 通过 `plugins.load.paths`（手动）
+
+如果偏好显式控制插件加载，可将包安装到本地目录，再将路径指定给 OpenClaw：
+
 ```bash
-npm install @agenticvault/openclaw @agenticvault/agentic-vault
+# 安装到本地目录
+mkdir -p ./openclaw-plugins
+cd ./openclaw-plugins
+npm install @agenticvault/openclaw
 ```
 
+然后在 OpenClaw 主机配置中添加路径：
+
+```json
+{
+  "plugins": {
+    "load": {
+      "paths": ["./openclaw-plugins/node_modules/@agenticvault/openclaw"]
+    }
+  }
+}
+```
+
+> **建议**：生产环境请固定版本（`npm install @agenticvault/openclaw@0.1.1`），避免意外升级。
+
+> **已知限制**：`openclaw plugins install @agenticvault/openclaw` 可能遇到 installer ID 不匹配的问题。在上游修复前，请使用上述方式安装。
+
 ## 配置
 
-在 OpenClaw 代理配置中注册插件：
+在 OpenClaw 主机配置中注册插件。entries key 必须与 manifest `id`（`"agentic-vault"`）一致：
 
 ```json
 {
   "plugins": {
-    "agentic-vault": {
-      "package": "@agenticvault/openclaw",
-      "config": {
-        "keyId": "arn:aws:kms:us-east-1:123456789:key/your-key-id",
-        "region": "us-east-1",
-        "policyConfigPath": "./policy.json"
+    "entries": {
+      "agentic-vault": {
+        "config": {
+          "keyId": "arn:aws:kms:us-east-1:123456789:key/your-key-id",
+          "region": "us-east-1",
+          "policyConfigPath": "./policy.json",
+          "rpcUrl": "https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY"
+        }
       }
     }
   }
 }
 ```
 
+| 选项 | 必需 | 说明 |
+|------|------|------|
+| `keyId` | 是 | AWS KMS 密钥 ARN |
+| `region` | 是 | AWS 区域 |
+| `policyConfigPath` | 否 | 策略 JSON 文件路径（未指定时默认全部拒绝） |
+| `rpcUrl` | 否 | 余额/转账工具的 RPC 端点。使用 `vault_get_balance`、`vault_send_transfer`、`vault_send_erc20_transfer` 时必需。 |
+| `expectedAddress` | 否 | 用于验证的预期钱包地址 |
+| `enableUnsafeRawSign` | 否 | 启用原始签名工具（默认：`false`） |
+
 ## 可用工具
 
 ### 安全工具（默认启用）
@@ -41,6 +83,9 @@ npm install @agenticvault/openclaw @agenticvault/agentic-vault
 | `vault_health_check` | 检查保险库签名器的健康状态 |
 | `vault_sign_defi_call` | 在 calldata 解码与策略验证后签署 DeFi 合约交互 |
 | `vault_sign_permit` | 在策略验证后签署 EIP-2612 permit |
+| `vault_get_balance` | 查询原生代币或 ERC20 代币余额（需要 `rpcUrl`） |
+| `vault_send_transfer` | 发送原生 ETH 转账，含策略验证（需要 `rpcUrl`） |
+| `vault_send_erc20_transfer` | 发送 ERC20 代币转账，含策略验证（需要 `rpcUrl`） |
 
 ### 双重闸控工具（需要 `enableUnsafeRawSign: true`）
 
@@ -49,6 +94,18 @@ npm install @agenticvault/openclaw @agenticvault/agentic-vault
 | `vault_sign_transaction` | 签署原始 EVM 交易（绕过解码管线） |
 | `vault_sign_typed_data` | 签署原始 EIP-712 类型化数据（绕过解码管线） |
 
+## 从预发布 API 迁移
+
+插件入口点从预发布的 `register(api, config)` 变更为官方 SDK 合约 `export default function(api)`：
+
+| 之前（预发布） | 之后（当前） |
+|----------------|-------------|
+| `import { register } from "@agenticvault/openclaw"` | `export default function(api)` |
+| `register(api, config)` | 配置从 `api.pluginConfig` 读取 |
+| `api.registerTool(name, config, handler)` | `api.registerTool({ name, description, parameters, label, execute })` |
+
+插件现在使用官方 `openclaw/plugin-sdk` 类型，并可通过 `package.json` 中的 `openclaw` 字段被 OpenClaw 网关发现。
+
 ## 安全性
 
 - **默认拒绝** -- 所有签名操作皆需明确的策略批准

package/README.zh-TW.md

@@ -1,4 +1,4 @@
-<!-- Source: packages/openclaw-plugin/README.md | Commit: 96a8dcc | Last synced: 2026-02-16 -->
+<!-- Source: packages/openclaw-plugin/README.md | Last synced: 2026-02-19 -->
 
 # @agenticvault/openclaw
 
@@ -8,29 +8,71 @@
 
 ## 安裝
 
+### 透過 OpenClaw 主機設定（推薦）
+
+安裝套件及其 peer dependency，然後在 OpenClaw 主機設定中註冊：
+
+```bash
+npm install @agenticvault/openclaw openclaw
+```
+
+### 透過 `plugins.load.paths`（手動）
+
+若偏好明確控制插件載入，可將套件安裝至本地目錄，再將路徑指定給 OpenClaw：
+
 ```bash
-npm install @agenticvault/openclaw @agenticvault/agentic-vault
+# 安裝至本地目錄
+mkdir -p ./openclaw-plugins
+cd ./openclaw-plugins
+npm install @agenticvault/openclaw
 ```
 
+然後在 OpenClaw 主機設定中新增路徑：
+
+```json
+{
+  "plugins": {
+    "load": {
+      "paths": ["./openclaw-plugins/node_modules/@agenticvault/openclaw"]
+    }
+  }
+}
+```
+
+> **建議**：正式環境請固定版本（`npm install @agenticvault/openclaw@0.1.1`），避免意外升級。
+
+> **已知限制**：`openclaw plugins install @agenticvault/openclaw` 可能遇到 installer ID 不符的問題。在上游修復前，請使用上述方式安裝。
+
 ## 設定
 
-在 OpenClaw 代理設定中註冊插件：
+在 OpenClaw 主機設定中註冊插件。entries key 必須與 manifest `id`（`"agentic-vault"`）一致：
 
 ```json
 {
   "plugins": {
-    "agentic-vault": {
-      "package": "@agenticvault/openclaw",
-      "config": {
-        "keyId": "arn:aws:kms:us-east-1:123456789:key/your-key-id",
-        "region": "us-east-1",
-        "policyConfigPath": "./policy.json"
+    "entries": {
+      "agentic-vault": {
+        "config": {
+          "keyId": "arn:aws:kms:us-east-1:123456789:key/your-key-id",
+          "region": "us-east-1",
+          "policyConfigPath": "./policy.json",
+          "rpcUrl": "https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY"
+        }
       }
     }
   }
 }
 ```
 
+| 選項 | 必要 | 說明 |
+|------|------|------|
+| `keyId` | 是 | AWS KMS 金鑰 ARN |
+| `region` | 是 | AWS 區域 |
+| `policyConfigPath` | 否 | 策略 JSON 檔案路徑（未指定時預設全部拒絕） |
+| `rpcUrl` | 否 | 餘額/轉帳工具的 RPC 端點。使用 `vault_get_balance`、`vault_send_transfer`、`vault_send_erc20_transfer` 時必要。 |
+| `expectedAddress` | 否 | 用於驗證的預期錢包地址 |
+| `enableUnsafeRawSign` | 否 | 啟用原始簽署工具（預設：`false`） |
+
 ## 可用工具
 
 ### 安全工具（預設啟用）
@@ -41,6 +83,9 @@ npm install @agenticvault/openclaw @agenticvault/agentic-vault
 | `vault_health_check` | 檢查保險庫簽署器的健康狀態 |
 | `vault_sign_defi_call` | 在 calldata 解碼與策略驗證後簽署 DeFi 合約互動 |
 | `vault_sign_permit` | 在策略驗證後簽署 EIP-2612 permit |
+| `vault_get_balance` | 查詢原生代幣或 ERC20 代幣餘額（需要 `rpcUrl`） |
+| `vault_send_transfer` | 發送原生 ETH 轉帳，含策略驗證（需要 `rpcUrl`） |
+| `vault_send_erc20_transfer` | 發送 ERC20 代幣轉帳，含策略驗證（需要 `rpcUrl`） |
 
 ### 雙重閘控工具（需要 `enableUnsafeRawSign: true`）
 
@@ -49,6 +94,18 @@ npm install @agenticvault/openclaw @agenticvault/agentic-vault
 | `vault_sign_transaction` | 簽署原始 EVM 交易（繞過解碼管線） |
 | `vault_sign_typed_data` | 簽署原始 EIP-712 型別化資料（繞過解碼管線） |
 
+## 從預發布 API 遷移
+
+插件進入點從預發布的 `register(api, config)` 變更為官方 SDK 合約 `export default function(api)`：
+
+| 之前（預發布） | 之後（目前） |
+|----------------|-------------|
+| `import { register } from "@agenticvault/openclaw"` | `export default function(api)` |
+| `register(api, config)` | 設定從 `api.pluginConfig` 讀取 |
+| `api.registerTool(name, config, handler)` | `api.registerTool({ name, description, parameters, label, execute })` |
+
+插件現在使用官方 `openclaw/plugin-sdk` 型別，並可透過 `package.json` 中的 `openclaw` 欄位被 OpenClaw 閘道發現。
+
 ## 安全性
 
 - **預設拒絕** -- 所有簽署操作皆需明確的策略核准

package/dist/context.js

@@ -1,4 +1,4 @@
-import { createSigningProvider, EvmSignerAdapter, } from '@agenticvault/agentic-vault';
+import { createSigningProvider, EvmSignerAdapter, ViemRpcProvider, } from '@agenticvault/agentic-vault';
 import { PolicyEngine, erc20Evaluator, uniswapV3Evaluator, aaveV3Evaluator, ProtocolDispatcher, createDefaultRegistry, loadPolicyConfigFromFile, } from '@agenticvault/agentic-vault/protocols';
 const DEFAULT_POLICY = {
     allowedChainIds: [],
@@ -36,11 +36,15 @@ export function buildContext(config) {
     ]);
     const dispatcher = new ProtocolDispatcher(createDefaultRegistry());
     const auditSink = createAuditSink();
+    const rpcProvider = config.rpcUrl
+        ? new ViemRpcProvider({ rpcUrl: config.rpcUrl })
+        : undefined;
     return {
         signer,
         policyEngine,
         auditSink,
         dispatcher,
+        rpcProvider,
         caller: 'openclaw',
         service: 'agentic-vault-openclaw',
     };

package/dist/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,wBAAwB,GAIzB,MAAM,uCAAuC,CAAC;AAG/C,MAAM,cAAc,GAAmB;IACrC,eAAe,EAAE,EAAE;IACnB,gBAAgB,EAAE,EAAE;IACpB,gBAAgB,EAAE,EAAE;IACpB,YAAY,EAAE,EAAE;IAChB,kBAAkB,EAAE,CAAC;CACtB,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAA4B;IACvD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,QAAQ,GAAG,qBAAqB,CAAC;QACrC,QAAQ,EAAE,SAAS;QACnB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,QAAQ,EAAE;QAC5C,eAAe,EAAE,MAAM,CAAC,eAA4C;KACrE,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,MAAM,CAAC,gBAAgB;QAC1C,CAAC,CAAC,wBAAwB,CAAC,MAAM,CAAC,gBAAgB,CAAC;QACnD,CAAC,CAAC,cAAc,CAAC;IACnB,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,YAAY,EAAE;QAClD,cAAc;QACd,kBAAkB;QAClB,eAAe;KAChB,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,IAAI,kBAAkB,CAAC,qBAAqB,EAAE,CAAC,CAAC;IACnE,MAAM,SAAS,GAAG,eAAe,EAAE,CAAC;IAEpC,OAAO;QACL,MAAM;QACN,YAAY;QACZ,SAAS;QACT,UAAU;QACV,MAAM,EAAE,UAAU;QAClB,OAAO,EAAE,wBAAwB;KAClC,CAAC;AACJ,CAAC;AAED,8DAA8D;AAC9D,SAAS,eAAe;IACtB,OAAO;QACL,GAAG,CAAC,KAAK;YACP,MAAM,IAAI,GAAG;gBACX,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE;gBAC5B,GAAG,KAAK;aACT,CAAC;YACF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;YAClD,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,GAChB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,wBAAwB,GAIzB,MAAM,uCAAuC,CAAC;AAG/C,MAAM,cAAc,GAAmB;IACrC,eAAe,EAAE,EAAE;IACnB,gBAAgB,EAAE,EAAE;IACpB,gBAAgB,EAAE,EAAE;IACpB,YAAY,EAAE,EAAE;IAChB,kBAAkB,EAAE,CAAC;CACtB,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAA4B;IACvD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,QAAQ,GAAG,qBAAqB,CAAC;QACrC,QAAQ,EAAE,SAAS;QACnB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,QAAQ,EAAE;QAC5C,eAAe,EAAE,MAAM,CAAC,eAA4C;KACrE,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,MAAM,CAAC,gBAAgB;QAC1C,CAAC,CAAC,wBAAwB,CAAC,MAAM,CAAC,gBAAgB,CAAC;QACnD,CAAC,CAAC,cAAc,CAAC;IACnB,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,YAAY,EAAE;QAClD,cAAc;QACd,kBAAkB;QAClB,eAAe;KAChB,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,IAAI,kBAAkB,CAAC,qBAAqB,EAAE,CAAC,CAAC;IACnE,MAAM,SAAS,GAAG,eAAe,EAAE,CAAC;IAEpC,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM;QAC/B,CAAC,CAAC,IAAI,eAAe,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;QAChD,CAAC,CAAC,SAAS,CAAC;IAEd,OAAO;QACL,MAAM;QACN,YAAY;QACZ,SAAS;QACT,UAAU;QACV,WAAW;QACX,MAAM,EAAE,UAAU;QAClB,OAAO,EAAE,wBAAwB;KAClC,CAAC;AACJ,CAAC;AAED,8DAA8D;AAC9D,SAAS,eAAe;IACtB,OAAO;QACL,GAAG,CAAC,KAAK;YACP,MAAM,IAAI,GAAG;gBACX,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE;gBAC5B,GAAG,KAAK;aACT,CAAC;YACF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;YAClD,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-export { type OpenClawPluginApi, type OpenClawToolConfig, type OpenClawParameter, type OpenClawToolHandler, type OpenClawToolResult, type OpenClawPluginConfig, } from './types.js';
-export { buildContext } from './context.js';
-export { registerTools } from './tools.js';
-import { type OpenClawPluginApi, type OpenClawPluginConfig } from './types.js';
+import { type OpenClawPluginApi } from './types.js';
 /**
  * OpenClaw plugin entry point.
  * Called by the OpenClaw host to register vault signing tools.
  */
-export declare function register(api: OpenClawPluginApi, config: OpenClawPluginConfig): void;
+export default function (api: OpenClawPluginApi): void;
+export { type OpenClawPluginConfig } from './types.js';
+export { buildContext } from './context.js';
+export { registerTools } from './tools.js';

package/dist/index.js

@@ -1,13 +1,14 @@
-export { buildContext } from './context.js';
-export { registerTools } from './tools.js';
 import { buildContext } from './context.js';
 import { registerTools } from './tools.js';
 /**
  * OpenClaw plugin entry point.
  * Called by the OpenClaw host to register vault signing tools.
  */
-export function register(api, config) {
+export default function (api) {
+    const config = (api.pluginConfig ?? {});
     const ctx = buildContext(config);
     registerTools(api, ctx, config);
 }
+export { buildContext } from './context.js';
+export { registerTools } from './tools.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG3C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C;;;GAGG;AACH,MAAM,UAAU,QAAQ,CACtB,GAAsB,EACtB,MAA4B;IAE5B,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACjC,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;AAClC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C;;;GAGG;AACH,MAAM,CAAC,OAAO,WAAW,GAAsB;IAC7C,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAoC,CAAC;IAC3E,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACjC,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;AAClC,CAAC;AAGD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/tools.d.ts

@@ -2,7 +2,7 @@ import { type WorkflowContext } from '@agenticvault/agentic-vault/protocols';
 import { type OpenClawPluginApi, type OpenClawPluginConfig } from './types.js';
 /**
  * Register all OpenClaw tools.
- * 4 safe tools are always registered.
+ * 7 safe tools are always registered.
  * 2 dual-gated tools are only registered when enableUnsafeRawSign is true.
  */
 export declare function registerTools(api: OpenClawPluginApi, ctx: WorkflowContext, config: OpenClawPluginConfig): void;