代码插件

StablePay OpenClaw Plugin — 稳定支付 OpenClaw 插件（钱包、签名、支付工具）

v0.2.0

StablePay OpenClaw 插件提供客户端钱包管理、DID 注册、本地/OWS 签名和支付工具。支持多种驱动模式（ows-sdk、ows-rest、ows-cli、local-dev），确保在不同环境下稳定运行。适用于开发者在 OpenClaw 中进行稳定支付流程的开发和测试。

0· 0·0 当前0

by @bubblevan

开发工具安全自动化存储部署系统工具容器与虚拟化

下载插件包项目主页

最后更新

2026/4/10

版本

latestv0.2.02026/4/5

安装命令

点击复制

官方npx clawhub@latest install stablepay-openclaw-plugin

镜像加速npx clawhub@latest install stablepay-openclaw-plugin --registry https://cn.clawhub-mirror.com

插件文档

OpenClaw 插件，处理客户端钱包、签名和支付策略方面的 StablePay 流程。

验证状态

stablepay_runtime_status 确认于 2026-03-31 工作正常：

{
  "requested_driver": "auto",
  "active_driver": "local-dev",
  "available_drivers": ["local-dev"],
  "local_state_path": "/home/bubblevan/.stablepay-openclaw/stablepay-local-state.enc",
  "has_wallet": false,
  "wallet": null,
  "payment_config": null,
  "policy": null,
  "notes": [
    "OWS Node SDK 在此环境下无法加载。当前 Windows 机器上，官方包尚未提供 win32 本地绑定。",
    "插件将使用本地 AES-256-GCM 加密状态文件作为当前开发回退。适合本地 OpenClaw 演示，但不是最终 OWS 密钥管理模型。"
  ]
}

DID 与私钥模型（重要）

API	用途	私钥位置
`POST /api/v1/did`（默认 `didRegisterPath`）	契约主路径（PRD/tech）；`stablepay_register_local_did`	客户端 / OWS Vault；服务端只存公钥
`POST /api/v1/did/register`	与上一行同一逻辑的兼容别名	同上

服务端不生成、不托管用户私钥。路由说明见 api-gateway/docs/did-flow.md。

运行时模型

驱动	激活条件	备注
`ows-sdk`	`@open-wallet-standard/core` 可加载	进程内签名（Linux/macOS 等）
`ows-rest`	配置了 `owsRestBaseUrl` + `STABLEPAY_OWS_REST_API_KEY`（或自定义 env）	HTTP `SignMessageRequest` → hex `signature`
`ows-cli` / `wsl-ows`	`ows` 在 PATH 且可选用	子进程 `ows sign message --json`
`local-dev`	兜底	AES-256-GCM 加密状态文件 `~/.stablepay-openclaw/`

auto 优先级：ows-sdk →（若配置了 REST 且存在 API key）ows-rest → ows-cli → local-dev。Windows 上常无 OWS 原生绑定，会落到 local-dev 或你在 WSL 里用 ows-cli。

WSL 端到端步骤见 docs/ows-wsl-e2e.md。

安装

WSL（必需 — 不要从 `/mnt/d/` 安装）

... （由于内容过长，仅保留部分关键翻译，完整内容请参考原文） ...

工具

本地钱包运行时（新）

工具	功能
`stablepay_runtime_status`	显示活跃驱动、钱包存在、状态路径、支付配置、策略
...	...

测试序列

烟雾测试（首先运行）

... （同样由于内容过长，仅保留部分关键翻译） ...

故障排除

症状	可能原因	解决方案
`world-writable path (mode=777)`	安装从 `/mnt/d/`	复制到 `~/` 首先
...	...	...

开发

npm install
npm run check  # TypeScript 类型检查，无输出
npm run build  # 编译 src/ → dist/，安装前必需

OpenClaw 加载 dist/index.js（编译输出）。每次源代码修改后，需重新构建和安装插件才能在网关中生效。

数据来源：ClawHub ↗ · 中文优化：龙虾技能库

版本