{"_id":"@agenticvault/agentic-vault-openclaw","_rev":"2-ad20c6f04ed29dea63c6c50a5cfa92eb","name":"@agenticvault/agentic-vault-openclaw","dist-tags":{"latest":"0.1.4"},"versions":{"0.1.3":{"name":"@agenticvault/agentic-vault-openclaw","version":"0.1.3","keywords":["openclaw","plugin","agentic-vault","evm","signing","aws-kms","ai-agent"],"license":"MIT","_id":"@agenticvault/agentic-vault-openclaw@0.1.3","maintainers":[{"name":"sd0xdev","email":"frowns.0-exempts@icloud.com"}],"homepage":"https://github.com/agenticvault/agentic-vault/tree/main/packages/openclaw-plugin#readme","bugs":{"url":"https://github.com/agenticvault/agentic-vault/issues"},"bin":{"agentic-vault-setup":"dist/install.js"},"dist":{"shasum":"6aa63c7b9cf1ecb86bf0a12282806861627b56f1","tarball":"https://registry.npmjs.org/@agenticvault/agentic-vault-openclaw/-/agentic-vault-openclaw-0.1.3.tgz","fileCount":23,"integrity":"sha512-BsiwCh3YxQFGe9/r9twcBuMg3U31R01Sy10N0yBUVsCENUTFbQd+8blZIxTW2GZ54SWvVonyBdp1mLuEcdOQXA==","signatures":[{"sig":"MEUCIHt+fCAK/W1E1Se6yiIzblgcyVHAHvFA7W+YsuzklbI2AiEAl//bvypCmUe0NhjXuO3GRH0cu8TYwnevUuN/B+GufHs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":85499},"main":"./dist/index.js","type":"module","_from":"file:agenticvault-agentic-vault-openclaw-0.1.3.tgz","types":"./dist/index.d.ts","engines":{"node":">=22"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./openclaw.plugin.json":"./openclaw.plugin.json"},"scripts":{"lint":"eslint src/ test/","build":"tsc -b","lint:fix":"eslint src/ test/ --fix","test:unit":"vitest run test/unit/","typecheck":"tsc -p tsconfig.check.json","test:integration":"vitest run test/integration/"},"_npmUser":{"name":"sd0xdev","email":"frowns.0-exempts@icloud.com"},"openclaw":{"extensions":["./dist/index.js"]},"_resolved":"/Users/yuhao/Project/agentic-vault/packages/openclaw-plugin/agenticvault-agentic-vault-openclaw-0.1.3.tgz","_integrity":"sha512-BsiwCh3YxQFGe9/r9twcBuMg3U31R01Sy10N0yBUVsCENUTFbQd+8blZIxTW2GZ54SWvVonyBdp1mLuEcdOQXA==","repository":{"url":"git+https://github.com/agenticvault/agentic-vault.git","type":"git","directory":"packages/openclaw-plugin"},"_npmVersion":"11.6.2","description":"OpenClaw plugin for Agentic Vault — expose EVM signing as OpenClaw agent tools","directories":{},"_nodeVersion":"24.13.0","dependencies":{"@agenticvault/agentic-vault":"~0.1.2"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^9.39.2","vitest":"^4.0.18","openclaw":"^2026.2.17","@eslint/js":"^9.39.2","typescript":"^5.9.3","typescript-eslint":"^8.55.0","@agenticvault/agentic-vault":"0.1.2"},"peerDependencies":{"openclaw":">=2026.1.0","@agenticvault/agentic-vault":"~0.1.2"},"_npmOperationalInternal":{"tmp":"tmp/agentic-vault-openclaw_0.1.3_1771571659611_0.6862700785718419","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@agenticvault/agentic-vault-openclaw","version":"0.1.4","description":"OpenClaw plugin for Agentic Vault — expose EVM signing as OpenClaw agent tools","type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","bin":{"agentic-vault-setup":"dist/install.js"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./openclaw.plugin.json":"./openclaw.plugin.json"},"engines":{"node":">=22"},"repository":{"type":"git","url":"git+https://github.com/agenticvault/agentic-vault.git","directory":"packages/openclaw-plugin"},"license":"MIT","bugs":{"url":"https://github.com/agenticvault/agentic-vault/issues"},"homepage":"https://github.com/agenticvault/agentic-vault/tree/main/packages/openclaw-plugin#readme","publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"keywords":["openclaw","plugin","agentic-vault","evm","signing","aws-kms","ai-agent"],"openclaw":{"extensions":["./dist/index.js"]},"dependencies":{"@agenticvault/agentic-vault":"~0.1.2"},"peerDependencies":{"@agenticvault/agentic-vault":"~0.1.4","openclaw":">=2026.1.0"},"devDependencies":{"@eslint/js":"^9.39.2","eslint":"^9.39.2","openclaw":"^2026.2.17","typescript":"^5.9.3","typescript-eslint":"^8.55.0","vitest":"^4.0.18","@agenticvault/agentic-vault":"0.1.2"},"scripts":{"build":"tsc -b","typecheck":"tsc -p tsconfig.check.json","lint":"eslint src/ test/","lint:fix":"eslint src/ test/ --fix","test:unit":"vitest run test/unit/","test:integration":"vitest run test/integration/"},"_id":"@agenticvault/agentic-vault-openclaw@0.1.4","_integrity":"sha512-OJOaScZpoT65qUVvw9YyuYpD18eyiJh0hbnJylZqX0NPOo/dHW6ww+FgOASCj4mrTM4dcPMTq4A/K5UYL6Rykg==","_resolved":"/home/runner/work/agentic-vault/agentic-vault/packages/openclaw-plugin/agenticvault-agentic-vault-openclaw-0.1.4.tgz","_from":"file:agenticvault-agentic-vault-openclaw-0.1.4.tgz","_nodeVersion":"24.13.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-OJOaScZpoT65qUVvw9YyuYpD18eyiJh0hbnJylZqX0NPOo/dHW6ww+FgOASCj4mrTM4dcPMTq4A/K5UYL6Rykg==","shasum":"bacaad28ef6b8ee27705fa790ca26d32f085bf84","tarball":"https://registry.npmjs.org/@agenticvault/agentic-vault-openclaw/-/agentic-vault-openclaw-0.1.4.tgz","fileCount":23,"unpackedSize":85249,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agenticvault%2fagentic-vault-openclaw@0.1.4","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCjqP5c/8MuJiYFK9F3ERnwXvBsu44IMAknHm6z9Q+A6QIgK6m5fSbsL43FvViDY9CT8HEmu8+hv7gsYZaUPGAkfRg="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:c3b8b4f5-4fc7-4762-9136-b8409a4a31da"}},"directories":{},"maintainers":[{"name":"sd0xdev","email":"frowns.0-exempts@icloud.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agentic-vault-openclaw_0.1.4_1771586384128_0.7316545208127498"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-20T07:14:19.548Z","modified":"2026-02-20T11:19:44.876Z","0.1.3":"2026-02-20T07:14:19.779Z","0.1.4":"2026-02-20T11:19:44.275Z"},"bugs":{"url":"https://github.com/agenticvault/agentic-vault/issues"},"license":"MIT","homepage":"https://github.com/agenticvault/agentic-vault/tree/main/packages/openclaw-plugin#readme","keywords":["openclaw","plugin","agentic-vault","evm","signing","aws-kms","ai-agent"],"repository":{"type":"git","url":"git+https://github.com/agenticvault/agentic-vault.git","directory":"packages/openclaw-plugin"},"description":"OpenClaw plugin for Agentic Vault — expose EVM signing as OpenClaw agent tools","maintainers":[{"name":"sd0xdev","email":"frowns.0-exempts@icloud.com"}],"readme":"<!-- Source: packages/openclaw-plugin/README.md | Last synced: 2026-02-20 -->\n\n# @agenticvault/agentic-vault-openclaw\n\n[English](README.md) | 繁體中文 | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [한국어](README.ko.md)\n\n[Agentic Vault](https://github.com/agenticvault/agentic-vault) 的 OpenClaw 插件 -- 將伺服器端 EVM 簽章暴露為 OpenClaw 代理工具，搭配預設拒絕的策略引擎。\n\n## 安裝\n\n### OpenClaw CLI（推薦）\n\n```bash\nopenclaw plugins install @agenticvault/agentic-vault-openclaw\n```\n\n驗證：\n\n```bash\nopenclaw plugins list\n```\n\n### npx 安裝器（替代方案）\n\n```bash\nnpx -y -p @agenticvault/agentic-vault-openclaw agentic-vault-setup\n```\n\n此指令會將插件檔案複製至 `~/.openclaw/extensions/agentic-vault-openclaw/`、安裝 runtime 依賴，並印出設定片段。\n\n### 手動安裝\n\n```bash\nnpm install @agenticvault/agentic-vault-openclaw\nmkdir -p ~/.openclaw/extensions/agentic-vault-openclaw\ncp -r ./node_modules/@agenticvault/agentic-vault-openclaw/* ~/.openclaw/extensions/agentic-vault-openclaw/\ncd ~/.openclaw/extensions/agentic-vault-openclaw && npm install --omit=dev --ignore-scripts\n```\n\nOpenClaw 會自動偵測 `~/.openclaw/extensions/` 下的插件。目錄名稱必須與 manifest `id`（`agentic-vault-openclaw`）一致。\n\n### 從 Tarball 安裝\n\n```bash\nnpm pack @agenticvault/agentic-vault-openclaw --pack-destination /tmp\nmkdir -p ~/.openclaw/extensions/agentic-vault-openclaw\ntar -xzf /tmp/agenticvault-agentic-vault-openclaw-*.tgz -C ~/.openclaw/extensions/agentic-vault-openclaw --strip-components=1\ncd ~/.openclaw/extensions/agentic-vault-openclaw && npm install --omit=dev --ignore-scripts\n```\n\n### 開發模式（Symlink）\n\n```bash\nmkdir -p ~/.openclaw/extensions\nln -sfn \"$(pwd)/packages/openclaw-plugin\" ~/.openclaw/extensions/agentic-vault-openclaw\n```\n\n### 透過 `plugins.load.paths`（進階）\n\n若需完整控制插件載入路徑：\n\n```bash\nmkdir -p /home/user/my-workspace/.openclaw/extensions\ncd /home/user/my-workspace/.openclaw/extensions\nnpm install @agenticvault/agentic-vault-openclaw\n```\n\n然後在 OpenClaw 主機設定中新增路徑（正式/背景服務環境請使用絕對路徑）：\n\n```json\n{\n  \"plugins\": {\n    \"load\": {\n      \"paths\": [\"/home/user/my-workspace/.openclaw/extensions/node_modules/@agenticvault/agentic-vault-openclaw\"]\n    }\n  }\n}\n```\n\n> **建議**：正式環境請固定版本（`npm install @agenticvault/agentic-vault-openclaw@0.1.3`），避免意外升級。\n\n## 設定\n\n在 OpenClaw 主機設定中註冊插件。entries key 必須與 manifest `id`（`\"agentic-vault-openclaw\"`）一致。若設定中使用了 `plugins.allow`，需加入 `\"agentic-vault-openclaw\"`：\n\n```json\n{\n  \"plugins\": {\n    \"allow\": [\"agentic-vault-openclaw\"],\n    \"entries\": {\n      \"agentic-vault-openclaw\": {\n        \"config\": {\n          \"keyId\": \"arn:aws:kms:us-east-1:123456789:key/your-key-id\",\n          \"region\": \"us-east-1\",\n          \"policyConfigPath\": \"/home/user/agentic-vault/policy.json\",\n          \"rpcUrl\": \"https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY\"\n        }\n      }\n    }\n  }\n}\n```\n\n| 選項 | 必要 | 說明 |\n|------|------|------|\n| `keyId` | 是 | AWS KMS 金鑰 ARN |\n| `region` | 是 | AWS 區域 |\n| `policyConfigPath` | 否 | 策略 JSON 檔案路徑（未指定時預設全部拒絕） |\n| `rpcUrl` | 否 | 餘額/轉帳工具的 RPC 端點。使用 `vault_get_balance`、`vault_send_transfer`、`vault_send_erc20_transfer` 時必要。 |\n| `expectedAddress` | 否 | 用於驗證的預期錢包地址 |\n| `enableUnsafeRawSign` | 否 | 啟用原始簽署工具（預設：`false`） |\n\n## 可用工具\n\n### 安全工具（預設啟用）\n\n| 工具 | 說明 |\n|------|------|\n| `vault_get_address` | 取得此保險庫管理的錢包地址 |\n| `vault_health_check` | 檢查保險庫簽署器的健康狀態 |\n| `vault_sign_defi_call` | 在 calldata 解碼與策略驗證後簽署 DeFi 合約互動 |\n| `vault_sign_permit` | 在策略驗證後簽署 EIP-2612 permit |\n| `vault_get_balance` | 查詢原生代幣或 ERC20 代幣餘額（需要 `rpcUrl`） |\n| `vault_send_transfer` | 發送原生 ETH 轉帳，含策略驗證（需要 `rpcUrl`） |\n| `vault_send_erc20_transfer` | 發送 ERC20 代幣轉帳，含策略驗證（需要 `rpcUrl`） |\n\n### 雙重閘控工具（需要 `enableUnsafeRawSign: true`）\n\n| 工具 | 說明 |\n|------|------|\n| `vault_sign_transaction` | 簽署原始 EVM 交易（繞過解碼管線） |\n| `vault_sign_typed_data` | 簽署原始 EIP-712 型別化資料（繞過解碼管線） |\n\n## 從預發布 API 遷移\n\n插件進入點從預發布的 `register(api, config)` 變更為官方 SDK 合約 `export default function(api)`：\n\n| 之前（預發布） | 之後（目前） |\n|----------------|-------------|\n| `import { register } from \"@agenticvault/agentic-vault-openclaw\"` | `export default function(api)` |\n| `register(api, config)` | 設定從 `api.pluginConfig` 讀取 |\n| `api.registerTool(name, config, handler)` | `api.registerTool({ name, description, parameters, label, execute })` |\n\n插件現在使用官方 `openclaw/plugin-sdk` 型別，並可透過 `package.json` 中的 `openclaw` 欄位被 OpenClaw 閘道發現。\n\n## 安全性\n\n- **預設拒絕** -- 所有簽署操作皆需明確的策略核准\n- **失敗關閉** -- 未知 calldata 一律拒絕\n- **雙重閘控原始簽署** -- `vault_sign_transaction` 與 `vault_sign_typed_data` 預設停用；啟用需在插件設定中指定 `enableUnsafeRawSign: true`\n- **稽核軌跡** -- 每次操作皆以結構化 JSON 記錄\n\n## 多代理環境強化\n\n在多代理環境中，將 vault 工具限制給指定的金融代理。在非金融代理的 `tools.deny` 中加入所有 `vault_*` 工具名稱：\n\n```json\n{\n  \"agents\": {\n    \"general-assistant\": {\n      \"tools\": {\n        \"deny\": [\n          \"vault_get_address\", \"vault_health_check\", \"vault_get_balance\",\n          \"vault_sign_defi_call\", \"vault_sign_permit\",\n          \"vault_send_transfer\", \"vault_send_erc20_transfer\",\n          \"vault_sign_transaction\", \"vault_sign_typed_data\"\n        ]\n      }\n    }\n  }\n}\n```\n\n## 策略設定\n\n請參閱主專案的[策略設定文件](https://github.com/agenticvault/agentic-vault#configuration)與 [`policy.example.json`](https://github.com/agenticvault/agentic-vault/blob/main/policy.example.json) 取得完整範例。\n\n## 授權\n\n[MIT](LICENSE)\n","readmeFilename":"README.zh-TW.md"}