refactor: split plugin runtime and installer packages

Author: Yuuki-Sakura

.github/workflows/publish.yml

@@ -5,6 +5,10 @@ on:
     types: [created]
   workflow_dispatch:
 
+concurrency:
+  group: publish-npm
+  cancel-in-progress: false
+
 jobs:
   publish:
     runs-on: ubuntu-latest
@@ -19,16 +23,65 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '24'
-          registry-url: 'https://registry.npmjs.org'
+          node-version: "24"
+          registry-url: "https://registry.npmjs.org"
 
       - name: Install dependencies
         run: npm ci
 
-      - name: Build
+      - name: Verify version alignment
+        run: npm run verify:versions
+
+      - name: Run tests
+        run: npm test
+
+      - name: Build packages
         run: npm run build
 
-      - name: Publish to npm
-        run: npm publish --provenance --access public
+      - name: Verify publish tarballs
+        run: npm run pack:check
+
+      - name: Resolve package versions
+        id: versions
+        run: |
+          echo "runtime_version=$(node --input-type=module -e \"import fs from 'node:fs'; const pkg = JSON.parse(fs.readFileSync('./packages/runtime/package.json', 'utf8')); console.log(pkg.version);\")" >> "$GITHUB_OUTPUT"
+          echo "installer_version=$(node --input-type=module -e \"import fs from 'node:fs'; const pkg = JSON.parse(fs.readFileSync('./packages/installer/package.json', 'utf8')); console.log(pkg.version);\")" >> "$GITHUB_OUTPUT"
+
+      - name: Check runtime package publish state
+        id: runtime_publish_state
+        run: |
+          if npm view "@aitoearn/openclaw-plugin@${{ steps.versions.outputs.runtime_version }}" version >/dev/null 2>&1; then
+            echo "should_publish=false" >> "$GITHUB_OUTPUT"
+          else
+            echo "should_publish=true" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Check installer package publish state
+        id: installer_publish_state
+        run: |
+          if npm view "@aitoearn/aitoearn-openclaw-cli@${{ steps.versions.outputs.installer_version }}" version >/dev/null 2>&1; then
+            echo "should_publish=false" >> "$GITHUB_OUTPUT"
+          else
+            echo "should_publish=true" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Publish runtime package
+        if: steps.runtime_publish_state.outputs.should_publish == 'true'
+        run: npm publish --workspace @aitoearn/openclaw-plugin --provenance --access public
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Publish installer package
+        if: steps.installer_publish_state.outputs.should_publish == 'true'
+        run: npm publish --workspace @aitoearn/aitoearn-openclaw-cli --provenance --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Report skipped packages
+        run: |
+          if [ "${{ steps.runtime_publish_state.outputs.should_publish }}" != "true" ]; then
+            echo "Runtime package @aitoearn/openclaw-plugin@${{ steps.versions.outputs.runtime_version }} is already published; skipping."
+          fi
+          if [ "${{ steps.installer_publish_state.outputs.should_publish }}" != "true" ]; then
+            echo "Installer package @aitoearn/aitoearn-openclaw-cli@${{ steps.versions.outputs.installer_version }} is already published; skipping."
+          fi

.gitignore

@@ -1,5 +1,8 @@
 node_modules/
 dist/
