@w3osc/openclaw-conduit 1.0.0 → 1.0.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.
- package/README.md +82 -0
- package/openclaw.plugin.json +3 -5
- package/package.json +12 -4
package/README.md
ADDED
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
# @w3osc/openclaw-conduit
|
|
2
|
+
|
|
3
|
+
An [OpenClaw](https://openclaw.ai) channel plugin that connects [Conduit](https://github.com/conduit-app/conduit) as a native messaging channel.
|
|
4
|
+
|
|
5
|
+
Conduit is a self-hosted personal communications hub that aggregates Slack, Discord, Telegram, Gmail, Google Calendar, and Twitter/X into a unified local server. This plugin lets the OpenClaw agent receive messages from the Conduit AI chat UI and stream replies back in real time.
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## Requirements
|
|
10
|
+
|
|
11
|
+
- OpenClaw `>=2026.3.24-beta.2`
|
|
12
|
+
- A running Conduit instance (self-hosted)
|
|
13
|
+
- A Conduit API key (generated in **Settings → Permissions**)
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## Installation
|
|
18
|
+
|
|
19
|
+
```sh
|
|
20
|
+
openclaw plugins install @w3osc/openclaw-conduit
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
## Configuration
|
|
26
|
+
|
|
27
|
+
Add a `conduit` section under `channels` in your `~/.openclaw/openclaw.json`:
|
|
28
|
+
|
|
29
|
+
```json
|
|
30
|
+
{
|
|
31
|
+
"channels": {
|
|
32
|
+
"conduit": {
|
|
33
|
+
"baseUrl": "http://localhost:3101",
|
|
34
|
+
"apiKey": "sk-arb-...",
|
|
35
|
+
"allowFrom": [],
|
|
36
|
+
"webhookSecret": "optional-secret"
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
| Field | Required | Description |
|
|
43
|
+
|---|---|---|
|
|
44
|
+
| `baseUrl` | Yes | Base URL of your Conduit server |
|
|
45
|
+
| `apiKey` | Yes | Conduit API key — generate one in **Settings → Permissions** |
|
|
46
|
+
| `allowFrom` | No | List of OpenClaw user identifiers allowed to receive Conduit messages. Leave empty to allow all. |
|
|
47
|
+
| `webhookSecret` | No | If set, Conduit must send `Authorization: Bearer <secret>` on each inbound request |
|
|
48
|
+
|
|
49
|
+
---
|
|
50
|
+
|
|
51
|
+
## Connecting Conduit to OpenClaw
|
|
52
|
+
|
|
53
|
+
After installing and configuring the plugin, restart the OpenClaw Gateway:
|
|
54
|
+
|
|
55
|
+
```sh
|
|
56
|
+
openclaw gateway
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
Then in Conduit, go to **Settings → AI → OpenClaw Channel** and enter the inbound webhook URL:
|
|
60
|
+
|
|
61
|
+
```
|
|
62
|
+
http://<your-openclaw-host>:18789/channels/conduit/inbound
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
Messages sent to the Conduit AI chat will now be routed to the OpenClaw agent, and replies will stream back to the Conduit UI.
|
|
66
|
+
|
|
67
|
+
---
|
|
68
|
+
|
|
69
|
+
## How it works
|
|
70
|
+
|
|
71
|
+
1. Conduit POSTs an inbound message to the OpenClaw Gateway at `/channels/conduit/inbound`
|
|
72
|
+
2. The plugin verifies the optional webhook secret, then dispatches the message to the OpenClaw agent
|
|
73
|
+
3. The agent reply is streamed back to Conduit's session stream endpoint in real time
|
|
74
|
+
4. The Conduit AI chat UI renders the streaming response
|
|
75
|
+
|
|
76
|
+
Outbound sends (when OpenClaw proactively sends a message) are delivered via Conduit's streaming API using the API key.
|
|
77
|
+
|
|
78
|
+
---
|
|
79
|
+
|
|
80
|
+
## License
|
|
81
|
+
|
|
82
|
+
MIT
|
package/openclaw.plugin.json
CHANGED
|
@@ -4,11 +4,9 @@
|
|
|
4
4
|
"channels": ["conduit"],
|
|
5
5
|
"name": "Conduit",
|
|
6
6
|
"description": "Conduit personal communications hub — read messages, emails, and calendar; queue outbound sends for approval.",
|
|
7
|
-
"
|
|
8
|
-
"
|
|
9
|
-
|
|
10
|
-
"properties": {
|
|
11
|
-
"conduit": {
|
|
7
|
+
"channelConfigs": {
|
|
8
|
+
"conduit": {
|
|
9
|
+
"schema": {
|
|
12
10
|
"type": "object",
|
|
13
11
|
"additionalProperties": false,
|
|
14
12
|
"required": ["baseUrl", "apiKey"],
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@w3osc/openclaw-conduit",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.2",
|
|
4
4
|
"description": "OpenClaw channel plugin that connects Conduit as a native messaging channel",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"exports": {
|
|
@@ -10,7 +10,8 @@
|
|
|
10
10
|
"main": "./dist/index.js",
|
|
11
11
|
"files": [
|
|
12
12
|
"dist",
|
|
13
|
-
"openclaw.plugin.json"
|
|
13
|
+
"openclaw.plugin.json",
|
|
14
|
+
"README.md"
|
|
14
15
|
],
|
|
15
16
|
"scripts": {
|
|
16
17
|
"build": "tsc",
|
|
@@ -19,7 +20,9 @@
|
|
|
19
20
|
"prepublishOnly": "npm run build"
|
|
20
21
|
},
|
|
21
22
|
"openclaw": {
|
|
22
|
-
"extensions": [
|
|
23
|
+
"extensions": [
|
|
24
|
+
"./dist/index.js"
|
|
25
|
+
],
|
|
23
26
|
"setupEntry": "./dist/setup-entry.js",
|
|
24
27
|
"channel": {
|
|
25
28
|
"id": "conduit",
|
|
@@ -31,7 +34,12 @@
|
|
|
31
34
|
"minGatewayVersion": "2026.3.24-beta.2"
|
|
32
35
|
}
|
|
33
36
|
},
|
|
34
|
-
"keywords": [
|
|
37
|
+
"keywords": [
|
|
38
|
+
"openclaw",
|
|
39
|
+
"conduit",
|
|
40
|
+
"channel",
|
|
41
|
+
"plugin"
|
|
42
|
+
],
|
|
35
43
|
"license": "MIT",
|
|
36
44
|
"devDependencies": {
|
|
37
45
|
"openclaw": "latest",
|