initial: openclaw-worktool plugin with one-line docker setup

Author: catcat873

.gitignore

@@ -7,17 +7,29 @@ build/
 coverage/
 *.tsbuildinfo
 
-# local env
+# local env / secrets
 .env
 .env.*
 !.env.example
-.runtime_test/
+*.key
+*.pem
+
+# openclaw runtime config (contains robotId, API keys, tokens)
+openclaw.json
+openclaw.json.bak
+runtime/
+.openclaw/
 
 # logs
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
 pnpm-debug.log*
+*.log
+
+# test artifacts
+.runtime_test/
 
-# macOS
+# OS
 .DS_Store
+Thumbs.db

DEPLOYMENT.md

@@ -1,28 +1,28 @@
 # Deployment Guide
 
-本文档描述 `openclaw-plugin-worktool` 在 webhook 模式下的部署与联调。
+本文档描述 `openclaw-worktool` 在 webhook 模式下的部署与联调。
 
 ## 1. 插件安装
 
 推荐一键安装：
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/answerlink/openclaw-plugin-worktool/main/scripts/install-docker.sh | bash
+curl -fsSL https://raw.githubusercontent.com/answerlink/openclaw-worktool/main/scripts/install-docker.sh | bash
 ```
 
 脚本会优先读取 `.env`，缺失项自动交互询问并回写 `.env`。
 
 CLI 一键安装（需要本机有 `openclaw` 命令）：
 
 ```bash
-ROBOT_ID=wctestid curl -fsSL https://raw.githubusercontent.com/answerlink/openclaw-plugin-worktool/main/scripts/install.sh | bash
+ROBOT_ID=wctestid curl -fsSL https://raw.githubusercontent.com/answerlink/openclaw-worktool/main/scripts/install.sh | bash
 ```
 
 本地源码一键安装（clone 后，Docker 推荐）：
 
 ```bash
-git clone https://github.com/answerlink/openclaw-plugin-worktool.git
-cd openclaw-plugin-worktool
+git clone https://github.com/answerlink/openclaw-worktool.git
+cd openclaw-worktool
 ROBOT_ID=wctestid bash scripts/install-local.sh
 ```
 
@@ -37,13 +37,13 @@ ROBOT_ID=wctestid bash scripts/install-local-native.sh
 如需安装指定版本：
 
 ```bash
-ROBOT_ID=wctestid VERSION=0.2.1 curl -fsSL https://raw.githubusercontent.com/answerlink/openclaw-plugin-worktool/main/scripts/install.sh | bash
+ROBOT_ID=wctestid VERSION=0.2.1 curl -fsSL https://raw.githubusercontent.com/answerlink/openclaw-worktool/main/scripts/install.sh | bash
 ```
 
 开发联调可用本地目录安装：
 
 ```bash
-openclaw plugins install /absolute/path/openclaw-plugin-worktool
+openclaw plugins install /absolute/path/openclaw-worktool
 ```
 
 ## 2. OpenClaw 配置

README.md

@@ -1,16 +1,66 @@
-# openclaw-plugin-worktool
+# openclaw-worktool
 
 OpenClaw 的 WorkTool 渠道插件，支持：
 
 - 出站：将 OpenClaw 回复发送到微信（经 WorkTool bridge）。
 - 入站：接收 WorkTool webhook 回调并路由到小龙虾 Agent。
 
-## 安装
+## 快速开始（推荐）
 
-方式 1：一键安装（Docker 用户推荐，无需 openclaw CLI）
+只需 Docker 和一个 WorkTool 机器人 ID，从零到跑通：
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/answerlink/openclaw-plugin-worktool/main/scripts/install-docker.sh | bash
+git clone https://github.com/answerlink/openclaw-worktool.git
+cd openclaw-worktool
+bash scripts/setup-docker.sh
+```
+
+脚本会自动完成全部流程：
+
+1. 交互式询问 WorkTool Robot ID（也可从 `.env` 读取）。
+2. 拉取 OpenClaw Docker 镜像（如本地没有）。
+3. 创建 Docker 容器（端口映射、volume 挂载全自动）。
+4. 启动 **OpenClaw onboard**（选模型、配网关 token——OpenClaw 官方交互界面）。
+5. 复制插件源码进容器、创建 SDK 兼容层、修补版本兼容性。
+6. 写入 `openclaw.json` 的 plugins + channels.worktool 配置。
+7. 重启容器、验证 webhook 健康检查。
+8. 所有值回写 `.env`，下次升级/重装零交互。
+
+第二次运行（升级/改配置）：
+
+```bash
+bash scripts/setup-docker.sh
+# .env 中已有 ROBOT_ID 等值，直接跑完；onboard 会问你是否要重新配模型
+```
+
+也可环境变量全传，跳过交互（适合 CI）：
+
+```bash
+ROBOT_ID=wctestid SKIP_ONBOARD=1 bash scripts/setup-docker.sh
+```
+
+可覆盖参数：
+
+| 变量 | 默认值 | 说明 |
+|---|---|---|
+| `ROBOT_ID` | (必填) | WorkTool 机器人 ID |
+| `OPENCLAW_IMAGE` | `alpine/openclaw:2026.3.28` | OpenClaw Docker 镜像 |
+| `CONTAINER_NAME` | `openclaw-gateway` | 容器名 |
+| `GATEWAY_PORT` | `18789` | OpenClaw 网关端口 |
+| `BRIDGE_BASE_URL` | `https://api.worktool.ymdyes.cn` | WorkTool Bridge 地址 |
+| `WEBHOOK_HOST` | `0.0.0.0` | Webhook 监听地址 |
+| `WEBHOOK_PORT` | `18799` | Webhook 端口 |
+| `WEBHOOK_PATH` | `/wechat/webhook` | Webhook 路径 |
+| `SKIP_ONBOARD` | (空) | 设为 `1` 跳过 onboard |
+| `ENV_FILE` | `./.env` | 配置文件路径 |
+| `PLUGIN_SOURCE_DIR` | 自动检测 | 插件源码目录 |
+
+## 其他安装方式
+
+### 方式 1：一键安装（Docker 用户，无需 openclaw CLI）
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/answerlink/openclaw-worktool/main/scripts/install-docker.sh | bash
 ```
 
 说明：
@@ -22,7 +72,7 @@ curl -fsSL https://raw.githubusercontent.com/answerlink/openclaw-plugin-worktool
 安装指定版本：
 
 ```bash
