@cfio/cohort-sync 0.9.4 → 0.10.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.
- package/README.md +19 -20
- package/dist/index.js +188 -576
- package/dist/openclaw.plugin.json +1 -1
- package/dist/package.json +2 -2
- package/package.json +5 -5
- package/scripts/postinstall.mjs +1 -1
package/README.md
CHANGED
|
@@ -1,49 +1,44 @@
|
|
|
1
1
|
# @cfio/cohort-sync
|
|
2
2
|
|
|
3
|
-
OpenClaw plugin that syncs your gateway to the [Cohort](https://my.cohort.bot) dashboard. Keeps agent status
|
|
3
|
+
OpenClaw plugin that syncs your gateway to the [Cohort](https://my.cohort.bot) dashboard. Keeps agent status visible in real time — no polling, no manual config.
|
|
4
4
|
|
|
5
5
|
## What it does
|
|
6
6
|
|
|
7
7
|
- Reports agent status (`working` / `idle`) on gateway start and session end
|
|
8
|
-
-
|
|
8
|
+
- Pushes telemetry, sessions, activity feed, and cron snapshots
|
|
9
9
|
- Enables @mention delivery from Cohort to your agent
|
|
10
|
+
- Receives and executes gateway commands from the dashboard
|
|
10
11
|
|
|
11
12
|
No VPN, Tailscale, or port forwarding needed. The plugin connects outbound to Cohort and works behind any firewall.
|
|
12
13
|
|
|
13
14
|
## Install
|
|
14
15
|
|
|
15
16
|
```bash
|
|
16
|
-
|
|
17
|
+
openclaw plugins install @cfio/cohort-sync
|
|
17
18
|
```
|
|
18
19
|
|
|
19
|
-
The postinstall script copies the plugin to `~/.openclaw/extensions/cohort-sync/` automatically.
|
|
20
|
-
|
|
21
20
|
## Configure
|
|
22
21
|
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
```bash
|
|
26
|
-
openclaw config set "plugins.entries.cohort-sync.config.agentNameMap.main" "YOUR_AGENT_NAME"
|
|
27
|
-
```
|
|
22
|
+
1. **Create an API key** in the Cohort dashboard: [Settings > API Keys](https://my.cohort.bot/settings/api-keys)
|
|
28
23
|
|
|
29
|
-
|
|
24
|
+
2. **Set the key** in your gateway config:
|
|
30
25
|
|
|
31
26
|
```bash
|
|
32
|
-
openclaw
|
|
27
|
+
openclaw config set \
|
|
28
|
+
plugins.entries.cohort-sync.config.apiKey "ch_live_..."
|
|
33
29
|
```
|
|
34
30
|
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
## Verify
|
|
31
|
+
3. **Map your agent name** (optional — defaults to IDENTITY.md name):
|
|
38
32
|
|
|
39
33
|
```bash
|
|
40
|
-
openclaw
|
|
34
|
+
openclaw config set \
|
|
35
|
+
plugins.entries.cohort-sync.config.agentNameMap.main "YOUR_AGENT_NAME"
|
|
41
36
|
```
|
|
42
37
|
|
|
43
|
-
|
|
38
|
+
4. **Restart the gateway:**
|
|
44
39
|
|
|
45
40
|
```bash
|
|
46
|
-
openclaw gateway
|
|
41
|
+
openclaw gateway --force
|
|
47
42
|
```
|
|
48
43
|
|
|
49
44
|
Your agent should appear in the Cohort dashboard within seconds.
|
|
@@ -51,10 +46,14 @@ Your agent should appear in the Cohort dashboard within seconds.
|
|
|
51
46
|
## Update
|
|
52
47
|
|
|
53
48
|
```bash
|
|
54
|
-
|
|
49
|
+
openclaw plugins install @cfio/cohort-sync
|
|
55
50
|
```
|
|
56
51
|
|
|
57
|
-
Running the install command again updates to the latest version
|
|
52
|
+
Running the install command again updates to the latest version.
|
|
53
|
+
|
|
54
|
+
## Known limitations (0.10.x)
|
|
55
|
+
|
|
56
|
+
- **Skill sync is temporarily unavailable.** The plugin previously enumerated skills via the OpenClaw CLI. This was removed to pass the install-time security scanner. Skill sync will return when the OpenClaw SDK adds a skills enumeration API.
|
|
58
57
|
|
|
59
58
|
## Requirements
|
|
60
59
|
|