+packages/*/dist/
+*.tgz
 *.openapi.yaml
+docs/
 .claude/
-.idea
+.idea/

README.md

@@ -1,77 +1,14 @@
-# AiToEarn OpenClaw Plugin
+# AiToEarn OpenClaw Monorepo
 
-AiToEarn 社交媒体管理工具的 OpenClaw 插件。
+这个仓库现在拆成三个部分：
 
-## 一键安装
+- `packages/runtime`：真正发布给 OpenClaw 的运行时插件包 `@aitoearn/openclaw-plugin`
+- `packages/installer`：负责 `npx` 安装与配置引导的 CLI 包 `@aitoearn/aitoearn-openclaw-cli`
+- `packages/shared`：内部共享的 setup / config / MCP 客户端逻辑，不单独发布
 
-```bash
-npx -y @aitoearn/openclaw-plugin
-```
-
-这个命令会自动：
-
-1. 将当前插件包安装到 OpenClaw 的扩展目录
-2. 自动检测是否为已有安装
-3. 首次安装时引导输入 API Key 和环境
-4. 验证连通性
-5. 写入 `plugins.entries.aitoearn.config`
-
-## 手动配置
-
-```bash
-openclaw config set plugins.entries.aitoearn.enabled true --strict-json
-openclaw config set plugins.entries.aitoearn.config.apiKey "your-api-key"
-openclaw config set plugins.entries.aitoearn.config.baseUrl "https://aitoearn.ai/api"
-```
-
-如果你想使用 SecretRef，也可以改成 OpenClaw 标准写法，例如：
-
-```bash
-openclaw config set plugins.entries.aitoearn.config.apiKey \
-  --ref-provider default \
-  --ref-source env \
-  --ref-id AITOEARN_API_KEY
-```
-
-## 获取 API Key
-
-1. 打开 [aitoearn.ai](https://aitoearn.ai/)（国际）或 [aitoearn.cn](https://aitoearn.cn/)（中国）
-2. 注册并登录
-3. 点击左侧菜单 **设置**
-4. 在 **API Key** 中点击创建，复制生成的 Key
-
-如果你的 npm 版本会在首次执行时提示确认安装包，统一使用：
+常用命令：
 
 ```bash
-npx -y @aitoearn/openclaw-plugin
+npm test
+npm run build
 ```
-
-升级插件：
-
-```bash
-npx -y @aitoearn/openclaw-plugin upgrade
-```
-
-再次执行默认命令时，如果检测到已有 `aitoearn` 配置，会自动按升级处理并跳过 setup。
-
-完成配置后，重启 Gateway：
-
-```bash
-openclaw gateway restart
-```
-
-插件会根据 `baseUrl` 自动判定环境并注入本地环境工具：
-
-- `*.aitoearn.cn` => `China`
-- `*.aitoearn.ai` => `Global`
-- 其他域名 => `self-hosted`
-
-启动后会注册 `getAiToEarnEnvironment`，并且只注册当前环境允许的 `publishPostTo*`。
-
-## MCP Tools 同步
-
-插件会在 Gateway 启动时自动从 AiToEarn MCP 拉取最新 tools，并缓存到 OpenClaw state dir。
-
-- AiToEarn 新增或调整 tools 后，不需要升级这个插件包
-- 只需要重启 Gateway，让插件在启动时重新同步
-- 如果启动时远端暂时不可用，插件会优先回退到上一次成功同步的本地快照

package-lock.json

@@ -1,52 +1,18 @@
 {
-  "name": "@aitoearn/openclaw-plugin",
+  "name": "aitoearn-openclaw-workspace",
+  "private": true,
   "version": "1.0.8",
   "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "bin": {
-    "openclaw-plugin": "dist/src/cli.js"
-  },
-  "files": [
-    "dist",
-    "skills",
-    "openclaw.plugin.json",
-    "README.md",
-    "package.json"
+  "workspaces": [
+    "packages/shared",
+    "packages/runtime",
+    "packages/installer"
   ],
-  "openclaw": {
-    "extensions": [
-      "./dist/index.js"
-    ],
-    "install": {
-      "npmSpec": "@aitoearn/openclaw-plugin",
-      "defaultChoice": "npm"
-    },
-    "compat": {
-      "pluginApi": ">=2026.3.24"
-    },
-    "build": {
-      "openclawVersion": ">=2026.3.24"
-    }
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/yikart/aitoearn-openclaw-plugin.git"
-  },
   "scripts": {
-    "prebuild": "node --input-type=module -e \"import { rmSync } from 'node:fs'; rmSync('dist', { recursive: true, force: true });\"",
-    "build": "tsc -p tsconfig.build.json",
-    "dev": "tsc -p tsconfig.build.json --watch",
-    "prepack": "npm run build",
-    "test": "vitest"
-  },
-  "dependencies": {
-    "@clack/prompts": "^1.1.0",
-    "@modelcontextprotocol/sdk": "^1.12.0",
-    "@sinclair/typebox": "^0.34.0",
-    "json5": "^2.2.3",
-    "openclaw": ">=2026.3.24",
-    "zod": "^3.24.0"
+    "verify:versions": "node ./scripts/check-workspace-versions.mjs",
+    "build": "npm run verify:versions && npm run build --workspaces --if-present",
+    "test": "npm run verify:versions && npm run test --workspaces --if-present",
+    "pack:check": "npm run verify:versions && npm pack --dry-run --workspace @aitoearn/openclaw-plugin && npm pack --dry-run --workspace @aitoearn/aitoearn-openclaw-cli"
   },
   "devDependencies": {
     "typescript": "^5.4.0",

package.json

@@ -0,0 +1,15 @@
+# AiToEarn OpenClaw Installer
+
+用这个包提供 `npx` 安装体验：
+
+```bash
+npx -y @aitoearn/aitoearn-openclaw-cli
+```
+
+升级已通过 npm 安装的 AiToEarn OpenClaw 插件：
+
+```bash
+npx -y @aitoearn/aitoearn-openclaw-cli upgrade
+```
+
+运行时插件包是 `@aitoearn/openclaw-plugin`，安装与更新由宿主 `openclaw plugins install/update` 完成。

packages/installer/README.md

@@ -0,0 +1,32 @@
+{
+  "name": "@aitoearn/aitoearn-openclaw-cli",
+  "version": "1.0.8",
+  "type": "module",
+  "main": "./dist/installer/src/cli.js",
+  "types": "./dist/installer/src/cli.d.ts",
+  "bin": {
+    "aitoearn-openclaw": "dist/installer/src/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "package.json"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yikart/aitoearn-openclaw-plugin.git"
+  },
+  "scripts": {
+    "prebuild": "node --input-type=module -e \"import { rmSync } from 'node:fs'; rmSync('dist', { recursive: true, force: true });\"",
+    "build": "tsc -p tsconfig.json",
+    "prepack": "npm run build",
+    "test": "vitest run --config ../../vitest.config.ts"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.1.0",
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "json5": "^2.2.3",
+    "openclaw": ">=2026.3.24",
+    "zod": "^3.24.0"
+  }
+}