-VERSION=0.2.1 curl -fsSL https://raw.githubusercontent.com/answerlink/openclaw-plugin-worktool/main/scripts/install-docker.sh | bash
+VERSION=0.2.1 curl -fsSL https://raw.githubusercontent.com/answerlink/openclaw-worktool/main/scripts/install-docker.sh | bash
 ```
 
 如果你的 `docker-compose.worktool.yml` 或配置目录不在当前目录，可传参：
@@ -31,34 +81,34 @@ VERSION=0.2.1 curl -fsSL https://raw.githubusercontent.com/answerlink/openclaw-p
 ROBOT_ID=wctestid \
 COMPOSE_FILE=/path/to/docker-compose.worktool.yml \
 OPENCLAW_CONFIG=/path/to/runtime/config/openclaw.json \
-PLUGIN_HOST_DIR=/path/to/openclaw-plugin-worktool \
-curl -fsSL https://raw.githubusercontent.com/answerlink/openclaw-plugin-worktool/main/scripts/install-docker.sh | bash
+PLUGIN_HOST_DIR=/path/to/openclaw-worktool \
+curl -fsSL https://raw.githubusercontent.com/answerlink/openclaw-worktool/main/scripts/install-docker.sh | bash
 ```
 
-方式 2：一键安装（CLI 模式，需要本机有 `openclaw` 命令）
+### 方式 2：一键安装（CLI 模式，需要本机有 `openclaw` 命令）
 
 ```bash
-ROBOT_ID=wctestid curl -fsSL https://raw.githubusercontent.com/answerlink/openclaw-plugin-worktool/main/scripts/install.sh | bash
+ROBOT_ID=wctestid curl -fsSL https://raw.githubusercontent.com/answerlink/openclaw-worktool/main/scripts/install.sh | bash
 ```
 
 安装指定版本：
 
 ```bash
-ROBOT_ID=wctestid VERSION=0.2.1 curl -fsSL https://raw.githubusercontent.com/answerlink/openclaw-plugin-worktool/main/scripts/install.sh | bash
+ROBOT_ID=wctestid VERSION=0.2.1 curl -fsSL https://raw.githubusercontent.com/answerlink/openclaw-worktool/main/scripts/install.sh | bash
 ```
 
 可选覆盖 WorkTool 地址（私有化部署）：
 
 ```bash
 ROBOT_ID=wctestid BRIDGE_BASE_URL=https://your-private-worktool.example.com \
-curl -fsSL https://raw.githubusercontent.com/answerlink/openclaw-plugin-worktool/main/scripts/install.sh | bash
+curl -fsSL https://raw.githubusercontent.com/answerlink/openclaw-worktool/main/scripts/install.sh | bash
 ```
 
