@x402sentinel/openclaw-sentinel 0.1.1 → 0.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +60 -32
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -4,7 +4,7 @@
4
4
 
5
5
  <p align="center">
6
6
  <strong>@x402sentinel/openclaw-sentinel</strong><br/>
7
- Budget enforcement & audit trails for OpenClaw x402 payments.
7
+ Audit & compliance layer for OpenClaw x402 payments.
8
8
  </p>
9
9
 
10
10
  <p align="center">
@@ -20,9 +20,22 @@
20
20
 
21
21
  ---
22
22
 
23
- Wraps every x402 HTTP payment your OpenClaw agent makes with Sentinel's
24
- spend controls and audit logging. No code changes to your agent — just
25
- install the plugin and set your limits.
23
+ Every x402 payment your OpenClaw agent makes is logged,
24
+ attributed, and exportable. Built for teams that need to
25
+ know exactly what their agents are spending and why.
26
+
27
+ ## What it does
28
+
29
+ - **Audit trails** — every x402 payment recorded with agent ID,
30
+ endpoint, amount, network, tx hash, and timestamp
31
+ - **Compliance-ready exports** — CSV and PDF reports for finance
32
+ teams, auditors, and regulators
33
+ - **Real-time dashboard** — filter by agent, endpoint, network,
34
+ date range at sentinel.valeocash.com
35
+ - **Budget guardrails** — optional per-call, hourly, and daily
36
+ limits to prevent runaway spend
37
+ - **Multi-agent attribution** — track which agent spent what
38
+ across your entire fleet
26
39
 
27
40
  ## Install
28
41
 
@@ -32,8 +45,6 @@ openclaw plugin install @x402sentinel/openclaw-sentinel
32
45
 
33
46
  ## Configure
34
47
 
35
- Add the plugin to your OpenClaw config:
36
-
37
48
  ```jsonc
38
49
  // ~/.openclaw/openclaw.json
39
50
  {
@@ -43,10 +54,7 @@ Add the plugin to your OpenClaw config:
43
54
  "enabled": true,
44
55
  "config": {
45
56
  "apiKey": "sk_sentinel_...",
46
- "agentId": "my-openclaw-agent",
47
- "maxPerCall": 1.00,
48
- "maxPerHour": 25.00,
49
- "maxPerDay": 200.00
57
+ "agentId": "my-openclaw-agent"
50
58
  }
51
59
  }
52
60
  }
@@ -54,36 +62,56 @@ Add the plugin to your OpenClaw config:
54
62
  }
55
63
  ```
56
64
 
57
- ### Config options
65
+ Get your API key at [sentinel.valeocash.com/dashboard/settings](https://sentinel.valeocash.com/dashboard/settings).
66
+
67
+ ### Optional: Budget limits
58
68
 
59
- | Option | Type | Default | Description |
60
- |--------|------|---------|-------------|
61
- | `apiKey` | string | *required* | Sentinel API key |
62
- | `apiUrl` | string | `https://sentinel.valeocash.com` | Sentinel dashboard URL |
63
- | `agentId` | string | `openclaw-agent` | Agent ID in audit trails |
64
- | `maxPerCall` | number | `1.00` | Max USDC per single x402 call |
65
- | `maxPerHour` | number | `25.00` | Max USDC per hour |
66
- | `maxPerDay` | number | `200.00` | Max USDC per day |
69
+ ```json
70
+ {
71
+ "maxPerCall": 1.00,
72
+ "maxPerHour": 25.00,
73
+ "maxPerDay": 200.00
74
+ }
75
+ ```
67
76
 
68
- ## Features
77
+ ## How it works
69
78
 
70
- - **Budget enforcement** — blocks payments exceeding per-call, hourly, or daily USDC limits before they execute
71
- - **Audit logging** — every x402 payment is logged to your Sentinel dashboard with agent ID, endpoint, amount, tx hash, and timing
72
- - **`sentinel_status` tool** — your agent can check its own budget status and remaining spend at any time
73
- - **Zero config** — sensible defaults out of the box, customize only what you need
79
+ 1. Plugin wraps your agent's x402 HTTP calls
80
+ 2. Every payment is logged to your Sentinel dashboard
81
+ 3. Each record includes: agent, endpoint, amount, network,
82
+ tx hash, status, timestamp
83
+ 4. View, filter, and export at sentinel.valeocash.com
74
84
 
75
85
  ## Dashboard
76
86
 
77
- View all payments, filter by agent or endpoint, and export CSV reports:
87
+ View all payments, agents, and endpoints:
78
88
 
79
- **[sentinel.valeocash.com/dashboard](https://sentinel.valeocash.com/dashboard)**
89
+ **[sentinel.valeocash.com](https://sentinel.valeocash.com)**
80
90
 
81
- ## Get API Key
91
+ - Filter by agent, endpoint, network, time range
92
+ - Export CSV for auditors
93
+ - Export PDF audit reports
94
+ - Public explorer for ecosystem-wide x402 data
95
+
96
+ ## Built-in tool: `sentinel_status`
97
+
98
+ Your agent can check its own audit trail:
99
+
100
+ ```
101
+ > sentinel_status
102
+
103
+ Agent: my-openclaw-agent
104
+ Total spent: $12.45
105
+ Transactions: 847
106
+ Dashboard: sentinel.valeocash.com/dashboard
107
+ ```
82
108
 
83
- 1. Sign up at [sentinel.valeocash.com](https://sentinel.valeocash.com)
84
- 2. Go to **Settings** → **Generate API Key**
85
- 3. Add the key to your `openclaw.json` config
109
+ ## Part of the Valeo ecosystem
86
110
 
87
- ## License
111
+ Sentinel is the compliance layer for x402.
112
+ Built by [Valeo](https://sentinel.valeocash.com).
88
113
 
89
- MIT — see [LICENSE](./LICENSE)
114
+ - **SDK:** [@x402sentinel/x402](https://www.npmjs.com/package/@x402sentinel/x402)
115
+ - **Dashboard:** [sentinel.valeocash.com](https://sentinel.valeocash.com)
116
+ - **Docs:** [sentinel.valeocash.com/docs](https://sentinel.valeocash.com/docs)
117
+ - **Explorer:** [sentinel.valeocash.com/explorer](https://sentinel.valeocash.com/explorer)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@x402sentinel/openclaw-sentinel",
3
- "version": "0.1.1",
3
+ "version": "0.1.3",
4
4
  "description": "Budget enforcement & audit trails for OpenClaw x402 payments",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",