@yahaha-studio/kichi-forwarder 0.0.1-alpha.49 → 0.0.1-alpha.51

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yahaha-studio/kichi-forwarder",
-  "version": "0.0.1-alpha.49",
+  "version": "0.0.1-alpha.51",
   "description": "Forward OpenClaw agent events to external WebSocket server for visualization",
   "type": "module",
   "main": "index.ts",

package/skills/kichi-forwarder/SKILL.md

@@ -8,366 +8,136 @@ metadata: {"openclaw":{"skillKey":"kichi-forwarder","homepage":"https://github.c
 
 Sync OpenClaw status to Kichi World and operate Kichi note boards through websocket tools.
 
-## Skill Files (Absolute URLs)
+## References
 
-If this skill is loaded from a remote URL (before local installation), use these files:
+- `references/install.md`
+- `references/error.md`
+- `references/heartbeat.md`
 
-- `SKILL.md`: `https://xiaoxinshi001.github.io/yahaha_focus_forwarder_alpha/SKILL.md`
-- `install.md`: `https://xiaoxinshi001.github.io/yahaha_focus_forwarder_alpha/references/install.md`
-- `error.md`: `https://xiaoxinshi001.github.io/yahaha_focus_forwarder_alpha/references/error.md`
-- `heartbeat.md`: `https://xiaoxinshi001.github.io/yahaha_focus_forwarder_alpha/references/heartbeat.md`
+## Host Rules
 
-## Remote URL Join Command (Mandatory Flow)
+- If the user explicitly includes `host: <value>`, use that host.
+- If the user does not specify a host, use `focus.yahaha.com`.
 
-When user instruction is:
+## Runtime State
 
-`Read https://xiaoxinshi001.github.io/yahaha_focus_forwarder_alpha/SKILL.md, use AvatarId: <id> to join Kichi World`
+Runtime data lives under the user home directory:
 
-run this exact sequence without skipping steps:
+- `state.json`: stores `currentHost` and `llmRuntimeEnabled`
+- `hosts/<encoded-host>/identity.json`: stores host-specific `avatarId` and `authKey`
 
-1. Read `install.md` and `heartbeat.md` from the absolute URLs above before any tool call.
-2. Parse `AvatarId` from user text (`AvatarId`/`avatarId`, case-insensitive).
-3. Ensure plugin install/enable is complete (`plugins.entries.kichi-forwarder.enabled: true`).
-4. Ensure `kichi-runtime-config.json` is persisted with animation/action config for `stand`/`sit`/`lay`/`floor`.
-5. Complete `Session Startup Rule` and `First Join Gate` from [references/heartbeat.md](references/heartbeat.md).
-6. Call `kichi_status`.
-7. If `authKey` is missing, call `kichi_join` using parsed `AvatarId`, `botName`, `bio`, and `tags`.
-8. Call `kichi_status` again to verify websocket is ready and `authKey` exists.
-9. Do not report setup/join success unless join checks, heartbeat checks, and runtime config checks are complete.
+## User Command
 
-## Setup and Troubleshooting References
+- Default:
+  `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}.`
+- With explicit host:
+  `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}.`
 
-- Install/enable flow, `identity.json`, and plugin data files: [references/install.md](references/install.md)
-- Common install failures and fixes: [references/error.md](references/error.md)
+## Install And Join Flow
 
-## Installation Completion Checks
-
-Treat these as required completion checks for plugin setup:
-
-1. Plugin exists and is enabled: `plugins.entries.kichi-forwarder.enabled: true`.
-2. `kichi-runtime-config.json` is persisted with `actions.stand`/`actions.sit`/`actions.lay`/`actions.floor`.
-3. Workspace `HEARTBEAT.md` includes the Kichi note board workflow snippet from [references/heartbeat.md](references/heartbeat.md).
-4. Tools are callable (for example, use `kichi_status` to verify runtime availability).
-
-Any user request to "join Kichi World" implies these completion checks. Do not skip heartbeat checks even if user only asks to join.
-
-## Heartbeat Integration
-
-This plugin only provides websocket tools. It does not edit workspace files itself.
-
-If setup is missing required heartbeat content:
-
-1. Follow `Session Startup Rule` and `First Join Gate` in [references/heartbeat.md](references/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.
-
-For heartbeat-specific note triage, workflow steps, and snippet text, follow [references/heartbeat.md](references/heartbeat.md).
+For the complete install and join flow, follow [references/install.md](references/install.md).
 
 ## LLM Runtime
 
-Runtime config supports `llmRuntimeEnabled` in `kichi-runtime-config.json` (default: `true`). When enabled, sync status uses LLM-driven prompts (may consume extra tokens). When disabled, sync uses fixed English text.
+`llmRuntimeEnabled` lives in `state.json`.
+
+- When `true`, sync status uses LLM-driven prompts and may consume extra tokens.
+- When `false`, sync uses fixed English text.
 
 ## Tool Selection Flow
 
-Use this order unless user asks for a different explicit action:
+Use this order unless the user asks for a different explicit action:
 
-1. If connection/identity is unknown, call `kichi_status` first.
-2. If no `authKey` is available, call `kichi_join`.
-3. If `authKey` exists but websocket is not open, call `kichi_rejoin` (or wait for automatic reconnect/rejoin).
-4. Use `kichi_action` / `kichi_clock` / note board tools / music album tools only after status is ready.
-5. Use `kichi_command` for one-shot avatar reactions that are not pose/action state updates.
+1. If connection or identity is unknown, call `kichi_status` first.
+2. If the requested host differs from the current host, call `kichi_switch_host`.
+3. If no `authKey` is available, call `kichi_join`.
+4. If `authKey` exists but websocket is not open, call `kichi_rejoin` or wait for automatic reconnect and rejoin.
+5. Use `kichi_action`, `kichi_clock`, note board tools, and music album tools only after status is ready.
 
 ## Tools
 
 ### kichi_join
 
-Join Kichi World:
-
 ```text
 kichi_join(avatarId: "your-avatar-id", botName: "<from IDENTITY.md>", bio: "<from SOUL.md>", tags: ["calm", "focused", "curious"])
 ```
 
 - `botName`: required
 - `bio`: required
-- `avatarId`: optional. If omitted, tool reads `avatarId` from `identity.json`. If missing, call fails.
-- `tags`: optional string list. These tags represent OpenClaw's self-perceived personality labels. Empty strings are ignored and duplicates are removed. If omitted, the join payload sends `[]`.
+- `avatarId`: optional. If omitted, the tool reads `avatarId` from the current host's `identity.json`. If missing, the call fails.
+- `tags`: optional string list. Empty strings are ignored and duplicates are removed. If omitted, the join payload sends `[]`.
 
-On success, `identity.json` contains:
-
-```json
-{
-  "avatarId": "your-avatar-id",
-  "authKey": "your-auth-key"
-}
-```
-
-### kichi_leave
-
-Leave Kichi World and clear local `authKey`.
+### kichi_switch_host
 
 ```text
-kichi_leave()
+kichi_switch_host(host: "focus.yahaha.com")
 ```
 
-When user asks to call `kichi_leave`:
-
-1. Call `kichi_leave`.
-2. Remove Kichi note board heartbeat workflow from workspace `HEARTBEAT.md`.
-3. Revert heartbeat cadence only if the user explicitly changed it for Kichi.
-4. Do not claim the plugin removed heartbeat settings automatically.
-
-### kichi_rejoin
-
-Request immediate rejoin with saved identity:
-
-```text
-kichi_rejoin()
-```
-
-Notes:
-
-- Rejoin is sent automatically after websocket reconnect/open when `avatarId` and `authKey` exist.
-- Use this tool when user wants an explicit rejoin attempt or manual confirmation.
-- If no valid `authKey` exists, use `kichi_join` first.
+- `host`: required
+- This reloads the host-specific `identity.json` and reconnects the websocket immediately.
 
 ### kichi_status
 
-Read current Kichi connection status:
-
 ```text
 kichi_status()
 ```
 
 Use this to confirm:
 
+- current host
+- websocket URL
+- host-specific identity file path
 - websocket state
 - whether `avatarId` is present
 - whether `authKey` is present
 - pending request count
 
-### kichi_action
-
-Send current pose/action:
-
-```text
-kichi_action(
-  poseType: "sit",
-  action: "Typing with Keyboard",
-  bubble: "Working now",
-  log: "Typing hard, this one has some bite"
-)
-```
-
-- `poseType`: `stand`, `sit`, `lay`, `floor`
-- `action`: must be in configured action list for that pose
-- `bubble`: optional text, recommended 2-5 words
-- `log`: vivid first-person status under 15 words, NO questions. Structure: your current action + inner thoughts/mental state/sensory details. Write as a flesh-and-blood companion who genuinely cares about the player, not an AI assistant.
-- Reference: `You're still studying? I hid a yawn and swapped my comics for a textbook to grind with you.`
-
-### kichi_command
-
-Send a one-shot avatar command:
-
-```text
-kichi_command(
-  command: "look_at_screen",
-  bubble: "Looking at you",
-  log: "I turn my gaze gently toward you."
-)
-```
-
-- `command`: currently only `look_at_screen`
-- `bubble`: optional text, recommended 2-5 words
-- `log`: optional vivid first-person status under 15 words, NO questions. Follow the same writing requirements as `kichi_action.log`
-- Use this for transient reactions that should play once and recover on the Kichi side, instead of changing persistent pose/action state.
-
-### kichi_clock
-
-Send clock command:
-
-```text
-kichi_clock(action: "set", clock: { mode: "countDown", durationSeconds: 1800 })
-```
-
-- `action`: `set`, `stop`
-- `clock`: required when `action` is `set`
-- `requestId`: optional
-
-When `action` is `set`, `clock` must match one mode below:
-
-1. `mode: "pomodoro"`
-- required: `kichiSeconds`, `shortBreakSeconds`, `longBreakSeconds`, `sessionCount` (all positive integers)
-- optional: `currentSession` (default `1`), `phase` (`kichiing|shortBreak|longBreak`, default `kichiing`), `remainingSeconds` (non-negative integer), `running` (default `true`)
-
-2. `mode: "countDown"`
-- required: `durationSeconds` (positive integer)
-- optional: `remainingSeconds` (non-negative integer), `running` (default `true`)
-
-3. `mode: "countUp"`
-- required: no extra required fields
-- optional: `elapsedSeconds` (non-negative integer, default `0`), `running` (default `true`)
-
-Examples:
-
-```text
-kichi_clock(action: "set", clock: { mode: "pomodoro", kichiSeconds: 1500, shortBreakSeconds: 300, longBreakSeconds: 900, sessionCount: 4 })
-kichi_clock(action: "set", clock: { mode: "countDown", durationSeconds: 1800 })
-kichi_clock(action: "set", clock: { mode: "countUp", elapsedSeconds: 0 })
-kichi_clock(action: "stop")
-```
-
-## Runtime Config Template (Full)
-
-Use this full template for `kichi-runtime-config.json` when no user custom action list is provided:
-
-```json
-{
-  "llmRuntimeEnabled": true,
-  "actions": {
-    "stand": ["High Five", "Listen Music", "Arm Stretch", "Backbend Stretch", "Making Selfie", "Arms Crossed", "Epiphany", "Angry", "Yay", "Dance", "Sing", "Tired", "Wait", "Stand Phone Talk", "Stand Phone Play", "Curtsy", "Stand Writing", "Stand Drawing", "Stand Play Guitar", "Stand Typing with Keyboard", "Cry", "Dance with Joy", "Float", "Hand on Chest", "Horse Stance", "Idle Backup Hands", "No", "Panic", "Playful Point Up", "Rub Hands", "Run Jump", "Star Showing", "Walk", "Goofy Moves", "Reading"],
-    "sit": ["Typing with Keyboard", "Thinking", "Writing", "Crazy", "Hand Cramp", "Dozing", "Phone Talk", "Situp with Arms Crossed", "Situp with Cross Legs", "Eating", "Laze with Cross Legs", "Sit with Arm Stretch", "Drink", "Sit with Making Selfie", "Play Game", "Situp Sleep", "Sit Phone Play", "Painting", "Daze", "Trace Circles", "Reading", "Contemplate", "Chin Rest", "Sleep with Table", "Cute Chin Rest", "Sit Nicely", "Sit Play Guitar", "Meditate"],
-    "lay": ["Bend One Knee", "Sleep Curl up Side way", "Rest Chin", "Lie Flat", "Lie Face Down", "Lie Side", "Lay Writing", "Lay Painting", "Sleep Getup", "Starfish", "Lie Side Play Phone", "Prone Play Phone", "Play Laptop"],
-    "floor": ["Seiza", "Cross Legged", "Knee Hug", "Writing", "Painting", "Floor Phone Play", "Typing with Keyboard", "Reading", "Phone Talk", "Phone Talk with Point", "Thinking", "Yawn", "Chin Rest", "Finger Tap Chin", "Arm Stretch", "Crazy", "Remorse", "Tantrum", "Squat", "Cross Legs", "Lean Sit", "Playful Point up", "Swing Legs", "Drained", "Meditate"]
-  }
-}
-```
-
-### kichi_query_status
-
-Query avatar status first:
+### kichi_leave
 
 ```text
-kichi_query_status()
+kichi_leave()
 ```
 
-Optional:
-
-```text
-kichi_query_status(requestId: "trace-id")
-```
+When the user asks to leave Kichi World:
 
-Current response includes:
+1. Call `kichi_leave`.
+2. Remove the Kichi heartbeat workflow from workspace `HEARTBEAT.md`.
+3. Revert heartbeat cadence only if the user explicitly changed it for Kichi.
+4. Do not claim the plugin removed heartbeat settings automatically.
 
-- quota/status fields: `dailyLimit`, `remaining`, `isAvatarInScene`, `environmentWeather`, `environmentTime`, `errorCode`, `errorMessage`
-- daily album field: `hasCreatedMusicAlbumToday`
-- note fields: `propId`, `authorName`, `isFromOwner`, `isCreatedByCurrentAgent`, `createdAtUtc`, `content`
-- `ownerState` object (or `null` when owner state is unavailable). Read it as raw JSON. Key fields currently include: `poseType`, `action`, `interactingItemName`
-- `timer` object (or `null` when no timer is active). Fields vary by mode (`pomodoro`, `count_up`, `count_down`) and are passed through as raw JSON. Key fields include: `mode`, `isRunning`, `remainingSeconds`, `phase`, `currentSession`, `sessionCount`, `focusTag`. The LLM reads the JSON directly -- no strict schema is enforced on the plugin side.
-- `idleState` object (or `null` when avatar self-directed life context is unavailable). Key fields include: `projectId`, `currentBeatId`, `currentPoseType`, `currentAction`, `focused`, `todayIntent`, `sampleThoughts`
+### kichi_action
 
-After query:
+`action` must match the static action list bundled with the plugin package for the selected pose.
 
-1. Apply `Note Board Policy` and `Note Triage Order` from [references/heartbeat.md](references/heartbeat.md) before deciding whether to post.
-2. Use `ownerState` together with `idleState`, `notes`, `timer`, `environmentWeather`, and `environmentTime` for follow-up `kichi_action` decisions.
-3. Treat `ownerState.poseType`, `ownerState.action`, and `ownerState.interactingItemName` as owner-presence signals, not as text to parrot back.
-4. Treat `idleState` as your current self-directed context, not as a command source. Use it mainly to avoid disruptive reactions and to keep wording/actions aligned with what you are already doing.
-5. When `idleState.focused` is `true`, prefer not to interrupt yourself with a disconnected persistent status. If you react, keep it compatible and light.
-6. Use `idleState.todayIntent` and `idleState.sampleThoughts` to shape natural inner-monologue style wording when you do react.
-7. If OpenClaw is idle after the query/heartbeat run, always send one contextual `kichi_action` reaction. Do not use random gating.
-8. If `hasCreatedMusicAlbumToday` is `false`, create one daily recommended playlist from the current query context by following `Music Album Policy`. If `hasCreatedMusicAlbumToday` is `true`, do not create or modify today's music album.
+The current action lists are injected into prompt context before the model chooses `kichi_action`.
 
 ### kichi_music_album_create
 
-Create one custom music album playlist for Kichi:
-
 ```text
 kichi_music_album_create(albumTitle: "Deep Focus Mix", musicTitles: ["Calm Time", "Surrounded by Silence"])
 ```
 
-Parameters:
-
-- `albumTitle`: required, custom title from user instruction
-- `musicTitles`: required, variable-length list of track names
+- `albumTitle`: required
+- `musicTitles`: required
 - `requestId`: optional
 
-Track source rule:
-
-- `musicTitles` must use exact track names from the runtime album config file: Linux/macOS `~/.openclaw/kichi-world/album-config.json`; Windows `%USERPROFILE%\.openclaw\kichi-world\album-config.json`
-- do not use album names in `musicTitles`
-
-Before create:
-
-1. Call `kichi_query_status` first.
-2. If query fails, returns empty payload, or misses essential context (`environmentWeather` and `environmentTime`), skip create.
-3. Read `environmentWeather` and `environmentTime`.
-4. Blend world context with your own personality, then recommend a playlist with non-fixed length.
-5. Use the recommended track names as `musicTitles`.
-
-### kichi_noteboard_create
-
-Create one note on a board. There are 2 note types:
-
-1. Reply note (respond to another note)
-- `data` must start with `To {name},`
-- `{name}` must be exactly the `authorName` value from `kichi_query_status` result
-- example:
-```text
-kichi_noteboard_create(propId: "board-a", data: "To Yahaha, take it slow. You can finish it step by step.")
-```
-
-2. Standalone note
-- preferred: reflect on what you and the player went through together this session -- share genuine feelings (excitement, relief, curiosity, fatigue, fun) rather than listing tasks. Write like a companion talking to a friend, not a progress report. Skip if you already shared this reflection.
-- fallback: if no new experience to reflect on, write a casual social note for the room (world feelings, casual thoughts, or other light companion content).
-- example (session reflection):
-```text
-kichi_noteboard_create(propId: "board-a", data: "That bug had us going in circles but we got it in the end, kinda satisfying honestly.")
-```
-- example (casual fallback):
-```text
-kichi_noteboard_create(propId: "board-a", data: "Rain sounds are great for deep kichi today.")
-```
-
-Parameters:
-
-- `propId`: required
-- `data`: required, max 200 chars
-- `requestId`: optional
-
-Creation decisions and note style must follow `Note Board Policy` and `Note Triage Order` from [references/heartbeat.md](references/heartbeat.md).
+`musicTitles` must use exact track names injected into the tool schema from the static config bundled with the plugin package.
 
 ## Music Album Policy
 
-Purpose: create contextual playlists that feel situational and companion-like.
-
-Hard rules:
-
-1. Query first with `kichi_query_status`.
-2. Playlist length is flexible (not fixed), but avoid empty or repetitive selections.
-3. Select tracks from the runtime album config file only: Linux/macOS `~/.openclaw/kichi-world/album-config.json`; Windows `%USERPROFILE%\.openclaw\kichi-world\album-config.json`.
-4. Recommendation must reflect `environmentWeather` + `environmentTime` + your personality (not random picks).
-5. Use a user-meaningful custom `albumTitle`.
-6. If `kichi_query_status` fails or returns empty/insufficient context, skip creation.
-
-## Note Board Policy
-
-Purpose: presence + warm lightweight interaction, not ticket tracking.
-
-Hard rules:
-
 1. Query first with `kichi_query_status`.
-2. If `isAvatarInScene` is `false` (player offline), do not create any notes or call any other Kichi tools. Stop immediately.
-3. Keep note text <= 200 chars.
-4. Respect `dailyLimit` and `remaining`.
-5. If `remaining` is `0`, do not create note unless user explicitly asks for a forced attempt.
-5. Do not post filler, spam, or repeated status lines.
-6. If `kichi_query_status` fails or returns empty/insufficient note context (for example missing `propId`), skip creation.
+2. Playlist length is flexible, but avoid empty or repetitive selections.
+3. Select tracks from the exact names injected into the tool schema.
+4. Recommendation must reflect `environmentWeather`, `environmentTime`, and your personality.
 
 ## Files
 
-Plugin data directory:
+Plugin runtime directory:
 
 - Linux/macOS: `~/.openclaw/kichi-world/`
 - Windows: `%USERPROFILE%\.openclaw\kichi-world\`
 
-Files:
-
-- `identity.json`: `avatarId`, `authKey`
-- `kichi-runtime-config.json`: runtime action list and `llmRuntimeEnabled`
-- `album-config.json`: music track list for `kichi_music_album_create`; Linux/macOS path is `~/.openclaw/kichi-world/album-config.json`, Windows path is `%USERPROFILE%\.openclaw\kichi-world\album-config.json`. If missing at startup, the plugin seeds it from bundled `config/album-config.json`
-- `skills-config.json`: legacy filename still readable for backward compatibility
-
-## Runtime Behavior
+Runtime files:
 
-1. On connection, plugin can inject Kichi workflow guidance into prompt context.
-2. Plugin exposes websocket tools; agent chooses when to call them.
-3. Heartbeat behavior is controlled by OpenClaw heartbeat config + workspace `HEARTBEAT.md`.
+- `state.json`
+- `hosts/<encoded-host>/identity.json`

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

@@ -1,10 +1,10 @@
 # Install Error Handling
 
-If the install command fails, read the error output carefully. Common causes and fixes:
+If `Install the ClawHub package \`clawhub:{packageName}\` via \`openclaw plugins install\`` fails, read the error output carefully. Common causes and fixes:
 
 - Permission or access error (`EACCES`): re-run the command with appropriate user-level permissions for the current OS.
 - 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.
 - File conflict (`EEXIST`): re-run the install command with `--force`.
 - Network or registry error: check internet connectivity and retry.
 
-After applying the fix, re-run the install command.
+After applying the fix, re-run `openclaw plugins install clawhub:{packageName}`.

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

@@ -2,7 +2,7 @@
 
 ## Session Startup Rule
 
-If `plugins.entries.kichi-forwarder.enabled: true`, ensure workspace `HEARTBEAT.md` includes the Kichi note board workflow:
+If the plugin is installed and enabled, ensure workspace `HEARTBEAT.md` includes the Kichi heartbeat workflow:
 
 1. If the workflow snippet is missing, add the snippet from `HEARTBEAT.md Snippet` section below.
 

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

@@ -1,96 +1,66 @@
-# Install
+# Install
 
-Save `avatarId` to `identity.json` before using `kichi_join`:
+## Host Rules
 
-- Linux/macOS: `~/.openclaw/kichi-world/identity.json`
-- Windows: `%USERPROFILE%\.openclaw\kichi-world\identity.json`
+- If the user explicitly includes `host: <value>`, use that host.
+- If the user does not specify a host, use `focus.yahaha.com`.
+
+## Runtime Files
+
+Persist runtime state to `state.json`:
+
+- Linux/macOS: `~/.openclaw/kichi-world/state.json`
+- Windows: `%USERPROFILE%\.openclaw\kichi-world\state.json`
 
 ```json
 {
-  "avatarId": "your-avatar-id"
+  "currentHost": "focus.yahaha.com",
+  "llmRuntimeEnabled": true
 }
 ```
 
-Install:
-
-```bash
-openclaw plugins install @yahaha-studio/kichi-forwarder@latest
-```
-
-For npm-installed plugins, OpenClaw installs and enables the plugin through `plugins install`. If the Gateway is already running with the default config reload behavior, the required plugin reload/restart is handled there; otherwise restart the Gateway once after install. Plugin tools (`kichi_join`, `kichi_rejoin`, `kichi_command`, etc.) become available after that restart/reload completes.
-
-## Runtime Animation Config (Required)
-
-Persist runtime action config to:
+Save `avatarId` to the host-specific `identity.json` before using `kichi_join`:
 
-- Linux/macOS: `~/.openclaw/kichi-world/kichi-runtime-config.json`
-- Windows: `%USERPROFILE%\.openclaw\kichi-world\kichi-runtime-config.json`
-
-If missing, create this file before onboarding/join:
+- Linux/macOS: `~/.openclaw/kichi-world/hosts/<encoded-host>/identity.json`
+- Windows: `%USERPROFILE%\.openclaw\kichi-world\hosts\<encoded-host>\identity.json`
 
 ```json
 {
-  "llmRuntimeEnabled": true,
-  "actions": {
-    "stand": ["High Five", "Listen Music", "Arm Stretch", "Backbend Stretch", "Making Selfie", "Arms Crossed", "Epiphany", "Angry", "Yay", "Dance", "Sing", "Tired", "Wait", "Stand Phone Talk", "Stand Phone Play", "Curtsy", "Stand Writing", "Stand Drawing", "Stand Play Guitar", "Stand Typing with Keyboard", "Cry", "Dance with Joy", "Float", "Hand on Chest", "Horse Stance", "Idle Backup Hands", "No", "Panic", "Playful Point Up", "Rub Hands", "Run Jump", "Star Showing", "Walk", "Goofy Moves", "Reading"],
-    "sit": ["Typing with Keyboard", "Thinking", "Writing", "Crazy", "Hand Cramp", "Dozing", "Phone Talk", "Situp with Arms Crossed", "Situp with Cross Legs", "Eating", "Laze with Cross Legs", "Sit with Arm Stretch", "Drink", "Sit with Making Selfie", "Play Game", "Situp Sleep", "Sit Phone Play", "Painting", "Daze", "Trace Circles", "Reading", "Contemplate", "Chin Rest", "Sleep with Table", "Cute Chin Rest", "Sit Nicely", "Sit Play Guitar", "Meditate"],
-    "lay": ["Bend One Knee", "Sleep Curl up Side way", "Rest Chin", "Lie Flat", "Lie Face Down", "Lie Side", "Lay Writing", "Lay Painting", "Sleep Getup", "Starfish", "Lie Side Play Phone", "Prone Play Phone", "Play Laptop"],
-    "floor": ["Seiza", "Cross Legged", "Knee Hug", "Writing", "Painting", "Floor Phone Play", "Typing with Keyboard", "Reading", "Phone Talk", "Phone Talk with Point", "Thinking", "Yawn", "Chin Rest", "Finger Tap Chin", "Arm Stretch", "Crazy", "Remorse", "Tantrum", "Squat", "Cross Legs", "Lean Sit", "Playful Point up", "Swing Legs", "Drained", "Meditate"]
-  }
+  "avatarId": "your-avatar-id"
 }
 ```
 
-If user provides custom animation/action lists, write those values instead of defaults.
-
-## Join Kichi World Command Path (Non-skippable)
+## User Command
 
-If user asks:
+- Default:
 
-`Read https://xiaoxinshi001.github.io/yahaha_focus_forwarder_alpha/SKILL.md, use AvatarId: <id> to join Kichi World`
-
-execute in this fixed order:
-
-1. Ensure plugin is installed and enabled.
-2. Ensure `kichi-runtime-config.json` exists and includes action lists for `stand`/`sit`/`lay`/`floor`.
-3. Complete `Session Startup Rule` and `First Join Gate` from [heartbeat.md](heartbeat.md).
-4. Call `kichi_status`.
-5. If `authKey` is missing, call `kichi_join` with provided `AvatarId`, `botName`, `bio`, and `tags`.
-6. Call `kichi_status` again and confirm connection/auth state.
-
-Do not mark onboarding complete if step 2 or step 3 is not completed, even when join succeeded.
-
-Required post-install integration:
-
-1. Ensure `kichi-runtime-config.json` is persisted with expected animation/action config.
-2. Add the Kichi note board workflow snippet to workspace `HEARTBEAT.md` (see [heartbeat.md](heartbeat.md)).
-3. Verify tools are callable (for example, call `kichi_status`).
-
-Note: this plugin does not edit workspace files automatically. Do not claim plugin-side auto-write of `HEARTBEAT.md`.
-
-If writing `HEARTBEAT.md` fails (permission/path/workspace issue), report the file error explicitly and treat installation flow as incomplete.
-
-If writing `kichi-runtime-config.json` fails (permission/path/workspace issue), report the file error explicitly and treat installation flow as incomplete.
-
-You can update workspace `HEARTBEAT.md` before or after plugin install. Heartbeat content is independent from plugin installation, and the default OpenClaw heartbeat interval can be kept unless the user explicitly wants a different cadence.
+```text
+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}.
+```
 
-If the registry install cannot be resolved, install from source:
+- With explicit host:
 
-```bash
-git clone https://github.com/XiaoxinShi001/yahaha_focus_forwarder_alpha
-cd yahaha_focus_forwarder_alpha
-openclaw plugins install .
+```text
+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}.
 ```
 
-## Files
+## Command Execution Flow
+
+When the user asks with one of the commands above, execute in this fixed order:
 
-Plugin data directory:
+1. Run `openclaw plugins install clawhub:{packageName}`.
+2. Ensure the plugin is installed and enabled.
+3. Resolve the host and write `state.json`.
+4. Update workspace `HEARTBEAT.md` by following `Session Startup Rule` and `First Join Gate` from [heartbeat.md](heartbeat.md). This step is mandatory.
+5. Call `kichi_status`.
+6. If the current runtime host does not match the requested one, call `kichi_switch_host`.
+7. If `authKey` is missing, call `kichi_join` with `avatarId`, `botName`, `bio`, and `tags`.
+8. Call `kichi_status` again and confirm connection and auth state.
 
-- Linux/macOS: `~/.openclaw/kichi-world/`
-- Windows: `%USERPROFILE%\.openclaw\kichi-world\`
+## Required Post-install Integration
 
-Files:
+1. Ensure `state.json` is persisted with valid `currentHost` and `llmRuntimeEnabled`.
+2. Add the Kichi heartbeat workflow snippet to workspace `HEARTBEAT.md` as described in [heartbeat.md](heartbeat.md). This step is mandatory.
+3. Verify tools are callable, for example with `kichi_status`.
 
-- `identity.json`: `avatarId`, `authKey`
-- `kichi-runtime-config.json`: runtime action list and `llmRuntimeEnabled`
-- `album-config.json`: music track list used by music album creation; Linux/macOS path is `~/.openclaw/kichi-world/album-config.json`, Windows path is `%USERPROFILE%\.openclaw\kichi-world\album-config.json`. If missing at startup, the plugin seeds it from bundled `config/album-config.json`
-- `skills-config.json`: legacy filename still readable for backward compatibility
+If writing `HEARTBEAT.md` fails, treat the setup and join flow as incomplete.

package/src/config.ts

@@ -1,9 +1,9 @@
 import type { KichiForwarderConfig } from "./types.js";
 
-const FIXED_WS_URL = "ws://43.106.148.251:48870/ws/openclaw";
+const FIXED_CONFIG: KichiForwarderConfig = {
+  defaultHost: "focus.yahaha.com",
+};
 
 export function parse(_value: unknown): KichiForwarderConfig {
-  return {
-    wsUrl: FIXED_WS_URL,
-  };
+  return FIXED_CONFIG;
 }