Skip to content

Commit c62ffd3

Browse files
docs: improve manifest plugin setup skill (#741)
* docs: improve manifest skill setup steps - Add explicit gateway stop step before configuration - Use gateway install instead of restart - Read logs from file instead of gateway logs command - Wait for gateway startup before verifying - Renumber steps accordingly * retrigger CI --------- Co-authored-by: Bruno Perez <bruno@buddyweb.fr>
1 parent e3527d7 commit c62ffd3

File tree

1 file changed

+18
-8
lines changed

1 file changed

+18
-8
lines changed

skills/manifest/SKILL.md

Lines changed: 18 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -7,15 +7,23 @@ description: Install and configure the Manifest observability plugin for OpenCla
77

88
Follow these steps **in order**. Do not skip ahead.
99

10-
## Step 1 — Install the plugin
10+
## Step 1 — Stop the gateway
11+
12+
Stop the gateway first to avoid hot-reload issues during configuration.
13+
14+
```bash
15+
openclaw gateway stop
16+
```
17+
18+
## Step 2 — Install the plugin
1119

1220
```bash
1321
openclaw plugins install manifest
1422
```
1523

1624
If it fails, check that OpenClaw is installed and the CLI is available in the PATH.
1725

18-
## Step 2 — Get an API key
26+
## Step 3 — Get an API key
1927

2028
Ask the user:
2129

@@ -28,7 +36,7 @@ Ask the user:
2836
2937
Wait for a key starting with `mnfst_`. If the key doesn't match, tell the user the format looks incorrect and ask them to try again.
3038

31-
## Step 3 — Configure the plugin
39+
## Step 4 — Configure the plugin
3240

3341
```bash
3442
openclaw config set plugins.entries.manifest.config.apiKey "USER_API_KEY"
@@ -42,16 +50,18 @@ Ask the user if they have a custom endpoint. If not, the default (`https://app.m
4250
openclaw config set plugins.entries.manifest.config.endpoint "USER_ENDPOINT"
4351
```
4452

45-
## Step 4Restart the gateway
53+
## Step 5Start the gateway
4654

4755
```bash
48-
openclaw gateway restart
56+
openclaw gateway install
4957
```
5058

51-
## Step 5 — Verify
59+
## Step 6 — Verify
60+
61+
Wait 3 seconds for the gateway to fully start, then check the logs:
5262

5363
```bash
54-
openclaw gateway logs --tail 20
64+
grep "manifest" ~/.openclaw/logs/gateway.log | tail -5
5565
```
5666

5767
Look for:
@@ -64,7 +74,7 @@ If it appears, tell the user setup is complete. If not, check the error messages
6474

6575
## Troubleshooting
6676

67-
- **"Missing apiKey"**: Re-run step 3.
77+
- **"Missing apiKey"**: Re-run step 4.
6878
- **"Invalid apiKey format"**: The key must start with `mnfst_`.
6979
- **Connection refused**: The endpoint is unreachable. Check the URL or ask if they self-host.
7080
- **Duplicate OTel registration**: Disable the conflicting built-in plugin: `openclaw plugins disable diagnostics-otel`

0 commit comments

Comments
 (0)