@fw_dxs/openclaw-puter-ai 2.1.0 → 2.1.2

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 +128 -322
  2. package/package.json +6 -3
package/README.md CHANGED
@@ -1,388 +1,194 @@
1
- # \# OpenClaw Puter AI Plugin (Actually Working)
1
+ # OpenClaw Puter AI Plugin
2
2
 
3
- #
3
+ ![npm](https://img.shields.io/npm/v/@fw_dxs/openclaw-puter-ai)
4
+ ![license](https://img.shields.io/npm/l/@fw_dxs/openclaw-puter-ai)
4
5
 
5
- # !\[npm](https://img.shields.io/npm/v/@fw\_dxs/openclaw-puter-ai)
6
+ An advanced AI assistant plugin for **OpenClaw**, powered by **Puter AI** with dynamic model routing, autonomous tools, and image generation.
6
7
 
7
- # !\[license](https://img.shields.io/npm/l/@fw\_dxs/openclaw-puter-ai)
8
+ This plugin adds a powerful AI agent to OpenClaw capable of chat, coding assistance, web search, and image generation.
8
9
 
9
- #
10
+ ---
10
11
 
11
- # An advanced AI assistant plugin for \*\*OpenClaw\*\*, powered by \*\*Puter AI\*\* with dynamic model routing, autonomous tools, and image generation.
12
+ # Features
12
13
 
13
- #
14
+ - GPT-5.3 chat support
15
+ - GPT-5.3 Codex routing for coding tasks
16
+ - Autonomous AI agent with tool calling
17
+ - Web search integration
18
+ - Code generation assistance
19
+ - AI image generation
20
+ - Conversation memory
21
+ - Streaming responses
22
+ - Automatic Puter authentication
23
+ - Token caching (no repeated login)
14
24
 
15
- # This plugin adds a powerful AI agent to OpenClaw capable of chat, coding assistance, web search, and image generation.
25
+ ---
16
26
 
17
- #
27
+ # Commands
18
28
 
19
- # ---
29
+ ## Chat
20
30
 
21
- #
31
+ ```
32
+ /ai <prompt>
33
+ ```
22
34
 
23
- # \# Features
35
+ Example:
24
36
 
25
- #
37
+ ```
38
+ /ai explain how transformers work
39
+ ```
26
40
 
27
- # \- GPT-5.3 chat support
41
+ ---
28
42
 
29
- # \- GPT-5.3 Codex routing for coding tasks
43
+ ## Memory Chat
30
44
 
31
- # \- Autonomous AI agent with tool calling
45
+ Stores conversation history for the user.
32
46
 
33
- # \- Web search integration
47
+ ```
48
+ /ai chat <prompt>
49
+ ```
34
50
 
35
- # \- Code generation assistance
51
+ Example:
36
52
 
37
- # \- AI image generation
53
+ ```
54
+ /ai chat remember my project name is Atlas
55
+ ```
38
56
 
39
- # \- Conversation memory
57
+ ---
40
58
 
41
- # \- Streaming responses
59
+ ## Code Generation
42
60
 
43
- # \- Automatic Puter authentication
61
+ Automatically routes to **GPT-5.3 Codex** for coding tasks.
44
62
 
45
- # \- Token caching (no repeated login)
63
+ ```
64
+ /ai code build a nodejs api
65
+ ```
46
66
 
47
- #
67
+ ---
48
68
 
49
- # ---
69
+ ## Web Search
50
70
 
51
- #
71
+ ```
72
+ /ai search latest AI models
73
+ ```
52
74
 
53
- # \# Commands
75
+ ---
54
76
 
55
- #
77
+ ## Image Generation
56
78
 
57
- # \## Chat
79
+ ```
80
+ /ai image futuristic city at sunset
81
+ ```
58
82
 
59
- #
83
+ Images are generated using Puter and saved locally.
60
84
 
61
- # ```
85
+ ---
62
86
 
63
- # /ai <prompt>
87
+ ## Autonomous Agent
64
88
 
65
- # ```
89
+ The agent can automatically decide which tools to use.
66
90
 
67
- #
91
+ ```
92
+ /ai research how to build a discord bot
93
+ ```
68
94
 
69
- # Example:
95
+ The AI may automatically:
70
96
 
71
- #
97
+ - search the web
98
+ - generate code
99
+ - create images
100
+ - answer directly
72
101
 
73
- # ```
102
+ ---
74
103
 
75
- # /ai explain how transformers work
104
+ # Installation
76
105
 
77
- # ```
106
+ Install the plugin via npm:
78
107
 
79
- #
108
+ ```
109
+ npm install @fw_dxs/openclaw-puter-ai
110
+ ```
80
111
 
81
- # ---
112
+ Then enable it in your OpenClaw configuration.
82
113
 
83
- #
114
+ ---
84
115
 
85
- # \## Memory Chat
116
+ # Requirements
86
117
 
87
- #
118
+ - Node.js 18+
119
+ - OpenClaw
120
+ - Puter account (for AI access)
88
121
 
89
- # Stores conversation history for the user.
122
+ The plugin will automatically prompt for Puter authentication on first use.
90
123
 
91
- #
124
+ ---
92
125
 
93
- # ```
126
+ # Model Routing
94
127
 
95
- # /ai chat <prompt>
128
+ The plugin automatically selects models depending on the task.
96
129
 
97
- # ```
130
+ | Task | Model |
131
+ |------|------|
132
+ | General chat | GPT-5.3 Chat |
133
+ | Coding tasks | GPT-5.3 Codex |
134
+ | Image generation | GPT Image |
98
135
 
99
- #
136
+ ---
100
137
 
101
- # Example:
138
+ # Project Structure
102
139
 
103
- #
140
+ ```
141
+ openclaw-puter-ai
142
+
143
+ ├── index.js
144
+ ├── agent.js
145
+ ├── puterClient.js
146
+ ├── openclaw.plugin.json
147
+ ├── README.md
148
+
149
+ ├── tools
150
+ │ ├── webSearch.js
151
+ │ └── codeGen.js
152
+
153
+ ├── memory
154
+ │ └── conversation.js
155
+
156
+ └── generated
157
+ ```
104
158
 
105
- # ```
159
+ ---
106
160
 
107
- # /ai chat remember my project name is Atlas
161
+ # Security Notes
108
162
 
109
- # ```
163
+ Do **not publish or share** these files:
110
164
 
111
- #
165
+ ```
166
+ .puter-token.json
167
+ memory.json
168
+ generated/
169
+ ```
112
170
 
113
- # ---
171
+ These files contain local runtime data.
114
172
 
115
- #
173
+ ---
116
174
 
117
- # \## Code Generation
175
+ # License
118
176
 
119
- #
177
+ MIT License
120
178
 
121
- # Automatically routes to \*\*GPT-5.3 Codex\*\* for coding tasks.
179
+ ---
122
180
 
123
- #
181
+ # Author
124
182
 
125
- # ```
183
+ fw_dxs
126
184
 
127
- # /ai code build a nodejs api
185
+ ---
128
186
 
129
- # ```
187
+ # Future Improvements
130
188
 
131
- #
132
-
133
- # ---
134
-
135
- #
136
-
137
- # \## Web Search
138
-
139
- #
140
-
141
- # ```
142
-
143
- # /ai search latest AI models
144
-
145
- # ```
146
-
147
- #
148
-
149
- # ---
150
-
151
- #
152
-
153
- # \## Image Generation
154
-
155
- #
156
-
157
- # ```
158
-
159
- # /ai image futuristic city at sunset
160
-
161
- # ```
162
-
163
- #
164
-
165
- # Images are generated using Puter and saved locally.
166
-
167
- #
168
-
169
- # ---
170
-
171
- #
172
-
173
- # \## Autonomous Agent
174
-
175
- #
176
-
177
- # The agent can automatically decide which tools to use.
178
-
179
- #
180
-
181
- # ```
182
-
183
- # /ai research how to build a discord bot
184
-
185
- # ```
186
-
187
- #
188
-
189
- # The AI may automatically:
190
-
191
- #
192
-
193
- # \- search the web
194
-
195
- # \- generate code
196
-
197
- # \- create images
198
-
199
- # \- answer directly
200
-
201
- #
202
-
203
- # ---
204
-
205
- #
206
-
207
- # \# Installation
208
-
209
- #
210
-
211
- # Install the plugin via npm:
212
-
213
- #
214
-
215
- # ```
216
-
217
- # npm install @fw\_dxs/openclaw-puter-ai
218
-
219
- # ```
220
-
221
- #
222
-
223
- # Then enable it in your OpenClaw configuration.
224
-
225
- #
226
-
227
- # ---
228
-
229
- #
230
-
231
- # \# Requirements
232
-
233
- #
234
-
235
- # \- Node.js 18+
236
-
237
- # \- OpenClaw
238
-
239
- # \- Puter account (for AI access)
240
-
241
- #
242
-
243
- # The plugin will automatically prompt for Puter authentication on first use.
244
-
245
- #
246
-
247
- # ---
248
-
249
- #
250
-
251
- # \# Model Routing
252
-
253
- #
254
-
255
- # The plugin automatically selects models depending on the task.
256
-
257
- #
258
-
259
- # | Task | Model |
260
-
261
- # |-----|------|
262
-
263
- # General chat | GPT-5.3 Chat |
264
-
265
- # Coding tasks | GPT-5.3 Codex |
266
-
267
- # Image generation | GPT Image |
268
-
269
- #
270
-
271
- # ---
272
-
273
- #
274
-
275
- # \# Project Structure
276
-
277
- #
278
-
279
- # ```
280
-
281
- # openclaw-puter-ai
282
-
283
- # │
284
-
285
- # ├── index.js
286
-
287
- # ├── agent.js
288
-
289
- # ├── puterClient.js
290
-
291
- # ├── openclaw.plugin.json
292
-
293
- # ├── README.md
294
-
295
- # │
296
-
297
- # ├── tools
298
-
299
- # │ ├── webSearch.js
300
-
301
- # │ └── codeGen.js
302
-
303
- # │
304
-
305
- # ├── memory
306
-
307
- # │ └── conversation.js
308
-
309
- # │
310
-
311
- # └── generated
312
-
313
- # ```
314
-
315
- #
316
-
317
- # ---
318
-
319
- #
320
-
321
- # \# Security Notes
322
-
323
- #
324
-
325
- # Do \*\*not publish or share\*\* these files:
326
-
327
- #
328
-
329
- # ```
330
-
331
- # .puter-token.json
332
-
333
- # memory.json
334
-
335
- # generated/
336
-
337
- # ```
338
-
339
- #
340
-
341
- # These files contain local runtime data.
342
-
343
- #
344
-
345
- # ---
346
-
347
- #
348
-
349
- # \# License
350
-
351
- #
352
-
353
- # MIT License
354
-
355
- #
356
-
357
- # ---
358
-
359
- #
360
-
361
- # \# Author
362
-
363
- #
364
-
365
- # fw\_dxs
366
-
367
- #
368
-
369
- # ---
370
-
371
- #
372
-
373
- # \# Future Improvements
374
-
375
- #
376
-
377
- # Planned features include:
378
-
379
- #
380
-
381
- # \- filesystem tools for autonomous development agents
382
-
383
- # \- code execution tools
384
-
385
- # \- multi-image generation
386
-
387
- # \- improved OpenClaw UI integration
189
+ Planned features include:
388
190
 
191
+ - filesystem tools for autonomous development agents
192
+ - code execution tools
193
+ - multi-image generation
194
+ - improved OpenClaw UI integration
package/package.json CHANGED
@@ -1,14 +1,17 @@
1
1
  {
2
2
  "name": "@fw_dxs/openclaw-puter-ai",
3
- "version": "2.1.0",
3
+ "version": "2.1.2",
4
4
  "description": "Advanced AI plugin for OpenClaw using Puter",
5
5
  "main": "index.js",
6
6
  "type": "commonjs",
7
+ "license": "MIT",
7
8
  "dependencies": {
8
9
  "@heyputer/puter.js": "^2.2.11",
9
10
  "eventemitter3": "^5.0.1"
10
11
  },
11
12
  "openclaw": {
12
- "extensions": ["./index.js"]
13
+ "extensions": [
14
+ "./index.js"
15
+ ]
13
16
  }
14
- }
17
+ }