@dominusnode/openclaw-plugin 1.1.0 → 1.3.0

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 (4) hide show
  1. package/README.md +89 -67
  2. package/dist/plugin.d.ts +1 -1
  3. package/dist/plugin.js +1459 -74
  4. package/package.json +3 -1
package/README.md CHANGED
@@ -37,10 +37,10 @@ cd Dominus Node/integrations/openclaw
37
37
 
38
38
  ## Configuration
39
39
 
40
- | Environment Variable | Required | Default | Description |
41
- |---|---|---|---|
42
- | `DOMINUSNODE_API_KEY` | Yes | -- | Your Dominus Node API key (starts with `dn_live_` or `dn_test_`) |
43
- | `DOMINUSNODE_BASE_URL` | No | `https://api.dominusnode.com` | Base URL for the Dominus Node REST API |
40
+ | Environment Variable | Required | Default | Description |
41
+ | ---------------------- | -------- | ----------------------------- | ---------------------------------------------------------------- |
42
+ | `DOMINUSNODE_API_KEY` | Yes | -- | Your Dominus Node API key (starts with `dn_live_` or `dn_test_`) |
43
+ | `DOMINUSNODE_BASE_URL` | No | `https://api.dominusnode.com` | Base URL for the Dominus Node REST API |
44
44
 
45
45
  ### Getting an API Key
46
46
 
@@ -54,147 +54,169 @@ cd Dominus Node/integrations/openclaw
54
54
  ### Proxy Tools
55
55
 
56
56
  #### `proxied_fetch`
57
+
57
58
  Fetch a URL through the proxy network with optional geo-targeting.
58
59
 
59
- | Parameter | Type | Required | Description |
60
- |---|---|---|---|
61
- | `url` | string | Yes | The URL to fetch (http or https) |
62
- | `method` | string | No | HTTP method (GET, POST, PUT, DELETE, PATCH, HEAD). Default: GET |
63
- | `country` | string | No | ISO 3166-1 alpha-2 country code (e.g., US, GB, DE) |
64
- | `pool` | string | No | Proxy pool: `dc` (datacenter, $3/GB) or `residential` ($5/GB). Default: dc |
65
- | `headers` | object | No | Additional HTTP headers as key-value pairs |
66
- | `body` | string | No | Request body for POST/PUT/PATCH |
60
+ | Parameter | Type | Required | Description |
61
+ | --------- | ------ | -------- | -------------------------------------------------------------------------- |
62
+ | `url` | string | Yes | The URL to fetch (http or https) |
63
+ | `method` | string | No | HTTP method (GET, POST, PUT, DELETE, PATCH, HEAD). Default: GET |
64
+ | `country` | string | No | ISO 3166-1 alpha-2 country code (e.g., US, GB, DE) |
65
+ | `pool` | string | No | Proxy pool: `dc` (datacenter, $3/GB) or `residential` ($5/GB). Default: dc |
66
+ | `headers` | object | No | Additional HTTP headers as key-value pairs |
67
+ | `body` | string | No | Request body for POST/PUT/PATCH |
67
68
 
68
69
  #### `get_proxy_config`
70
+
69
71
  View available proxy pools, pricing, supported countries, and endpoint configuration. No parameters.
70
72
 
71
73
  #### `list_sessions`
74
+
72
75
  List all active proxy sessions with status, target hosts, and bandwidth usage. No parameters.
73
76
 
74
77
  ### Wallet Tools
75
78
 
76
79
  #### `check_balance`
80
+
77
81
  Check your wallet balance and estimated remaining bandwidth at current pricing. No parameters.
78
82
 
79
83
  #### `check_usage`
84
+
80
85
  View bandwidth usage statistics for a time period.
81
86
 
82
- | Parameter | Type | Required | Description |
83
- |---|---|---|---|
84
- | `days` | number | No | Number of days to look back (1-365). Default: 30 |
87
+ | Parameter | Type | Required | Description |
88
+ | --------- | ------ | -------- | ------------------------------------------------ |
89
+ | `days` | number | No | Number of days to look back (1-365). Default: 30 |
85
90
 
86
91
  ### Agentic Wallet Tools
87
92
 
88
93
  Agentic wallets are server-side custodial sub-wallets designed for autonomous AI agents. They have per-transaction spending limits for safety and are funded from your main wallet.
89
94
 
90
95
  #### `create_agentic_wallet`
96
+
91
97
  Create a new agentic wallet.
92
98
 
93
- | Parameter | Type | Required | Description |
94
- |---|---|---|---|
95
- | `label` | string | Yes | Label for the wallet (1-100 chars) |
96
- | `spending_limit_cents` | number | No | Max spend per transaction in cents. Default: 10000 ($100) |
99
+ | Parameter | Type | Required | Description |
100
+ | ---------------------- | ------ | -------- | --------------------------------------------------------- |
101
+ | `label` | string | Yes | Label for the wallet (1-100 chars) |
102
+ | `spending_limit_cents` | number | No | Max spend per transaction in cents. Default: 10000 ($100) |
97
103
 