-方式 3：源码一键安装（clone 后本地自测）
+### 方式 3：源码一键安装（clone 后本地自测）
 
 ```bash
-git clone https://github.com/answerlink/openclaw-plugin-worktool.git
-cd openclaw-plugin-worktool
+git clone https://github.com/answerlink/openclaw-worktool.git
+cd openclaw-worktool
 ROBOT_ID=wctestid bash scripts/install-local.sh
 ```
 
@@ -90,16 +140,16 @@ ROBOT_ID=wctestid bash scripts/install-local-native.sh
 - 回调地址通常是：`https://your-public-domain.example.com/wechat/webhook`
 - 需要模型配置可用（OpenClaw provider 可调用），否则只能收消息不能出 AI 回复。
 
-方式 4：源码目录安装（开发联调）
+### 方式 4：源码目录安装（开发联调）
 
 ```bash
-openclaw plugins install /absolute/path/openclaw-plugin-worktool
+openclaw plugins install /absolute/path/openclaw-worktool
 ```
 
-方式 5：发布包安装（给私有部署环境）
+### 方式 5：发布包安装（给私有部署环境）
 
 ```bash
-cd /absolute/path/openclaw-plugin-worktool
+cd /absolute/path/openclaw-worktool
 npm run release:local
 openclaw plugins install ./dist/package
 ```

docs/ARCHITECTURE-LARK-REFERENCE.md

@@ -1,6 +1,6 @@
 # WorkTool 插件架构说明（参考 openclaw-lark）
 
-本文档记录 `openclaw-plugin-worktool` 的目录边界，并对齐 `~/projects/openclaw-lark` 的分层思路，供后续持续演进。
+本文档记录 `openclaw-worktool` 的目录边界，并对齐 `~/projects/openclaw-lark` 的分层思路，供后续持续演进。
 
 ## 1. 参考飞书插件的分层边界
 

docs/RELEASE-AND-INSTALL.md

@@ -1,38 +1,38 @@
 # WorkTool 插件发布与安装
 
-本文档用于把 `openclaw-plugin-worktool` 做成可分发安装包（参考 `openclaw-lark` 的发布方式）。
+本文档用于把 `openclaw-worktool` 做成可分发安装包（参考 `openclaw-lark` 的发布方式）。
 
 ## 0. 用户一键安装
 
 latest：
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/answerlink/openclaw-plugin-worktool/main/scripts/install-docker.sh | bash
+curl -fsSL https://raw.githubusercontent.com/answerlink/openclaw-worktool/main/scripts/install-docker.sh | bash
 ```
 
 CLI 模式（需要本机有 `openclaw` 命令）：
 
 ```bash
-ROBOT_ID=wctestid curl -fsSL https://raw.githubusercontent.com/answerlink/openclaw-plugin-worktool/main/scripts/install.sh | bash
+ROBOT_ID=wctestid curl -fsSL https://raw.githubusercontent.com/answerlink/openclaw-worktool/main/scripts/install.sh | bash
 ```
 
 指定版本：
 
 ```bash
-VERSION=0.2.1 curl -fsSL https://raw.githubusercontent.com/answerlink/openclaw-plugin-worktool/main/scripts/install-docker.sh | bash
+VERSION=0.2.1 curl -fsSL https://raw.githubusercontent.com/answerlink/openclaw-worktool/main/scripts/install-docker.sh | bash
 ```
 
 CLI 模式指定版本：
 
 ```bash
-ROBOT_ID=wctestid VERSION=0.2.1 curl -fsSL https://raw.githubusercontent.com/answerlink/openclaw-plugin-worktool/main/scripts/install.sh | bash
+ROBOT_ID=wctestid VERSION=0.2.1 curl -fsSL https://raw.githubusercontent.com/answerlink/openclaw-worktool/main/scripts/install.sh | bash
 ```
 
 clone 后本地一键安装（Docker 推荐）：
 
 ```bash
-git clone https://github.com/answerlink/openclaw-plugin-worktool.git
-cd openclaw-plugin-worktool
+git clone https://github.com/answerlink/openclaw-worktool.git
+cd openclaw-worktool
 ROBOT_ID=wctestid bash scripts/install-local.sh
 ```
 
@@ -73,7 +73,7 @@ MODEL_API_PROTOCOL=openai-completions
 ## 2. 构建发布目录
 
 ```bash
-cd /absolute/path/openclaw-plugin-worktool
+cd /absolute/path/openclaw-worktool
 npm run build
 ```
 
@@ -89,14 +89,14 @@ npm run build
 ## 3. 生成 tgz 发布包
 
 ```bash
