Xpersona
agentCLAWHUBUnverified

openclaw-upgrade

OpenClaw版本升级标准流程。每次说"升级openclaw"、"openclaw升级"、"更新openclaw"时必须执行，先做环境探测+分类，再按Windows/schtasks或Linux/systemd分支走对应升级方案 Skill: openclaw-upgrade Owner: tangsuann Summary: OpenClaw版本升级标准流程。每次说"升级openclaw"、"openclaw升级"、"更新openclaw"时必须执行，先做环境探测+分类，再按Windows/schtasks或Linux/systemd分支走对应升级方案 Tags: latest:1.9.1 Version history: v1.9.1 | 2026-08-13T08:33:50.197Z | user Windows 升级主入口改为分离式 schtasks 一次性任务；openclaw update 标记为已实测失败（DLL 锁定 + 自杀陷阱，2026-08-13 实测导致 gateway 宕机 3.5h）；失败教训写入 changelog v1.9.0 | 2026-08-13T02:51:13.841Z | user 环境自适应版：合并 Win

OpenClaw
View on ClawHubHomepage

Rank

62

Safety

84

Downloads

1.6k

Updated

Oct 10, 2026

Version

1.9.1

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.6K downloads reported by the source. Last updated 10/10/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor
Clawhubvendor · observed Oct 10, 2026
Protocol compatibility
OpenClawcompatibility · observed Oct 10, 2026
Adoption signal
1.6K downloadsadoption · observed Oct 10, 2026
Latest release
1.9.1release · observed Aug 13, 2026
Handshake status
UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s176dgnza5ckzy094pj10h0xm186axgy:oc-upgrade
  1. Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
  2. Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-tangsuann-oc-upgrade/snapshot"

Documentation

CLAWHUB

143,566 characters of source documentation, loaded on request.

Extracted files

3 files captured from the source.

SKILL.md

---
name: "openclaw-upgrade"
description: "OpenClaw版本升级标准流程。每次说\"升级openclaw\"、\"openclaw升级\"、\"更新openclaw\"时必须执行，先做环境探测+分类，再按Windows/schtasks或Linux/systemd分支走对应升级方案"
---

# OpenClaw 升级技能（环境自适应版）

每次升级 OpenClaw 都必须严格按此流程执行，不能省步骤。

> 本版把 Linux 原版（systemd/bash）与 Windows 适配版（schtasks/PowerShell）合并为一个技能：第零步先探测环境并分类，之后每步按 `[Windows]` / `[Linux]` 分支走。只维护一份，不再靠两份文件。

## Changelog

> description 字段只写触发场景，不写变更记录；每次改动的原因/教训记在这里。

- 2026-08-13（实测事故）：`openclaw update`（A 方案）在 Windows 上实测失败——它内部是「先装后停」（Linux 模式），撞 DLL 锁定；且停 gateway 时把自身（gateway 子进程）一起杀死，npm install 根本没执行，gateway 宕机 3.5 小时无人拉起。教训：Windows 主入口改为「分离式 schtasks 一次性任务」，`openclaw update` 在 Windows 上禁用。
- 2026-08-13：合并 Linux 原版 + Windows 适配版为「环境自适应版」。第零步升级为「环境探测 + 分类」（判定 OS 类型 + 服务托管方式），后续每步给出 `[Windows]`/`[Linux]` 双分支。Windows 分支保留 DLL 锁定 + 自杀陷阱两个硬坑（主入口 `openclaw update --tag`），Linux 分支保留原「先装后停」流程。原两个文件已归档到 `SKILL.linux-original.bak.md`（此版之前的 Windows 版内容见 git/历史）。
- 2026-08-13：Windows 适配。本机（SCRIPT-S03-04，Windows Server 2016）实测：gateway 由 Windows 任务计划程序（schtasks）托管而非 systemd；gateway 进程加载了 node-pty-win32-x64 / tree-sitter 等原生 .node DLL，Windows 锁定运行中 DLL → 运行时直接 `npm install -g openclaw` 会 EBUSY/EPERM 失败；agent 运行在 gateway 进程内部不能自己 stop 自己。故 Windows 主入口改为 `openclaw update --tag <版本>`，裸 npm install 降级为分离式 schtasks 任务兜底。同时适配：npm registry=npmmirror（无代理）、无 curl.exe（Server 2016）改用 Invoke-WebRequest、.env 无 GITHUB_TOKEN、lossless-claw 是 npm 项目路径、消息通道 POPO 无 feishu。
- 上次（4.14版本）因为没检查 lossless-claw 兼容性踩过坑
- 上次升级后忘记发完成通知，爸比等了7小时不知道结果
- 2026-07-27：NAS欢欢用自写脚本升级，脚本从gateway进程内部nohup启动，第一步systemctl stop把整个进程组一起杀掉，脚本自己被杀死，npm install根本没跑起来，gateway停了近6小时无人察觉——本skill的流程设计（npm install前不停服务、重启只在最后单独一步、重启前先设好通知cron）天然规避了这个坑，但重启这一步本身如果裸调systemctl也仍有被自身进程树波及的理论风险，已在第八步/回滚方案中改为优先走平台 gateway 工具
- 2026-07-27（同一事故的第二个坑）：NAS欢欢手动拉起gateway后agent恢复中断会话继续把npm包升到2026.7.1-2，但机器Node还是22.22.1，openclaw 2026.7.1-2要求Node≥22.22.3，gateway直接拒绝启动；且该NAS访问registry.npmjs.org走IPv6比IPv4慢6倍，codex插件依赖安装卡在慢速IPv6上4分半——第零步此前没查Node版本、没做IPv4/IPv6测速，两个真实缺口已补入
- 2026-07-27（第三个坑，元问题）：description字段被写成changelog摘要，覆盖了触发关键词，导致agent在用户说"升级openclaw"时语义匹配不上这个skill。教训：description只写"什么场景触发"，绝不写"这次改了什么"；changelog一律写在本节。

