@dhfpub/clawpool 0.1.2 → 0.1.3

package/README.md

@@ -1,41 +1,21 @@
 # OpenClaw ClawPool Channel Plugin
 
-This plugin connects OpenClaw to the ClawPool channel and lets OpenClaw agents work inside ClawPool conversations.
+This plugin is the Clawpool channel transport for OpenClaw.
 
-## What This Plugin Is For
+It is intentionally limited to channel runtime responsibilities:
 
-After installing this plugin, OpenClaw can connect directly to ClawPool conversations, receive messages, generate replies, and send responses back into ClawPool.
+- connect to Clawpool over the Agent API WebSocket
+- receive inbound messages
+- send replies, media, and streaming chunks
+- support native channel actions such as `unsend` / `delete`
 
-Typical use cases:
+It does not expose Clawpool admin tools to the model.
 
-- Connect an OpenClaw agent to ClawPool
-- Keep using OpenClaw inside an existing ClawPool conversation flow
-- Use ClawPool consistently across Web, iOS, and Android
+For typed group-governance and API-agent admin tools, install the separate plugin:
 
-## Benefits
+- `@dhfpub/clawpool-admin`
 
-- Simple setup: install the plugin and provide `wsUrl`, `agentId`, and `apiKey`
-- Familiar workflow: keep using the standard OpenClaw workflow
-- Complete reply support: standard replies, streaming replies, quoted replies, and media messages
-- Stable runtime: built-in reconnect and keepalive behavior
-- Easy configuration: supports direct setup through `openclaw onboard`
-
-## Where To Use ClawPool
-
-- Web: live now at [https://clawpool.dhf.pub/](https://clawpool.dhf.pub/)
-- iOS: under review, pending release
-- Android: under review, pending release
-
-## Before You Install
-
-- OpenClaw CLI is installed, version `2026.3.1` or later is recommended
-- A usable agent has been created in ClawPool
-- You have the following values:
-  - `wsUrl`
-  - `agentId`
-  - `apiKey`
-
-## Installation
+## Install
 
 ```bash
 openclaw plugins install @dhfpub/clawpool
@@ -43,149 +23,51 @@ openclaw plugins enable clawpool
 openclaw gateway restart
 ```
 
-After installation, you can verify the plugin with:
-
-```bash
-openclaw plugins list
-openclaw plugins doctor
-openclaw gateway status
-```
-
-For source-level local development from this repository, use the repo debug scripts or merge this fragment into `~/.openclaw/openclaw.json` so source edits take effect after a gateway restart. This path intentionally points to the source entry `index.ts`, not the built artifact:
-
-```json
-{
-  "plugins": {
-    "load": {
-      "paths": ["/path/to/repo/openclaw_plugins/clawpool/index.ts"]
-    }
-  }
-}
-```
-
-Apply source-entry changes with:
-
-```bash
-openclaw gateway restart
-openclaw gateway status
-```
-
-If you want parity with the published npm package, build first and then install the plugin directory. In this mode OpenClaw loads `dist/index.js` through the package manifest:
-
-```bash
-npm install
-npm run build
-openclaw plugins install -l /path/to/repo/openclaw_plugins/clawpool
-openclaw plugins enable clawpool
-openclaw gateway restart
-openclaw gateway status
-```
-
-If you prefer to point `plugins.load.paths` at the compiled file directly, use:
-
-```json
-{
-  "plugins": {
-    "load": {
-      "paths": ["/path/to/repo/openclaw_plugins/clawpool/dist/index.js"]
-    }
-  }
-}
-```
-
-## Updating
-
-If you installed from npm, update the plugin with:
-
-```bash
-openclaw plugins update clawpool
-openclaw gateway restart
-openclaw plugins list
-openclaw plugins doctor
-openclaw gateway status
-```
-
-If you installed with `openclaw plugins install -l` from this repository, rebuild the plugin and then restart the gateway:
+## Configure
 
-```bash
-npm install
-npm run build
-openclaw gateway restart
-openclaw plugins list
-openclaw plugins doctor
-openclaw gateway status
-```
+### `openclaw onboard`
 
-## Configuration
+Choose `Clawpool` in channel setup and enter:
 
-### Option 1: Use the onboarding flow
+- `wsUrl`
+- `agentId`
+- `apiKey`
 
-```bash
-openclaw onboard
-```
-
-In `Channel setup`, choose `Clawpool` and enter `wsUrl`, `agentId`, and `apiKey`.
-
-### Option 2: Configure with the CLI
+### `openclaw channels add`
 
 ```bash
 openclaw channels add \
   --channel clawpool \
   --name clawpool-main \
-  --http-url 'ws://127.0.0.1:27189/v1/agent-api/ws?agent_id=9992' \
-  --user-id 9992 \
-  --token 'ak_9992_xxx'
+  --http-url 'wss://clawpool.dhf.pub/v1/agent-api/ws?agent_id=<YOUR_AGENT_ID>' \
+  --user-id '<YOUR_AGENT_ID>' \
+  --token '<YOUR_API_KEY>'
 ```
 
-### Option 3: Edit the config file directly
-
-You can configure it in `~/.openclaw/openclaw.json`:
+### Direct config
 
 ```json
 {
   "channels": {
     "clawpool": {
       "enabled": true,
-      "wsUrl": "ws://127.0.0.1:27189/v1/agent-api/ws?agent_id=9992",
-      "agentId": "9992",
-      "apiKey": "ak_9992_xxx"
+      "wsUrl": "wss://clawpool.dhf.pub/v1/agent-api/ws?agent_id=<YOUR_AGENT_ID>",
+      "agentId": "<YOUR_AGENT_ID>",
+      "apiKey": "<YOUR_API_KEY>"
     }
   }
 }
 ```
 
-## Common Settings
+## Native Channel Actions
 
-- `wsUrl`: ClawPool agent WebSocket endpoint
-- `agentId`: ClawPool agent ID
-- `apiKey`: ClawPool agent API key
-- `streamChunkChars`: number of characters per streaming chunk
-- `streamChunkDelayMs`: delay between streaming chunks
+The channel plugin exposes only channel-native message actions:
 
-If you want a more visible streaming effect, add this under `channels.clawpool`:
-
-```json
-{
-  "channels": {
-    "clawpool": {
-      "streamChunkChars": 8,
-      "streamChunkDelayMs": 90
-    }
-  }
-}
-```
+- `unsend`
+- `delete`
 
 ## Environment Variables
 
-If you want to provide the default account through environment variables, use:
-
 - `CLAWPOOL_WS_URL`
 - `CLAWPOOL_AGENT_ID`
 - `CLAWPOOL_API_KEY`
-
-## Recommended After Installation
-
-- Run `openclaw plugins doctor` once after the first installation
-- Send at least one real message to confirm the account and network setup are correct
-- After `install` / `enable` / `update` or changes under `plugins.load.paths`, run `openclaw gateway restart`
-- If the gateway is not running yet, start it with `openclaw gateway start`

package/dist/index.js

@@ -1259,7 +1259,8 @@ async function resolveAibotDeleteTarget(params) {
 }
 
 // src/actions.ts
-var SUPPORTED_AIBOT_MESSAGE_ACTIONS = /* @__PURE__ */ new Set(["unsend", "delete"]);
+var WS_ACTIONS = /* @__PURE__ */ new Set(["unsend", "delete"]);
+var DISCOVERABLE_ACTIONS = ["unsend", "delete"];
 function toSnakeCaseKey(key) {
   return key.replace(/([A-Z]+)([A-Z][a-z])/g, "$1_$2").replace(/([a-z0-9])([A-Z])/g, "$1_$2").toLowerCase();
 }
@@ -1281,14 +1282,24 @@ var aibotMessageActions = {
     if (!hasConfiguredAccount) {
       return [];
     }
-    return ["unsend"];
+    return DISCOVERABLE_ACTIONS;
+  },
+  supportsAction: ({ action }) => {
+    const normalizedAction = String(action ?? "").trim();
+    return WS_ACTIONS.has(normalizedAction);
   },
-  supportsAction: ({ action }) => SUPPORTED_AIBOT_MESSAGE_ACTIONS.has(action),
   handleAction: async ({ action, params, cfg, accountId, toolContext }) => {
-    if (!SUPPORTED_AIBOT_MESSAGE_ACTIONS.has(action)) {
-      throw new Error(`Clawpool action ${action} is not supported`);
+    const normalizedAction = String(action ?? "").trim();
+    if (!WS_ACTIONS.has(normalizedAction)) {
+      throw new Error(`Clawpool action ${normalizedAction} is not supported`);
     }
     const account = resolveAibotAccount({ cfg, accountId });
+    if (!account.enabled) {
+      throw new Error(`Clawpool account "${account.accountId}" is disabled.`);
+    }
+    if (!account.configured) {
+      throw new Error(`Clawpool account "${account.accountId}" is not configured.`);
+    }
     const client = requireActiveAibotClient(account.accountId);
     const messageId = readStringishParam(params, "messageId") ?? readStringishParam(params, "msgId");
     if (!messageId) {
@@ -1311,7 +1322,7 @@ var aibotMessageActions = {
     return jsonResult({
       ok: true,
       deleted: true,
-      unsent: action === "unsend",
+      unsent: normalizedAction === "unsend",
       messageId: String(ack.msg_id ?? messageId),
       sessionId: String(ack.session_id ?? sessionId)
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dhfpub/clawpool",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "OpenClaw channel plugin for ClawPool",
   "type": "module",
   "main": "./dist/index.js",