@chorus-aidlc/chorus-openclaw-plugin 0.1.2 → 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.
- package/README.md +54 -31
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -60,29 +60,41 @@ Chorus Server
|
|
|
60
60
|
|
|
61
61
|
## Installation
|
|
62
62
|
|
|
63
|
-
###
|
|
63
|
+
### 1. Install the plugin
|
|
64
64
|
|
|
65
|
-
|
|
65
|
+
```bash
|
|
66
|
+
openclaw plugins install @chorus-aidlc/chorus-openclaw-plugin
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
### 2. Enable hooks
|
|
70
|
+
|
|
71
|
+
Hooks are required for the agent wake mechanism. Add to your `~/.openclaw/openclaw.json`:
|
|
66
72
|
|
|
67
73
|
```json
|
|
68
74
|
{
|
|
69
75
|
"hooks": {
|
|
70
76
|
"enabled": true,
|
|
71
77
|
"token": "your-hooks-token"
|
|
72
|
-
}
|
|
78
|
+
}
|
|
79
|
+
}
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
> The `hooks.token` must be different from `gateway.auth.token`.
|
|
83
|
+
|
|
84
|
+
### 3. Configure the plugin
|
|
85
|
+
|
|
86
|
+
Add the plugin entry to `~/.openclaw/openclaw.json`:
|
|
87
|
+
|
|
88
|
+
```json
|
|
89
|
+
{
|
|
73
90
|
"plugins": {
|
|
74
91
|
"enabled": true,
|
|
75
|
-
"allow": ["@chorus-aidlc/chorus-openclaw-plugin"],
|
|
76
|
-
"load": {
|
|
77
|
-
"paths": ["/path/to/openclaw-plugin"]
|
|
78
|
-
},
|
|
79
92
|
"entries": {
|
|
80
|
-
"
|
|
93
|
+
"chorus-openclaw-plugin": {
|
|
81
94
|
"enabled": true,
|
|
82
95
|
"config": {
|
|
83
96
|
"chorusUrl": "https://chorus.example.com",
|
|
84
97
|
"apiKey": "cho_your_api_key_here",
|
|
85
|
-
"projectUuids": [],
|
|
86
98
|
"autoStart": true
|
|
87
99
|
}
|
|
88
100
|
}
|
|
@@ -91,13 +103,6 @@ Add to your `~/.openclaw/openclaw.json`:
|
|
|
91
103
|
}
|
|
92
104
|
```
|
|
93
105
|
|
|
94
|
-
### From npm (planned)
|
|
95
|
-
|
|
96
|
-
```bash
|
|
97
|
-
# Coming soon
|
|
98
|
-
pnpm add @chorus-aidlc/chorus-openclaw-plugin
|
|
99
|
-
```
|
|
100
|
-
|
|
101
106
|
## Configuration
|
|
102
107
|
|
|
103
108
|
| Field | Type | Required | Default | Description |
|
|
@@ -247,24 +252,10 @@ Wraps `@modelcontextprotocol/sdk` with:
|
|
|
247
252
|
- Routes by notification `action` type
|
|
248
253
|
- All handlers catch errors internally — never crashes the gateway
|
|
249
254
|
|
|
250
|
-
## Development
|
|
251
|
-
|
|
252
|
-
```bash
|
|
253
|
-
# In the openclaw-plugin directory
|
|
254
|
-
pnpm install
|
|
255
|
-
pnpm dev # Watch mode (tsc --watch)
|
|
256
|
-
pnpm build # Production build
|
|
257
|
-
|
|
258
|
-
# Test with OpenClaw gateway
|
|
259
|
-
cd /path/to/openclaw && node openclaw.mjs gateway
|
|
260
|
-
```
|
|
261
|
-
|
|
262
|
-
No build step needed for development — OpenClaw loads `.ts` files directly via `jiti`.
|
|
263
|
-
|
|
264
255
|
## Troubleshooting
|
|
265
256
|
|
|
266
257
|
### "plugin id mismatch" warning
|
|
267
|
-
Ensure `
|
|
258
|
+
Ensure `openclaw.plugin.json` `id` and `index.ts` `id` both equal `chorus-openclaw-plugin`.
|
|
268
259
|
|
|
269
260
|
### "Wake agent failed: HTTP 405"
|
|
270
261
|
Hooks are not enabled. Add to `openclaw.json`:
|
|
@@ -282,6 +273,38 @@ OpenClaw tool `execute` signature is `execute(toolCallId, params)` — the first
|
|
|
282
273
|
### Bedrock "inputSchema.json.type must be object"
|
|
283
274
|
All tool `parameters` must be full JSON Schema with `type: "object"` at the top level, not shorthand `{ key: { type: "string" } }`.
|
|
284
275
|
|
|
276
|
+
## Appendix: Local Development Install
|
|
277
|
+
|
|
278
|
+
If you're developing the plugin from the Chorus repo source:
|
|
279
|
+
|
|
280
|
+
```bash
|
|
281
|
+
# No build needed — OpenClaw loads .ts files directly via jiti
|
|
282
|
+
cd /path/to/Chorus/packages/openclaw-plugin
|
|
283
|
+
```
|
|
284
|
+
|
|
285
|
+
Add to `~/.openclaw/openclaw.json`:
|
|
286
|
+
|
|
287
|
+
```json
|
|
288
|
+
{
|
|
289
|
+
"plugins": {
|
|
290
|
+
"enabled": true,
|
|
291
|
+
"load": {
|
|
292
|
+
"paths": ["/path/to/Chorus/packages/openclaw-plugin"]
|
|
293
|
+
},
|
|
294
|
+
"entries": {
|
|
295
|
+
"chorus-openclaw-plugin": {
|
|
296
|
+
"enabled": true,
|
|
297
|
+
"config": {
|
|
298
|
+
"chorusUrl": "http://localhost:3000",
|
|
299
|
+
"apiKey": "cho_your_dev_key",
|
|
300
|
+
"autoStart": true
|
|
301
|
+
}
|
|
302
|
+
}
|
|
303
|
+
}
|
|
304
|
+
}
|
|
305
|
+
}
|
|
306
|
+
```
|
|
307
|
+
|
|
285
308
|
## License
|
|
286
309
|
|
|
287
310
|
MIT
|
package/package.json
CHANGED