98
104
  #### `fund_agentic_wallet`
105
+
99
106
  Transfer funds from your main wallet to an agentic wallet.
100
107
 
101
- | Parameter | Type | Required | Description |
102
- |---|---|---|---|
103
- | `wallet_id` | string | Yes | Agentic wallet UUID |
104
- | `amount_cents` | number | Yes | Amount in cents (100-1000000) |
108
+ | Parameter | Type | Required | Description |
109
+ | -------------- | ------ | -------- | ----------------------------- |
110
+ | `wallet_id` | string | Yes | Agentic wallet UUID |
111
+ | `amount_cents` | number | Yes | Amount in cents (100-1000000) |
105
112
 
106
113
  #### `check_agentic_balance`
114
+
107
115
  Check an agentic wallet's balance and status.
108
116
 
109
- | Parameter | Type | Required | Description |
110
- |---|---|---|---|
111
- | `wallet_id` | string | Yes | Agentic wallet UUID |
117
+ | Parameter | Type | Required | Description |
118
+ | ----------- | ------ | -------- | ------------------- |
119
+ | `wallet_id` | string | Yes | Agentic wallet UUID |
112
120
 
113
121
  #### `list_agentic_wallets`
122
+
114
123
  List all your agentic wallets with balances and status. No parameters.
115
124
 
116
125
  #### `agentic_transactions`
126
+
117
127
  View transaction history for an agentic wallet.
118
128
 
119
- | Parameter | Type | Required | Description |
120
- |---|---|---|---|
121
- | `wallet_id` | string | Yes | Agentic wallet UUID |
122
- | `limit` | number | No | Number of transactions (1-100). Default: 20 |
129
+ | Parameter | Type | Required | Description |
130
+ | ----------- | ------ | -------- | ------------------------------------------- |
131
+ | `wallet_id` | string | Yes | Agentic wallet UUID |
132
+ | `limit` | number | No | Number of transactions (1-100). Default: 20 |
123
133
 
124
134
  ### Team Tools
125
135
 
126
136
  Teams enable shared wallet billing across multiple users. Owners and admins can manage members and create shared API keys.
127
137
 
128
138
  #### `create_team`
139
+
129
140
  Create a new team.
130
141
 
131
- | Parameter | Type | Required | Description |
132
- |---|---|---|---|
133
- | `name` | string | Yes | Team name (1-100 chars) |
134
- | `max_members` | number | No | Maximum members (1-1000). Default: unlimited |
142
+ | Parameter | Type | Required | Description |
143
+ | ------------- | ------ | -------- | -------------------------------------------- |
144
+ | `name` | string | Yes | Team name (1-100 chars) |
145
+ | `max_members` | number | No | Maximum members (1-1000). Default: unlimited |
135
146
 
136
147
  #### `list_teams`
148
+
137
149
  List all teams you belong to. No parameters.
138
150
 
139
151
  #### `team_details`
152
+
140
153
  Get detailed info about a team.
141
154
 
142
- | Parameter | Type | Required | Description |
143
- |---|---|---|---|
144
- | `team_id` | string | Yes | Team UUID |
155
+ | Parameter | Type | Required | Description |
156
+ | --------- | ------ | -------- | ----------- |
157
+ | `team_id` | string | Yes | Team UUID |
145
158
 
146
159
  #### `team_fund`
160
+
147
161
  Transfer funds from your personal wallet to a team wallet.
148
162
 
149
- | Parameter | Type | Required | Description |
150
- |---|---|---|---|
151
- | `team_id` | string | Yes | Team UUID |
152
- | `amount_cents` | number | Yes | Amount in cents (100-1000000) |
163
+ | Parameter | Type | Required | Description |
164
+ | -------------- | ------ | -------- | ----------------------------- |
165
+ | `team_id` | string | Yes | Team UUID |
166
+ | `amount_cents` | number | Yes | Amount in cents (100-1000000) |
153
167
 
154
168
  #### `team_create_key`
169
+
155
170
  Create a shared API key billed to the team wallet.
156
171
 
157
- | Parameter | Type | Required | Description |
158
- |---|---|---|---|
159
- | `team_id` | string | Yes | Team UUID |
160
- | `label` | string | Yes | Key label (1-100 chars) |
172
+ | Parameter | Type | Required | Description |
173
+ | --------- | ------ | -------- | ----------------------- |
174
+ | `team_id` | string | Yes | Team UUID |
175
+ | `label` | string | Yes | Key label (1-100 chars) |
161
176
 
162
177
  #### `team_usage`
178
+
163
179
  View team wallet transaction history.
164
180
 
