@yahaha-studio/kichi-forwarder 0.1.1-beta.7 → 0.1.1-beta.9

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "kichi-forwarder",
   "name": "Kichi Forwarder",
   "description": "Native OpenClaw plugin for Kichi World with direct avatar control, status sync, timers, notes, and music tools",
-  "version": "0.1.1-beta.7",
+  "version": "0.1.1-beta.9",
   "author": "OpenClaw",
   "skills": ["./skills/kichi-forwarder"],
   "configSchema": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yahaha-studio/kichi-forwarder",
-  "version": "0.1.1-beta.7",
+  "version": "0.1.1-beta.9",
   "description": "Native OpenClaw plugin for Kichi World with direct avatar control, status sync, timers, notes, and music tools",
   "type": "module",
   "main": "index.ts",

package/skills/kichi-forwarder/SKILL.md

@@ -8,9 +8,9 @@ metadata: {"openclaw":{"skillKey":"kichi-forwarder","homepage":"https://github.c
 
 Kichi Forwarder provides websocket tools for connecting an OpenClaw agent to Kichi, directly controlling the Kichi avatar, syncing companion status, and handling Kichi notes, timers, and music workflows.
 
-## Skill Files (Absolute URLs)
+## Pre-install Remote Discovery
 
-If this skill is loaded from a remote URL before local installation, use these files:
+The following URLs are only used when this skill is first loaded from a remote URL before local installation. After the plugin is installed locally, these URLs are not referenced and the local files take precedence:
 
 - `SKILL.md`: `https://yahaha-studio.github.io/kichi-forwarder/SKILL.md`
 - `install.md`: `https://yahaha-studio.github.io/kichi-forwarder/references/install.md`
@@ -30,7 +30,7 @@ Runtime data lives under the user home directory and is isolated per OpenClaw ag
 
 ## Remote URL Install Entry
 
-When this skill is loaded from:
+When this skill is first loaded from:
 
 - `https://yahaha-studio.github.io/kichi-forwarder/SKILL.md`
 
@@ -40,13 +40,13 @@ The install and join flow is defined only in:
 
 - `https://yahaha-studio.github.io/kichi-forwarder/references/install.md`
 
-Read and follow that file before any tool call.
+Read that file once to complete the initial install. After local installation, the local `install.md` is used instead.
 
 ## Install Gate
 
 For install/onboarding/connect requests:
 
-- Read and follow `install.md` before any tool call.
+- Read and follow `install.md` before starting the install flow.
 - Before continuing any install/onboarding/connect flow, check whether `kichi-forwarder` is already installed. If it is installed, ensure it is on the latest published version of `@yahaha-studio/kichi-forwarder`; if not, update it to that latest version first.
 - If plugin installation fails with `429`, treat it as a ClawHub routing failure and switch to the non-ClawHub archive install path from `install.md`/`error.md`. Do not retry the same bare package command.
 - Before calling `kichi_connection_status` or `kichi_join`, update workspace `HEARTBEAT.md` by following `heartbeat.md`. If the update fails, warn the user that heartbeat integration will be unavailable and continue the connection flow.

package/skills/kichi-forwarder/references/heartbeat.md

@@ -21,11 +21,11 @@ For "join Kichi World" onboarding requests:
 
 ## Workflow Boundary
 
-This plugin only provides websocket tools. It does not edit workspace files itself.
+The plugin code itself does not write to workspace files. The onboarding instructions above direct the agent to update `HEARTBEAT.md` on behalf of the user as part of the install flow.
 
 If user wants recurring note board checks:
 
-1. Suggest updating workspace `HEARTBEAT.md`. If the user declines, skip the update.
+1. Update workspace `HEARTBEAT.md`.
 2. Keep the existing OpenClaw heartbeat cadence unless the user explicitly wants a different interval.
 3. Do not claim the plugin edited `HEARTBEAT.md` automatically.
 

package/skills/kichi-forwarder/references/install.md

@@ -53,9 +53,9 @@ openclaw plugins install ./yahaha-studio-kichi-forwarder-<version>.tgz
 
 You may also use the exact absolute or relative `.tgz` path that `npm pack` produced. The local archive path bypasses the preferred ClawHub lookup.
 
-## Remote URL Install Command Path (Non-skippable)
+## Remote URL Install Command Path
 
-If the user asks:
+This section only applies when the skill is first loaded from a remote URL before local installation. If the user asks:
 
 ```text
 Read https://yahaha-studio.github.io/kichi-forwarder/SKILL.md and connect me to Kichi World with avatarId: {avatarId} and host: {host}
@@ -65,7 +65,7 @@ Read https://yahaha-studio.github.io/kichi-forwarder/SKILL.md and connect me to
 
 When the user asks with one of the commands above, execute in this fixed order:
 
-1. Read `install.md` and `heartbeat.md` from the published skill URLs before any tool call.
+1. If loaded from a remote URL, read `install.md` and `heartbeat.md` from the published skill URLs first. If installed locally, use the local files.
 2. Parse `avatarId` from user text (`AvatarId`/`avatarId`, case-insensitive).
 3. Resolve the host and write the current agent's `state.json`.
 4. Check whether `@yahaha-studio/kichi-forwarder` is already installed.
@@ -95,4 +95,4 @@ If any box is unchecked, the onboarding remains incomplete.
 
 If the `HEARTBEAT.md` update fails, warn the user that heartbeat integration will be unavailable but do not block the connection flow.
 
-This plugin does not edit workspace files automatically. Do not claim plugin-side auto-write of `HEARTBEAT.md`.
+The plugin code does not write to workspace files directly. The agent updates `HEARTBEAT.md` as part of this onboarding flow.