@rowger_go/chatu 0.1.3

package/.github/workflows/ci.yml

@@ -0,0 +1,30 @@
+name: CI
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+    branches: ["main"]
+
+jobs:
+  build-and-test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          cache: "npm"
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Build
+        run: npm run build
+
+      - name: Test
+        run: npm test

package/.github/workflows/publish.yml

@@ -0,0 +1,55 @@
+name: Publish to npm
+
+# Triggered when a version tag is pushed (e.g. v0.1.1, v1.2.3)
+# To publish a new version, run one of:
+#   npm run release:patch   (0.1.0 → 0.1.1)
+#   npm run release:minor   (0.1.0 → 0.2.0)
+#   npm run release:major   (0.1.0 → 1.0.0)
+#
+# These scripts bump package.json, commit the change, create a git tag,
+# and push — which triggers this workflow.
+#
+# Required secret: NPM_TOKEN
+#   1. Create an Automation token at https://www.npmjs.com/settings/<user>/tokens
+#   2. Add it to GitHub: Settings → Secrets and variables → Actions → NPM_TOKEN
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          registry-url: "https://registry.npmjs.org"
+          cache: "npm"
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Build
+        run: npm run build
+
+      - name: Test
+        run: npm test
+
+      - name: Publish to npm
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true

package/INSTALL.md