165
- | Parameter | Type | Required | Description |
166
- |---|---|---|---|
167
- | `team_id` | string | Yes | Team UUID |
168
- | `limit` | number | No | Number of transactions (1-100). Default: 20 |
181
+ | Parameter | Type | Required | Description |
182
+ | --------- | ------ | -------- | ------------------------------------------- |
183
+ | `team_id` | string | Yes | Team UUID |
184
+ | `limit` | number | No | Number of transactions (1-100). Default: 20 |
169
185
 
170
186
  ## Usage Examples
171
187
 
172
188
  ### Fetch a page through a US proxy
189
+
173
190
  ```
174
191
  Use proxied_fetch to get https://httpbin.org/ip through a US datacenter proxy
175
192
  ```
176
193
 
177
194
  ### Check your budget
195
+
178
196
  ```
179
197
  Check my Dominus Node balance and tell me how much residential browsing I have left
180
198
  ```
181
199
 
182
200
  ### Set up a research team
201
+
183
202
  ```
184
203
  Create a team called "Web Research" with max 5 members, then fund it with $25
185
204
  ```
186
205
 
187
206
  ### Create an agent wallet for automated scraping
207
+
188
208
  ```
189
209
  Create an agentic wallet called "price-monitor" with a $5 spending limit, fund it with $10
190
210
  ```
191
211
 
192
212
  ### View usage breakdown
213
+
193
214
  ```
194
215
  Show my Dominus Node usage for the last 7 days
195
216
  ```
196
217
 
197
218
  ### Fetch with residential proxy and geo-targeting
219
+
198
220
  ```
199
221
  Use proxied_fetch to get https://example.co.uk through a GB residential proxy
200
222
  ```
@@ -218,24 +240,24 @@ The plugin implements comprehensive security measures:
218
240
 
219
241
  ## API Endpoints Used
220
242
 
221
- | Tool | Method | Endpoint |
222
- |---|---|---|
223
- | `proxied_fetch` | POST | `/api/proxy/fetch` |
224
- | `check_balance` | GET | `/api/wallet` |
225
- | `check_usage` | GET | `/api/usage` |
226
- | `get_proxy_config` | GET | `/api/proxy/config` |
227
- | `list_sessions` | GET | `/api/sessions/active` |
228
- | `create_agentic_wallet` | POST | `/api/agent-wallet` |
229
- | `fund_agentic_wallet` | POST | `/api/agent-wallet/:id/fund` |
230
- | `check_agentic_balance` | GET | `/api/agent-wallet/:id` |
231
- | `list_agentic_wallets` | GET | `/api/agent-wallet` |
232
- | `agentic_transactions` | GET | `/api/agent-wallet/:id/transactions` |
233
- | `create_team` | POST | `/api/teams` |
234
- | `list_teams` | GET | `/api/teams` |
235
- | `team_details` | GET | `/api/teams/:id` |
236
- | `team_fund` | POST | `/api/teams/:id/wallet/fund` |
237
- | `team_create_key` | POST | `/api/teams/:id/keys` |
238
- | `team_usage` | GET | `/api/teams/:id/wallet/transactions` |
243
+ | Tool | Method | Endpoint |
244
+ | ----------------------- | ------ | ------------------------------------ |
245
+ | `proxied_fetch` | POST | `/api/proxy/fetch` |
246
+ | `check_balance` | GET | `/api/wallet` |
247
+ | `check_usage` | GET | `/api/usage` |
248
+ | `get_proxy_config` | GET | `/api/proxy/config` |
249
+ | `list_sessions` | GET | `/api/sessions/active` |
250
+ | `create_agentic_wallet` | POST | `/api/agent-wallet` |
251
+ | `fund_agentic_wallet` | POST | `/api/agent-wallet/:id/fund` |
252
+ | `check_agentic_balance` | GET | `/api/agent-wallet/:id` |
253
+ | `list_agentic_wallets` | GET | `/api/agent-wallet` |
254
+ | `agentic_transactions` | GET | `/api/agent-wallet/:id/transactions` |
255
+ | `create_team` | POST | `/api/teams` |
256
+ | `list_teams` | GET | `/api/teams` |
257
+ | `team_details` | GET | `/api/teams/:id` |
258
+ | `team_fund` | POST | `/api/teams/:id/wallet/fund` |
259
+ | `team_create_key` | POST | `/api/teams/:id/keys` |
260
+ | `team_usage` | GET | `/api/teams/:id/wallet/transactions` |
239
261
 
240
262
  ## Requirements
241
263
 
package/dist/plugin.d.ts CHANGED
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * Dominus Node OpenClaw Plugin
3
3
  *
4
- * Implements 26 tools for interacting with Dominus Node's rotating proxy service
4
+ * Implements 53 tools for interacting with Dominus Node's rotating proxy service
5
5
  * directly from OpenClaw AI coding sessions.
6
6
  *
7
7
  * Uses native fetch (no external dependencies). Runs via jiti runtime.