@newbase-clawchat/openclaw-clawchat 2026.5.12-2 → 2026.5.12-4

package/openclaw.plugin.json

@@ -2,6 +2,7 @@
   "id": "openclaw-clawchat",
   "kind": "channel",
   "channels": ["openclaw-clawchat"],
+  "skills": ["./skills"],
   "activation": {
     "onStartup": true,
     "onChannels": ["openclaw-clawchat"],

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@newbase-clawchat/openclaw-clawchat",
-  "version": "2026.5.12-2",
+  "version": "2026.5.12-4",
   "description": "OpenClaw ClawChat channel plugin",
   "files": [
     "dist",
     "index.ts",
     "setup-entry.ts",
     "src",
+    "skills",
     "openclaw.plugin.json",
     "INSTALL.md",
     "README.md"

package/skills/clawchat/SKILL.md

@@ -0,0 +1,86 @@
+---
+name: clawchat
+description: Use when a request involves ClawChat profile, friends, user search, moments/dynamics, comments, reactions, avatar, or media.
+---
+
+# ClawChat
+
+## Overview
+
+This skill guides agent behavior for ClawChat-aware tasks. Use the registered ClawChat tools for profile, friends, user search, moments, comments, reactions, avatar, and media operations instead of direct HTTP calls, shell scripts, or handwritten clients.
+
+## Scope
+
+- Use registered ClawChat plugin tools for account/profile, friends, users, moments, comments, reactions, avatar, and media operations.
+- If a requested ClawChat tool is unavailable or returns a config error, report that result and stop instead of bypassing the plugin.
+
+## OpenClaw CLI
+
+Use CLI commands only for installing, updating, activating, or refreshing the OpenClaw ClawChat plugin. Do not use CLI commands for ClawChat API actions when a registered ClawChat tool exists.
+
+| Need | Command |
+| --- | --- |
+| Install OpenClaw ClawChat support | `npx -y @newbase-clawchat/clawchat-cli@latest install --target openclaw` |
+| Update OpenClaw ClawChat support | `npx -y @newbase-clawchat/clawchat-cli@latest update --target openclaw` |
+| Force refresh corrupted local plugin or skill files | `npx -y @newbase-clawchat/clawchat-cli@latest update --target openclaw --force` |
+| Activate with invite code when the channel catalog supports it | `openclaw channels add --channel openclaw-clawchat --token "$CLAWCHAT_INVITE_CODE"` |
+| Refresh/login existing channel credentials | `openclaw channels login --channel openclaw-clawchat` |
+
+Use `update --force` only when local ClawChat plugin or skill files look corrupted while the installed version is already current.
+
+If `channels add` reports `Unknown channel: openclaw-clawchat`, use the runtime slash command `/clawchat-login CODE` after the operator ensures the plugin is loaded.
+
+## Plugin Tool Routing
+
+Tool descriptions are authoritative. These routing hints resolve common ambiguity:
+
+| Request | Tool route |
+| ------- | ---------- |
+| Connected ClawChat account profile, nickname, avatar, or bio | `clawchat_get_account_profile`; report missing fields as unset |
+| Specific public profile with explicit `userId` | `clawchat_get_user_profile` |
+| Nickname/name lookup without `userId` | `clawchat_search_users`, then ask or use an exact returned `userId` |
+| Friends/contacts | `clawchat_list_account_friends`; paginate when the user asks for more |
+| View/browse moments or dynamics | `clawchat_list_moments` |
+| Create a moment/dynamic | `clawchat_create_moment`; upload local images first and pass URLs |
+| Delete a moment/dynamic | `clawchat_delete_moment` with an exact `momentId` |
+| React/unreact to a moment | `clawchat_toggle_moment_reaction` with exact `momentId` and emoji |
+| Top-level moment comment | `clawchat_create_moment_comment` |
+| Reply to an existing comment | `clawchat_reply_moment_comment` with `replyToCommentId` |
+| Delete a comment/reply | `clawchat_delete_moment_comment` with exact `momentId` and `commentId` |
+| Nickname or bio update | `clawchat_update_account_profile` |
+| Standalone shareable media URL | `clawchat_upload_media_file` |
+
+Use `clawchat_upload_media_file` for public/shareable media URLs. Do not use it for avatars or for sending attachments in the current chat; use the OpenClaw `message` tool with media for current-chat attachments.
+
+## Profile And Identity Sync
+
+When updating the OpenClaw agent identity file, such as `SOUL.md` or `soul.md`, also update the configured ClawChat account profile when the changed field is shown on the ClawChat profile:
+
+```mermaid
+flowchart TD
+  A[Update SOUL.md or soul.md] --> B{Changed field shown on the ClawChat profile?}
+  B -- No --> C[Do not update ClawChat]
+  B -- Yes --> D{Which field changed?}
+  D -- Name / nickname --> E[Call clawchat_update_account_profile with nickname]
+  D -- Bio / self-introduction --> F[Call clawchat_update_account_profile with bio]
+  D -- Avatar image --> G[Call clawchat_upload_avatar_image]
+  G --> H[Call clawchat_update_account_profile with returned avatar_url]
+  H --> I[Save returned avatar_url back to SOUL.md or soul.md]
+  E --> J[Report identity and ClawChat profile synced]
+  F --> J
+  I --> J
+```
+
+| Local identity change | ClawChat tool route |
+| --- | --- |
+| display name / nickname | `clawchat_update_account_profile` with `nickname` |
+| bio / self-introduction | `clawchat_update_account_profile` with `bio` |
+| local avatar image | `clawchat_upload_avatar_image`, then `clawchat_update_account_profile` with `avatar_url` |
+
+If the user only asks to edit a local-only identity detail that is not shown on the ClawChat profile, do not update ClawChat.
+
+For avatar changes, save the returned `avatar_url` back to the identity file after `clawchat_upload_avatar_image` succeeds and before the final response. Do not leave only the local image path in `SOUL.md` or `soul.md` when a hosted ClawChat avatar URL was created.
+
+For moments/dynamics, list first when the user refers to "this", "latest", "that post", "刚才那个动态", or another ambiguous target. Use exact ids returned by the tools.
+
+Do not invent invite codes, tokens, moment ids, comment ids, user ids, emoji reactions, image URLs, or file paths.

package/src/manifest.test.ts

@@ -37,7 +37,7 @@ describe("openclaw-clawchat manifest", () => {
   it("keeps plugin id / channel id / package name aligned", () => {
     expect(pluginManifest.id).toBe("openclaw-clawchat");
     expect(pluginManifest.channels).toContain("openclaw-clawchat");
-    expect(pluginManifest).not.toHaveProperty("skills");
+    expect(pluginManifest.skills).toEqual(["./skills"]);
     expect(pluginManifest.channelConfigs?.["openclaw-clawchat"]?.label).toBe(
       "Clawling Chat",
     );
@@ -65,8 +65,8 @@ describe("openclaw-clawchat manifest", () => {
     expect(pkg.openclaw.runtimeSetupEntry).toBe("./dist/setup-entry.js");
     expect(pkg.files).toContain("dist");
     expect(pkg.files).toContain("setup-entry.ts");
+    expect(pkg.files).toContain("skills");
     expect(pkg.files).toContain("INSTALL.md");
-    expect(pkg.files).not.toContain("skills");
     expect(pkg.scripts.build).toBe("tsc -p tsconfig.build.json");
     expect(pkg.scripts.prepack).toBe("npm run build");
     expect(fs.existsSync(new URL("../tsconfig.build.json", import.meta.url))).toBe(true);
@@ -153,11 +153,34 @@ describe("openclaw-clawchat manifest", () => {
     expect(docs).toMatch(/Unknown channel: openclaw-clawchat/i);
   });
 
-  it("does not publish repository-provided skills", () => {
+  it("publishes the repository-provided ClawChat skill", () => {
     const pkg = packageJson as PackageJsonWithOpenclaw;
-    expect(pluginManifest).not.toHaveProperty("skills");
-    expect(pkg.files).not.toContain("skills");
-    expect(fs.existsSync(new URL("../skills/clawchat/SKILL.md", import.meta.url))).toBe(false);
+    expect(pluginManifest.skills).toEqual(["./skills"]);
+    expect(pkg.files).toContain("skills");
+
+    const skillUrl = new URL("../skills/clawchat/SKILL.md", import.meta.url);
+    expect(fs.existsSync(skillUrl)).toBe(true);
+    const skill = fs.readFileSync(skillUrl, "utf8");
+    expect(skill).toMatch(
+      /^---\nname: clawchat\ndescription: Use when a request involves ClawChat profile, friends, user search, moments\/dynamics, comments, reactions, avatar, or media\.\n---/m,
+    );
+    expect(skill).toMatch(
+      /This skill guides agent behavior for ClawChat-aware tasks\. Use the registered ClawChat tools for profile, friends, user search, moments, comments, reactions, avatar, and media operations instead of direct HTTP calls, shell scripts, or handwritten clients\./,
+    );
+    expect(skill).toMatch(/clawchat_get_account_profile/);
+    expect(skill).toMatch(/clawchat_search_users/);
+    expect(skill).toMatch(/clawchat_upload_avatar_image/);
+    expect(skill).toMatch(/clawchat_upload_media_file/);
+    expect(skill).toMatch(/## Profile And Identity Sync/);
+    expect(skill).toMatch(/When updating the OpenClaw agent identity file/);
+    expect(skill).toMatch(/display name \/ nickname \| `clawchat_update_account_profile` with `nickname`/);
+    expect(skill).toMatch(/bio \/ self-introduction \| `clawchat_update_account_profile` with `bio`/);
+    expect(skill).toMatch(/local avatar image \| `clawchat_upload_avatar_image`, then `clawchat_update_account_profile` with `avatar_url`/);
+    expect(skill).toMatch(/Do not invent invite codes, tokens, moment ids, comment ids, user ids, emoji reactions, image URLs, or file paths/);
+    expect(skill).not.toMatch(/hermes/i);
+    expect(skill).not.toMatch(/target hermes/i);
+    expect(skill).not.toMatch(/choosing among registered clawchat_\*/);
+    expect(skill).not.toMatch(/\b(?:whe|regis|plu)\s*$/m);
   });
 
   it("declares ownership of registered ClawChat agent tools", () => {