@@ -0,0 +1,285 @@
+# Chatu Channel Installation Guide
+
+**English | [中文](INSTALL.zh.md)**
+
+> This guide covers installing the Chatu channel to connect OpenClaw with any Website.
+
+---
+
+## 1. Installation Methods
+
+### 1.1 From npm (Recommended)
+
+```bash
+# Install as OpenClaw plugin
+openclaw plugins install @rowger_go/chatu
+
+# Or using npm directly (if publishing to npm)
+npm install -g @rowger_go/chatu
+```
+
+### 1.2 From Source
+
+**Method A: Auto-build Install (Recommended)**
+
+```bash
+# Clone the repository
+git clone https://github.com/chatu-ai/webhub.git
+cd webhub
+
+# Install as plugin (will auto-build via prepare script)
+openclaw plugins install .
+```
+
+**Method B: Manual Build Install**
+
+```bash
+# Clone the repository
+git clone https://github.com/chatu-ai/webhub.git
+cd webhub
+
+# Build the plugin
+npm install
+npm run build
+
+# Install locally
+openclaw plugins install .
+```
+
+### 1.3 Development Mode
+
+```bash
+# Link for development (with hot reload)
+openclaw plugins install -l .
+cd /path/to/webhub
+npm run watch
+```
+
+---
+
+## 2. Configuration
+
+### 2.1 Quick Setup
+
+```bash
+# Enable the channel
+openclaw config set channels.chatu.enabled true
+
+# Set Chatu service API URL (provided by your WebHub backend)
+openclaw config set channels.chatu.apiUrl "https://your-website.com"
+
+# Set channel ID (from WebHub admin panel)
+openclaw config set channels.chatu.channelId "wh_ch_xxxxxx"
+
+# Set access token (provided by your WebHub backend)
+openclaw config set channels.chatu.accessToken "wh_eyJhbGciOiJIUzI1NiIs..."
+
+# Apply changes
+openclaw gateway restart
+```
+
+### 2.2 Full Configuration
+
+```json5
+{
+  channels: {
+    chatu: {
+      enabled: true,
+      
+      // WebHub service base URL [Required]
+      apiUrl: "https://your-website.com",
+      
+      // Channel ID from WebHub admin panel [Required]
+      channelId: "wh_ch_xxxxxx",
+      
+      // Access token [Required unless using secret]
+      accessToken: "wh_eyJhbGciOiJIUzI1NiIs...",
+      
+      // Channel secret for registration [Alternative to accessToken]
+      // secret: "wh_secret_xxxxxxxxxx",
+      
+      // Request timeout (ms) [Optional]
+      timeout: 30000,
+    }
+  }
+}
+```
+
+### 2.3 Environment Variables (Quick Register)
+
+If your WebHub backend supports auto-registration, you can skip manual credential setup:
+
+```bash
+# Set registration key and service URL
+export CHATU_KEY="your-registration-key"
+export CHATU_URL="https://your-website.com"
+
+# Restart gateway to trigger auto-registration
+openclaw gateway restart
+```
+
+The plugin will automatically call `POST /api/channel/quick-register` and save the returned `channelId` and `accessToken` to config.
+
+---
+
+## 3. Verify Installation
+
+### 3.1 Check Plugin Status
+
+```bash
+# Verify plugin is loaded
+openclaw plugins list | grep chatu
+
+# Expected output:
+# │ Chatu │ chatu │ loaded │ .../dist/index.js │ 0.1.0 │
+```
+
+### 3.2 Check Configuration
+
+```bash
+# View current chatu config
+openclaw config get channels.chatu
+```
+
+### 3.3 View Logs
+
+```bash
+# Check connection logs
+openclaw logs
+```
+
+---
+
+## 4. Uninstall
+
+### 4.1 Disable Channel
+
+```bash
+# Disable the channel
+openclaw config set channels.chatu.enabled false
+
+# Or remove entirely
+openclaw config unset channels.chatu
+```
+
+### 4.2 Remove Plugin
+
+```bash
+# Remove from OpenClaw
+openclaw plugins uninstall @rowger_go/chatu
+```
+
+---
+
+## 5. Troubleshooting
+
+### 5.1 Common Issues
+
+| Issue | Solution |
+|-------|----------|
+| Connection timeout | Check `apiUrl` is correct and accessible |
+| 401 Unauthorized | Verify `accessToken` is valid |
+| Plugin not loading | Run `openclaw plugins list \| grep chatu`; ensure `dist/` exists after build |
+| Messages not arriving | Check WebSocket connection in logs; verify `channelId` is correct |
+| Messages not sending | Confirm `accessToken` and `channelId` are configured |
+
+### 5.2 Debug Commands
+
+```bash
+# View gateway logs
+openclaw logs
+
+# Check plugin status
+openclaw plugins list | grep chatu
+
+# View current config
+openclaw config get channels.chatu
+
+# Test backend health
+curl https://your-website.com/health
+```
+
+### 5.3 Get Help
+
+```bash
+# Check OpenClaw documentation
+openclaw help
+```
+
+---
+
+## 6. Update
+
+### 6.1 Update Plugin
+
+```bash
+# Update to latest version
+openclaw plugins update @rowger_go/chatu
+```
+
+### 6.2 Check Version
+
+```bash
+# View installed version
+openclaw plugins list | grep chatu
+```
+
+---
+
+## Related Documentation
+
+- [Channel Documentation](docs/channel/README.md) - Architecture, API reference, message protocol
+- [OpenClaw Configuration](https://docs.openclaw.ai/gateway/configuration) - Official docs
+
+---
+
+*Last updated: 2026-02-25*
+
+---
+
+## Plugin Version Detection
+
+After installing or upgrading the plugin, you can verify the active version without restarting openclaw by querying the service version endpoint:
+
+```bash
+# Check active plugin version
+curl http://localhost:3000/api/channel/version
+```
+
+Expected response:
+
+```json
+{
+  "success": true,
+  "data": {
+    "serviceVersion": "1.0.0",
+    "nodeVersion": "20.11.0",
+    "pluginVersion": "0.1.0",
+    "buildTime": null
+  }
+}
+```
+
+`pluginVersion` reflects the version reported by the plugin when it last connected. If it shows `null`, the plugin has not yet connected after the most recent service restart.
+
+---
+
+## Reloading the Plugin After an Upgrade
+
+Use the included reload script to rebuild and get guided reload instructions:
+
+```bash
+./scripts/reload-plugin.sh
+```
+
+The script will:
+1. Run `npm run build` to compile the plugin
+2. Print the new version
+3. Check the service version endpoint
+4. Show step-by-step instructions for clearing the cached `accessToken` and restarting the openclaw account so the new build takes effect
+
+To reload without rebuilding:
+
+```bash
+./scripts/reload-plugin.sh --no-build
+```

package/INSTALL.zh.md

@@ -0,0 +1,285 @@
+# Chatu 频道安装指南
+
+**[English](INSTALL.md) | 中文**
+
+> 本指南介绍如何安装 Chatu 频道插件，将 OpenClaw 连接到任意网站。
+
+---
+
+## 1. 安装方式
+
+### 1.1 从 npm 安装（推荐）
+
+```bash
+# 作为 OpenClaw 插件安装
+openclaw plugins install @rowger_go/chatu
+
+# 或直接使用 npm 全局安装
+npm install -g @rowger_go/chatu
+```
+
+### 1.2 从源码安装
+
+**方式 A：自动构建安装（推荐）**
+
+```bash
+# 克隆仓库
+git clone https://github.com/chatu-ai/webhub.git
+cd webhub
+
+# 安装为插件（会通过 prepare 脚本自动构建）
+openclaw plugins install .
+```
+
+**方式 B：手动构建安装**
+
+```bash
+# 克隆仓库
+git clone https://github.com/chatu-ai/webhub.git
+cd webhub
+
+# 构建插件
+npm install
+npm run build
+
+# 本地安装
+openclaw plugins install .
+```
+
+### 1.3 开发模式
+
+```bash
+# 以热重载方式链接（开发用）
+openclaw plugins install -l .
+cd /path/to/webhub
+npm run watch
+```
+
+---
+
+## 2. 配置
+
+### 2.1 快速配置
+
+```bash
+# 启用频道
+openclaw config set channels.chatu.enabled true
+
+# 设置 Chatu 服务 API URL（由 WebHub 后端提供）
+openclaw config set channels.chatu.apiUrl "https://your-website.com"
+
+# 设置频道 ID（从 WebHub 管理界面获取）
+openclaw config set channels.chatu.channelId "wh_ch_xxxxxx"
+
+# 设置访问凭证（由 WebHub 后端提供）
+openclaw config set channels.chatu.accessToken "wh_eyJhbGciOiJIUzI1NiIs..."
+
+# 应用更改
+openclaw gateway restart
+```
+
+### 2.2 完整配置
+
+```json5
+{
+  channels: {
+    chatu: {
+      enabled: true,
+      
+      // WebHub 服务基础 URL [必填]
+      apiUrl: "https://your-website.com",
+      
+      // 频道 ID，从 WebHub 管理界面获取 [必填]
+      channelId: "wh_ch_xxxxxx",
+      
+      // 访问凭证 [必填，与 secret 二选一]
+      accessToken: "wh_eyJhbGciOiJIUzI1NiIs...",
+      
+      // 频道密钥，用于注册 [与 accessToken 二选一]
+      // secret: "wh_secret_xxxxxxxxxx",
+      
+      // 请求超时时间（毫秒）[可选]
+      timeout: 30000,
+    }
+  }
+}
+```
+
+### 2.3 环境变量（快速注册）
+
+如果 WebHub 后端支持自动注册，可以跳过手动凭证配置：
+
+```bash
+# 设置注册密钥和服务 URL
+export CHATU_KEY="your-registration-key"
+export CHATU_URL="https://your-website.com"
+
+# 重启网关触发自动注册
+openclaw gateway restart
+```
+
+插件会自动调用 `POST /api/channel/quick-register`，并将返回的 `channelId` 和 `accessToken` 保存到配置中。
+
+---
+
+## 3. 验证安装
+
+### 3.1 检查插件状态
+
+```bash
+# 验证插件已加载
+openclaw plugins list | grep chatu
+
+# 预期输出：
+# │ Chatu │ chatu │ loaded │ .../dist/index.js │ 0.1.0 │
+```
+
+### 3.2 检查配置
+
+```bash
+# 查看当前 chatu 配置
+openclaw config get channels.chatu
+```
+
+### 3.3 查看日志
+
+```bash
+# 检查连接日志
+openclaw logs
+```
+
+---
+
+## 4. 卸载
+
+### 4.1 禁用频道
+
+```bash
+# 禁用频道
+openclaw config set channels.chatu.enabled false
+
+# 或完全移除配置
+openclaw config unset channels.chatu
+```
+
+### 4.2 移除插件
+
+```bash
+# 从 OpenClaw 中移除
+openclaw plugins uninstall @rowger_go/chatu
+```
+
+---
+
+## 5. 故障排除
+
+### 5.1 常见问题
+
+| 问题 | 解决方案 |
+|------|----------|
+| 连接超时 | 检查 `apiUrl` 是否正确且可访问 |
+| 401 未授权 | 验证 `accessToken` 是否有效 |
+| 插件未加载 | 运行 `openclaw plugins list \| grep chatu`；确认构建后 `dist/` 目录存在 |
+| 消息未到达 | 检查日志中的 WebSocket 连接状态；验证 `channelId` 是否正确 |
+| 消息发送失败 | 确认 `accessToken` 和 `channelId` 已配置 |
+
+### 5.2 调试命令
+
+```bash
+# 查看网关日志
+openclaw logs
+
+# 检查插件状态
+openclaw plugins list | grep chatu
+
+# 查看当前配置
+openclaw config get channels.chatu
+
+# 测试后端健康状态
+curl https://your-website.com/health
+```
+
+### 5.3 获取帮助
+
+```bash
+# 查看 OpenClaw 文档
+openclaw help
+```
+
+---
+
+## 6. 更新
+
+### 6.1 更新插件
+
+```bash
+# 更新到最新版本
+openclaw plugins update @rowger_go/chatu
+```
+
+### 6.2 检查版本
+
+```bash
+# 查看已安装版本
+openclaw plugins list | grep chatu
+```
+
+---
+
+## 相关文档
+
+- [频道文档](docs/channel/README.md) - 架构、API 参考、消息协议
+- [OpenClaw 配置文档](https://docs.openclaw.ai/gateway/configuration) - 官方文档
+
+---
+
+*最后更新：2026-02-25*
+
+---
+
+## 插件版本检测
+
+安装或升级插件后，可通过查询服务版本端点来验证当前运行的版本，无需重启 openclaw：
+
+```bash
+# 检查活跃插件版本
+curl http://localhost:3000/api/channel/version
+```
+
+预期响应：
+
+```json
+{
+  "success": true,
+  "data": {
+    "serviceVersion": "1.0.0",
+    "nodeVersion": "20.11.0",
+    "pluginVersion": "0.1.0",
+    "buildTime": null
+  }
+}
+```
+
+`pluginVersion` 反映插件最近一次连接时上报的版本号。如果显示 `null`，表示插件在最近一次服务重启后尚未连接。
+
+---
+
+## 升级后重载插件
+
+使用内置的重载脚本来重新构建并获取重载引导说明：
+
+```bash
+./scripts/reload-plugin.sh
+```
+
+该脚本会：
+1. 运行 `npm run build` 编译插件
+2. 打印新版本号
+3. 检查服务版本端点
+4. 展示清除缓存 `accessToken` 并重启 openclaw 账户以使新构建生效的分步操作说明
+
+如需跳过构建直接重载：
+
+```bash
+./scripts/reload-plugin.sh --no-build
+```

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 chatu-ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.