-cd /absolute/path/openclaw-plugin-worktool
+cd /absolute/path/openclaw-worktool
 npm run release:local
 ```
 
 产物：
 
 - `dist/package/`（目录安装）
-- `dist/openclaw-plugin-worktool-<version>.tgz`（单文件分发）
+- `dist/openclaw-worktool-<version>.tgz`（单文件分发）
 
 如需自动升级版本后发布：
 
@@ -130,13 +130,13 @@ git push origin v0.2.1
 目录安装：
 
 ```bash
-openclaw plugins install /absolute/path/openclaw-plugin-worktool/dist/package
+openclaw plugins install /absolute/path/openclaw-worktool/dist/package
 ```
 
 tgz 安装：
 
 ```bash
-openclaw plugins install /absolute/path/openclaw-plugin-worktool/dist/openclaw-plugin-worktool-<version>.tgz
+openclaw plugins install /absolute/path/openclaw-worktool/dist/openclaw-worktool-<version>.tgz
 ```
 
 ## 5. 最小验收

docs/WORKTOOL-ARCHITECTURE-TEXT.md

@@ -17,7 +17,7 @@ Nginx
   v
 宿主机 OpenClaw 进程
   |
-  +-- openclaw-plugin-worktool
+  +-- openclaw-worktool
       |
       +-- index.ts/js
       |    - 注册 channel(worktool)

package.json

@@ -1,5 +1,5 @@
 {
-  "name": "openclaw-plugin-worktool",
+  "name": "openclaw-worktool",
   "version": "0.2.0",
   "description": "OpenClaw WorkTool channel plugin for WeChat webhook/RPA bridge integration.",
   "type": "module",
@@ -36,7 +36,7 @@
       "order": 96
     },
     "install": {
-      "npmSpec": "openclaw-plugin-worktool",
+      "npmSpec": "openclaw-worktool",
       "localPath": "extensions/worktool",
       "defaultChoice": "local"
     }

scripts/install-docker.sh

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
-REPO="${REPO:-answerlink/openclaw-plugin-worktool}"
+REPO="${REPO:-answerlink/openclaw-worktool}"
 VERSION="${VERSION:-latest}" # e.g. 0.2.1 or latest
 
 # Core WorkTool channel settings
@@ -23,7 +23,7 @@ ENV_FILE="${ENV_FILE:-./.env}"
 COMPOSE_FILE="${COMPOSE_FILE:-./docker-compose.worktool.yml}"
 SERVICE_NAME="${SERVICE_NAME:-openclaw-worktool}"
 OPENCLAW_CONFIG="${OPENCLAW_CONFIG:-./runtime/config/openclaw.json}"
-PLUGIN_HOST_DIR="${PLUGIN_HOST_DIR:-./openclaw-plugin-worktool}"
+PLUGIN_HOST_DIR="${PLUGIN_HOST_DIR:-./openclaw-worktool}"
 CONTAINER_PLUGIN_PATH="${CONTAINER_PLUGIN_PATH:-/app/extensions/worktool}"
 AUTO_RESTART="${AUTO_RESTART:-1}"
 
@@ -218,7 +218,7 @@ upsert_env WEBHOOK_PORT "$WEBHOOK_PORT"
 upsert_env WEBHOOK_PATH "$WEBHOOK_PATH"
 
 VER="$(resolve_version)"
-URL="https://github.com/${REPO}/releases/download/v${VER}/openclaw-plugin-worktool-${VER}.tgz"
+URL="https://github.com/${REPO}/releases/download/v${VER}/openclaw-worktool-${VER}.tgz"
 
 echo "Downloading plugin package ${VER} from ${REPO}..."
 curl -fsSL "$URL" -o "$ARCHIVE_PATH"

scripts/install.sh

@@ -7,7 +7,7 @@ if ! command -v openclaw >/dev/null 2>&1; then
   exit 1
 fi
 
-REPO="${REPO:-answerlink/openclaw-plugin-worktool}"
+REPO="${REPO:-answerlink/openclaw-worktool}"
 VERSION="${VERSION:-latest}" # e.g. 0.2.1 or latest
 ROBOT_ID="${ROBOT_ID:-}"
 BRIDGE_BASE_URL="${BRIDGE_BASE_URL:-https://api.worktool.ymdyes.cn}"
@@ -49,7 +49,7 @@ if [ -z "$ROBOT_ID" ]; then
 fi
 
 VER="$(resolve_version)"
-URL="https://github.com/${REPO}/releases/download/v${VER}/openclaw-plugin-worktool-${VER}.tgz"
+URL="https://github.com/${REPO}/releases/download/v${VER}/openclaw-worktool-${VER}.tgz"
 
 echo "Downloading plugin package ${VER} from ${REPO}..."
 curl -fsSL "$URL" -o "$ARCHIVE_PATH"