@yahaha-studio/kichi-forwarder 0.0.1-alpha.53 → 0.0.1-alpha.54
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/package.json
CHANGED
|
@@ -29,37 +29,19 @@ Runtime data lives under the user home directory:
|
|
|
29
29
|
- `state.json`: stores `currentHost` and `llmRuntimeEnabled`
|
|
30
30
|
- `hosts/<encoded-host>/identity.json`: stores host-specific `avatarId` and `authKey`
|
|
31
31
|
|
|
32
|
-
## Remote URL Install
|
|
32
|
+
## Remote URL Install Entry
|
|
33
33
|
|
|
34
|
-
When
|
|
34
|
+
When this skill is loaded from:
|
|
35
35
|
|
|
36
|
-
-
|
|
37
|
-
`Read https://xiaoxinshi001.github.io/yahaha_focus_forwarder_alpha/SKILL.md and connect me to Kichi World with avatarId: {avatarId}`
|
|
38
|
-
- With explicit host:
|
|
39
|
-
`Read https://xiaoxinshi001.github.io/yahaha_focus_forwarder_alpha/SKILL.md and connect me to Kichi World with avatarId: {avatarId} and host: {host}`
|
|
36
|
+
- `https://xiaoxinshi001.github.io/yahaha_focus_forwarder_alpha/SKILL.md`
|
|
40
37
|
|
|
41
|
-
|
|
38
|
+
and the user asks to connect/install with `avatarId` and optional `host`, do not invent a separate install flow in this file.
|
|
42
39
|
|
|
43
|
-
|
|
44
|
-
2. Parse `avatarId` from user text (`AvatarId`/`avatarId`, case-insensitive).
|
|
45
|
-
3. Resolve the target host using the rules above.
|
|
46
|
-
4. Run `openclaw plugins install clawhub:{packageName}`.
|
|
47
|
-
5. Ensure the plugin is installed and enabled.
|
|
48
|
-
6. Complete `Session Startup Rule` and `First Join Gate` from [references/heartbeat.md](references/heartbeat.md).
|
|
49
|
-
7. Call `kichi_status`.
|
|
50
|
-
8. If the current host does not match the target host, call `kichi_switch_host`.
|
|
51
|
-
9. If `authKey` is missing, call `kichi_join` using parsed `avatarId`, `botName`, `bio`, and `tags`.
|
|
52
|
-
10. Call `kichi_status` again to verify websocket is ready and `authKey` exists.
|
|
53
|
-
11. Do not report setup or join success unless join checks and heartbeat checks are complete.
|
|
40
|
+
The install and join flow is defined only in:
|
|
54
41
|
|
|
55
|
-
|
|
42
|
+
- `https://xiaoxinshi001.github.io/yahaha_focus_forwarder_alpha/references/install.md`
|
|
56
43
|
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
1. The plugin is installed and enabled.
|
|
60
|
-
2. `state.json` exists with valid `currentHost` and `llmRuntimeEnabled`.
|
|
61
|
-
3. Workspace `HEARTBEAT.md` includes the Kichi heartbeat workflow snippet from [references/heartbeat.md](references/heartbeat.md).
|
|
62
|
-
4. Tools are callable, for example `kichi_status`.
|
|
44
|
+
Read and follow that file before any tool call.
|
|
63
45
|
|
|
64
46
|
## LLM Runtime
|
|
65
47
|
|
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
# Install Error Handling
|
|
2
2
|
|
|
3
|
-
If `
|
|
3
|
+
If `openclaw plugins install @yahaha-studio/kichi-forwarder@latest` fails, read the error output carefully. Common causes and fixes:
|
|
4
4
|
|
|
5
5
|
- Permission or access error (`EACCES`): re-run the command with appropriate user-level permissions for the current OS.
|
|
6
6
|
- npm spawn error (`ENOENT`, `spawn npm`): verify that Node.js (v18+) and npm are installed and available in PATH. On Windows, confirm `where.exe npm` returns a valid path.
|
|
7
7
|
- File conflict (`EEXIST`): re-run the install command with `--force`.
|
|
8
8
|
- Network or registry error: check internet connectivity and retry.
|
|
9
9
|
|
|
10
|
-
After applying the fix, re-run `openclaw plugins install
|
|
10
|
+
After applying the fix, re-run `openclaw plugins install @yahaha-studio/kichi-forwarder@latest`.
|
|
@@ -33,7 +33,7 @@ Save `avatarId` to the host-specific `identity.json` before using `kichi_join`:
|
|
|
33
33
|
## Install
|
|
34
34
|
|
|
35
35
|
```bash
|
|
36
|
-
openclaw plugins install
|
|
36
|
+
openclaw plugins install @yahaha-studio/kichi-forwarder@latest
|
|
37
37
|
```
|
|
38
38
|
|
|
39
39
|
## Remote URL Install Command Path (Non-skippable)
|
|
@@ -59,7 +59,7 @@ When the user asks with one of the commands above, execute in this fixed order:
|
|
|
59
59
|
1. Read `install.md` and `heartbeat.md` from the published skill URLs before any tool call.
|
|
60
60
|
2. Parse `avatarId` from user text (`AvatarId`/`avatarId`, case-insensitive).
|
|
61
61
|
3. Resolve the host and write `state.json`.
|
|
62
|
-
4. Run `openclaw plugins install
|
|
62
|
+
4. Run `openclaw plugins install @yahaha-studio/kichi-forwarder@latest`.
|
|
63
63
|
5. Ensure the plugin is installed and enabled.
|
|
64
64
|
6. Update workspace `HEARTBEAT.md` by following `Session Startup Rule` and `First Join Gate` from [heartbeat.md](heartbeat.md). This step is mandatory.
|
|
65
65
|
7. Call `kichi_status`.
|