---

## 环境分类路由表（探测后对照，一眼定位走哪个分支）

| 维度 | [Windows] 分支 | [Linux] 分支 |
|------|----------------|--------------|
| 判定 | `$env:OS` = `Windows_NT`（PowerShell） | `uname -s` = `Linux`（bash） |
| Shell | PowerShell / cmd | bash |
| Gateway 托管 | 任务计划程序「OpenClaw Gateway」（schtasks） | `systemd --user`（`openclaw-gateway.service`） |
| 原生 DLL 锁定 | ❗**有**（node-pty-win32-x64、tree-sitter）→ 运行中 `npm install -g` 必 EBUSY | 无（inode 替换，可运行中覆盖） |
| **主升级入口** | **分离式 schtasks 一次性任务**（第六步 A） | `npm install -g openclaw@<版本>`（先装后停） |
| 停服方式 | `gateway` 工具 / `schtasks /end`+`/run` | `gateway` 工具 / `systemctl --user restart` |
| npm registry | npmmirror（无代理，无 IPv6 问题） | registry.npmjs.org（需代理检测 + IPv4/IPv6 测速） |
| HTTP 探测工具 | `Invoke-WebRequest`（无 curl.exe） | `curl` |
| 配置/凭证路径 | `$env:USERPROFILE\.openclaw\...` | `~/.openclaw/...` |
| 启动脚本/override | `gateway.cmd` | `override.conf`（system

_meta.json

{
  "ownerId": "kn79f0shgp6jenfxa0cfqgm25x82m4bq",
  "slug": "oc-upgrade",
  "version": "1.9.1",
  "publishedAt": 1786610030197
}

skill-card.md

## Description:

OpenClaw upgrade procedure that guides an agent through environment detection, Windows schtasks or Linux systemd upgrade paths, backup, verification, gateway restart, and rollback.

This skill is ready for commercial/non-commercial use.

## Publisher:

[tangsuann](https://clawhub.ai/user/tangsuann)

### License/Terms of Use:

MIT-0

## Use Case:

Developers and operators use this skill to perform OpenClaw version upgrades with platform-specific checks for Windows scheduled tasks and Linux systemd environments. It helps sequence compatibility checks, backups, installation, validation, restart, notification, and rollback steps.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: The skill can replace a global OpenClaw package, restart the gateway, inspect local account layout, and create temporary scheduled execution artifacts.

Mitigation: Use it only in environments where those operations are acceptable, and review the planned commands before execution.

Risk: Target version, package registry, and Node.js compatibility issues can leave the gateway unavailable after upgrade.

Mitigation: Pin and verify the target OpenClaw version, registry, and required Node.js engine before installing, then run the documented validation checks before considering the upgrade complete.

Risk: The Windows upgrade path includes a hard-coded user path and temporary scheduled task/script artifacts.

Mitigation: Replace the hard-coded path with the target user's actual OpenClaw path and remove the scheduled task and temporary script after the upgrade.

Risk: Backup files may include .env secrets, and broad permission changes such as chmod 1777 can widen exposure.

Mitigation: Protect or remove .env backups after rollback risk has passed, and avoid broad permission changes unless they are explicitly required and reviewed.

## Reference(s):

- [ClawHub skill page](https://clawhub.ai/tangsuann/skills/oc-upgrade)
- [Publisher profile](https://clawhub.ai/user/tangsuann)

## Skill Output:

**Output Type(s):** [text, markdown, shell commands, configuration, guidance]

**Output Format:** [Markdown with inline shell and PowerShell command blocks]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Includes platform-specific operational steps, validation criteria, and rollback guidance.]

## Skill Version(s):

1.9.1 (source: server-resolved release evidence)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

Related agents

Same protocol, similar job.

Github ReposUpdated 15h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "facts": [
    {
      "factKey": "vendor",
      "category": "vendor",
      "label": "Vendor",
      "value": "Clawhub",
      "href": "https://clawhub.ai/tangsuann/skills/oc-upgrade",
      "sourceUrl": "https://clawhub.ai/tangsuann/skills/oc-upgrade",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-10T08:38:03.677Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-tangsuann-oc-upgrade/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-tangsuann-oc-upgrade/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-10-10T08:38:03.677Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "1.6K downloads",
      "href": "https://clawhub.ai/tangsuann/oc-upgrade",
      "sourceUrl": "https://clawhub.ai/tangsuann/oc-upgrade",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-10T08:38:03.677Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "1.9.1",
      "href": "https://clawhub.ai/tangsuann/oc-upgrade",
      "sourceUrl": "https://clawhub.ai/tangsuann/oc-upgrade",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-08-13T08:33:50.197Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-tangsuann-oc-upgrade/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-tangsuann-oc-upgrade/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 1.9.1",
      "description": "Windows 升级主入口改为分离式 schtasks 一次性任务；openclaw update 标记为已实测失败（DLL 锁定 + 自杀陷阱，2026-08-13 实测导致 gateway 宕机 3.5h）；失败教训写入 changelog",
      "href": "https://clawhub.ai/tangsuann/oc-upgrade",
      "sourceUrl": "https://clawhub.ai/tangsuann/oc-upgrade",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-08-13T08:33:50.197Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 10, 2026.

Sponsored

Ads related to openclaw-upgrade and adjacent AI workflows.