@yahaha-studio/kichi-forwarder 0.0.1-alpha.52 → 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
|
@@ -8,11 +8,14 @@ metadata: {"openclaw":{"skillKey":"kichi-forwarder","homepage":"https://github.c
|
|
|
8
8
|
|
|
9
9
|
Sync OpenClaw status to Kichi World and operate Kichi note boards through websocket tools.
|
|
10
10
|
|
|
11
|
-
##
|
|
11
|
+
## Skill Files (Absolute URLs)
|
|
12
12
|
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
- `
|
|
13
|
+
If this skill is loaded from a remote URL before local installation, use these files:
|
|
14
|
+
|
|
15
|
+
- `SKILL.md`: `https://xiaoxinshi001.github.io/yahaha_focus_forwarder_alpha/SKILL.md`
|
|
16
|
+
- `install.md`: `https://xiaoxinshi001.github.io/yahaha_focus_forwarder_alpha/references/install.md`
|
|
17
|
+
- `error.md`: `https://xiaoxinshi001.github.io/yahaha_focus_forwarder_alpha/references/error.md`
|
|
18
|
+
- `heartbeat.md`: `https://xiaoxinshi001.github.io/yahaha_focus_forwarder_alpha/references/heartbeat.md`
|
|
16
19
|
|
|
17
20
|
## Host Rules
|
|
18
21
|
|
|
@@ -26,16 +29,19 @@ Runtime data lives under the user home directory:
|
|
|
26
29
|
- `state.json`: stores `currentHost` and `llmRuntimeEnabled`
|
|
27
30
|
- `hosts/<encoded-host>/identity.json`: stores host-specific `avatarId` and `authKey`
|
|
28
31
|
|
|
29
|
-
##
|
|
32
|
+
## Remote URL Install Entry
|
|
33
|
+
|
|
34
|
+
When this skill is loaded from:
|
|
35
|
+
|
|
36
|
+
- `https://xiaoxinshi001.github.io/yahaha_focus_forwarder_alpha/SKILL.md`
|
|
37
|
+
|
|
38
|
+
and the user asks to connect/install with `avatarId` and optional `host`, do not invent a separate install flow in this file.
|
|
30
39
|
|
|
31
|
-
|
|
32
|
-
`Install the ClawHub package \`clawhub:{packageName}\` via \`openclaw plugins install\`, then follow the plugin's documented Kichi World startup and join flow using avatarId: {avatarId}.`
|
|
33
|
-
- With explicit host:
|
|
34
|
-
`Install the ClawHub package \`clawhub:{packageName}\` via \`openclaw plugins install\`, then follow the plugin's documented Kichi World startup and join flow using avatarId: {avatarId} and host: {host}.`
|
|
40
|
+
The install and join flow is defined only in:
|
|
35
41
|
|
|
36
|
-
|
|
42
|
+
- `https://xiaoxinshi001.github.io/yahaha_focus_forwarder_alpha/references/install.md`
|
|
37
43
|
|
|
38
|
-
|
|
44
|
+
Read and follow that file before any tool call.
|
|
39
45
|
|
|
40
46
|
## LLM Runtime
|
|
41
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`.
|
|
@@ -30,32 +30,42 @@ Save `avatarId` to the host-specific `identity.json` before using `kichi_join`:
|
|
|
30
30
|
}
|
|
31
31
|
```
|
|
32
32
|
|
|
33
|
-
##
|
|
33
|
+
## Install
|
|
34
|
+
|
|
35
|
+
```bash
|
|
36
|
+
openclaw plugins install @yahaha-studio/kichi-forwarder@latest
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
## Remote URL Install Command Path (Non-skippable)
|
|
40
|
+
|
|
41
|
+
If the user asks:
|
|
34
42
|
|
|
35
43
|
- Default:
|
|
36
44
|
|
|
37
45
|
```text
|
|
38
|
-
|
|
46
|
+
Read https://xiaoxinshi001.github.io/yahaha_focus_forwarder_alpha/SKILL.md and connect me to Kichi World with avatarId: {avatarId}
|
|
39
47
|
```
|
|
40
48
|
|
|
41
49
|
- With explicit host:
|
|
42
50
|
|
|
43
51
|
```text
|
|
44
|
-
|
|
52
|
+
Read https://xiaoxinshi001.github.io/yahaha_focus_forwarder_alpha/SKILL.md and connect me to Kichi World with avatarId: {avatarId} and host: {host}
|
|
45
53
|
```
|
|
46
54
|
|
|
47
55
|
## Command Execution Flow
|
|
48
56
|
|
|
49
57
|
When the user asks with one of the commands above, execute in this fixed order:
|
|
50
58
|
|
|
51
|
-
1.
|
|
52
|
-
2.
|
|
59
|
+
1. Read `install.md` and `heartbeat.md` from the published skill URLs before any tool call.
|
|
60
|
+
2. Parse `avatarId` from user text (`AvatarId`/`avatarId`, case-insensitive).
|
|
53
61
|
3. Resolve the host and write `state.json`.
|
|
54
|
-
4.
|
|
55
|
-
5.
|
|
56
|
-
6.
|
|
57
|
-
7.
|
|
58
|
-
8.
|
|
62
|
+
4. Run `openclaw plugins install @yahaha-studio/kichi-forwarder@latest`.
|
|
63
|
+
5. Ensure the plugin is installed and enabled.
|
|
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
|
+
7. Call `kichi_status`.
|
|
66
|
+
8. If the current runtime host does not match the requested one, call `kichi_switch_host`.
|
|
67
|
+
9. If `authKey` is missing, call `kichi_join` with parsed `avatarId`, `botName`, `bio`, and `tags`.
|
|
68
|
+
10. Call `kichi_status` again and confirm connection and auth state.
|
|
59
69
|
|
|
60
70
|
## Required Post-install Integration
|
|
61
71
|
|
|
@@ -64,3 +74,5 @@ When the user asks with one of the commands above, execute in this fixed order:
|
|
|
64
74
|
3. Verify tools are callable, for example with `kichi_status`.
|
|
65
75
|
|
|
66
76
|
If writing `HEARTBEAT.md` fails, treat the setup and join flow as incomplete.
|
|
77
|
+
|
|
78
|
+
This plugin does not edit workspace files automatically. Do not claim plugin-side auto-write of `HEARTBEAT.md`.
|