stableclaw 2026.4.5 → 2026.4.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +49 -12
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -19,21 +19,57 @@ StableClaw 在 OpenClaw 的基础上,增加了多项企业级增强功能,
19
19
 
20
20
  ---
21
21
 
22
- ## 🚀 快速安装
22
+ ## 🚀 一键安装
23
23
 
24
- > **推荐新手使用 npm 方式安装**,最简单快捷。需要自定义修改源码时再选择源码构建方式。
24
+ > 💡 **无需手动安装 Node.js、Git 等依赖**,脚本会自动检测并安装所有前置条件。仅复制一行命令即可完成安装。
25
25
 
26
- ### 系统要求
26
+ ### Windows(PowerShell)
27
+
28
+ ```powershell
29
+ powershell -c "irm https://raw.githubusercontent.com/ctz168/stableclaw/main/install/install.ps1 | iex"
30
+ ```
31
+
32
+ > 首次运行时如果 PowerShell 提示执行策略限制,先执行:`Set-ExecutionPolicy RemoteSigned -Scope CurrentUser`
33
+
34
+ ### macOS / Linux
35
+
36
+ ```bash
37
+ curl -fsSL https://raw.githubusercontent.com/ctz168/stableclaw/main/install/install.sh | bash
38
+ ```
39
+
40
+ ### 安装脚本高级选项
41
+
42
+ 两个平台脚本均支持以下参数:
43
+
44
+ | 参数 | 默认值 | 说明 |
45
+ |------|--------|------|
46
+ | `--tag=VERSION` / `-Tag VERSION` | `latest` | 指定 npm 版本标签(如 `2026.4.5`、`beta`) |
47
+ | `--install-method=npm` / `-InstallMethod npm` | `npm` | 安装方式:`npm` 或 `git` |
48
+ | `--no-onboard` / `-NoOnboard` | 否 | 跳过首次交互式配置向导 |
49
+ | `--dry-run` / `-DryRun` | 否 | 仅显示将要执行的操作,不实际安装 |
50
+
51
+ **示例:**
52
+
53
+ ```powershell
54
+ # Windows — 安装指定版本,跳过向导
55
+ powershell -c "& ([scriptblock]::Create((irm https://raw.githubusercontent.com/ctz168/stableclaw/main/install/install.ps1))) -Tag 2026.4.5 -NoOnboard"
56
+
57
+ # Linux/macOS — 从源码安装
58
+ curl -fsSL https://raw.githubusercontent.com/ctz168/stableclaw/main/install/install.sh | bash -s -- --install-method git
59
+ ```
60
+
61
+ ---
62
+
63
+ ## 📋 系统要求
27
64
 
28
65
  | 项目 | 最低要求 | 推荐配置 |
29
66
  |------|----------|----------|
30
- | **Node.js** | v22.12+ | v24(LTS) |
67
+ | **Node.js** | v22.12+(脚本会自动安装) | v24(LTS) |
31
68
  | **操作系统** | Windows 10 / macOS 12 / Ubuntu 20.04 | Windows 11 / macOS 14 / Ubuntu 24.04 |
32
69
  | **内存** | 512 MB | 2 GB+ |
33
70
  | **磁盘空间** | 200 MB(npm 安装) | 2 GB+(源码构建) |
34
- | **pnpm** | v9+(仅源码构建需要) | 最新版 |
35
71
 
36
- > 仅有 **Node.js** 一个前置依赖即可运行,npm 安装方式不需要 pnpm 和 Git。
72
+ > 一键安装脚本会自动检测并安装 Node.js,你不需要提前准备任何环境。
37
73
 
38
74
  ---
39
75
 
@@ -41,16 +77,17 @@ StableClaw 在 OpenClaw 的基础上,增加了多项企业级增强功能,
41
77
 
42
78
  | 方式 | 适用场景 | 难度 | 耗时 | 可自定义 |
43
79
  |------|----------|------|------|----------|
44
- | **npm 全局安装** ⭐ | 快速体验、生产部署 | ⭐ 简单 | ~1 分钟 | ❌ |
80
+ | **一键安装** ⭐ | 所有用户、快速上手 | ⭐ 最简单 | ~30 | ❌ |
81
+ | **npm 全局安装** | 已有 Node.js 环境 | ⭐ 简单 | ~1 分钟 | ❌ |
45
82
  | **源码构建** | 需要修改源码、二次开发 | ⭐⭐ 中等 | ~5-10 分钟 | ✅ |
46
83
  | **Docker 部署** | 服务器部署、容器化环境 | ⭐⭐ 中等 | ~2 分钟 | ✅ |
47
84
  | **GitHub 安装** | 想用最新开发版 | ⭐⭐ 中等 | ~3 分钟 | ✅ |
48
85
 
49
86
  ---
50
87
 
51
- ## ⭐ 方式一:npm 全局安装(推荐)
88
+ ## ⭐ 方式一:npm 全局安装
52
89
 
53
- 最简单的安装方式,适合大多数用户。安装后即可在任意位置使用 `stableclaw` 命令。
90
+ 如果你已有 Node.js v22+ 环境,可以直接通过 npm 安装。安装后即可在任意位置使用 `stableclaw` 命令。
54
91
 
55
92
  ### 🪟 Windows
56
93
 
@@ -74,7 +111,7 @@ stableclaw onboard
74
111
  stableclaw gateway run
75
112
  ```
76
113
 
77
- > **没有 Node.js?** 执行 `winget install OpenJS.NodeJS.LTS` 安装,或从 [https://nodejs.org](https://nodejs.org) 下载。安装后**关闭并重新打开 PowerShell**。
114
+ > **没有 Node.js?** 执行 `winget install OpenJS.NodeJS.LTS` 安装,或从 [https://nodejs.org](https://nodejs.org) 下载。安装后**关闭并重新打开 PowerShell**。也可以使用上方的**一键安装命令**,它会自动帮你装好 Node.js。
78
115
 
79
116
  ### 🍎 macOS
80
117
 
@@ -97,7 +134,7 @@ stableclaw onboard
97
134
  stableclaw gateway run
98
135
  ```
99
136
 
100
- > **没有 Node.js?** 使用 Homebrew 安装:`brew install node@24`,然后执行 `brew link node@24 --force`。
137
+ > **没有 Node.js?** 使用 Homebrew 安装:`brew install node@24`,然后执行 `brew link node@24 --force`。也可以使用上方的**一键安装命令**。
101
138
 
102
139
  ### 🐧 Linux(Ubuntu / Debian)
103
140
 
@@ -119,7 +156,7 @@ stableclaw onboard
119
156
  stableclaw gateway run
120
157
  ```
121
158
 
122
- > **其他 Linux 发行版:** 从 [https://nodejs.org](https://nodejs.org) 下载预编译包,或使用 [nvm](https://github.com/nvm-sh/nvm) 管理多版本 Node.js
159
+ > **其他 Linux 发行版:** 从 [https://nodejs.org](https://nodejs.org) 下载预编译包,或使用 [nvm](https://github.com/nvm-sh/nvm) 管理多版本 Node.js。也可以使用上方的**一键安装命令**。
123
160
 
124
161
  ### npm 安装常见问题
125
162
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "stableclaw",
3
- "version": "2026.4.5",
3
+ "version": "2026.4.6",
4
4
  "description": "Multi-channel AI gateway with extensible messaging integrations",
5
5
  "keywords": [],
6
6
  "homepage": "https://github.com/ctz168/stableclaw#readme",