โ† All skills
Tencent SkillHub ยท Developer Tools

safe-update

Update OpenClaw from source code. Supports custom project path and branch. Includes pulling latest branch, rebasing, building and installing, restarting serv...

skill openclawclawhub Free
0 Downloads
0 Stars
0 Installs
0 Score
High Signal

Update OpenClaw from source code. Supports custom project path and branch. Includes pulling latest branch, rebasing, building and installing, restarting serv...

โฌ‡ 0 downloads โ˜… 0 stars Unverified but indexed

Install for OpenClaw

Quick setup
  1. Download the package from Yavira.
  2. Extract the archive and review SKILL.md first.
  3. Import or place the package into your OpenClaw setup.

Requirements

Target platform
OpenClaw
Install method
Manual import
Extraction
Extract archive
Prerequisites
OpenClaw
Primary doc
SKILL.md

Package facts

Download mode
Yavira redirect
Package format
ZIP package
Source platform
Tencent SkillHub
What's included
SKILL.md, scripts/update.sh

Validation

  • Use the Yavira download entry.
  • Review SKILL.md after the package is downloaded.
  • Confirm the extracted package contains the expected setup assets.

Install with your agent

Agent handoff

Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.

  1. Download the package from Yavira.
  2. Extract it into a folder your agent can access.
  3. Paste one of the prompts below and point your agent at the extracted folder.
New install

I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.

Upgrade existing

I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.

Trust & source

Release facts

Source
Tencent SkillHub
Verification
Indexed source record
Version
1.0.6

Documentation

ClawHub primary doc Primary doc: SKILL.md 15 sections Open source page

Safe Update

Update OpenClaw from source to the latest version while preserving local changes.

โš ๏ธ Important Warnings

This script performs git rebase and git push --force - may lose local changes if not properly committed Uses npm i -g . for global installation - may require sudo Uses systemctl --user restart - will restart the OpenClaw service Backup your config before running! (see below)

Requirements

Required binaries (must be installed): git npm / node systemctl (for restarting gateway)

Environment Variables (optional)

# Set custom project path export OPENCLAW_PROJECT_DIR="/path/to/openclaw" # Set custom branch (default: main) export OPENCLAW_BRANCH="your-feature-branch" # Enable dry-run mode (no actual changes) export DRY_RUN="true"

Or Pass as Arguments

./update.sh --dir /path/to/openclaw --branch your-branch

Step 1: Analyze Current State (Must Run First)

Before executing any update, check: Whether the current branch has uncommitted changes Whether the current branch has local modifications Whether upstream has new commits Recommend the most appropriate update strategy based on the situation Recommended Strategy: ScenarioRecommended MethodRationaleUncommitted local changesCommit/stash first, then mergeSafe, no lost changesOnly clean local commitsmerge or rebasemerge is safer, rebase keeps history cleanPreparing a PRrebase recommendedKeeps history tidyRoutine dev updatemerge recommendedSimple, less error-prone

Step 2: Ask User for Confirmation

After presenting the recommended options, you must wait for user confirmation before executing.

Step 3: Execute Update

# 1. Enter project directory cd "${OPENCLAW_PROJECT_DIR:-$HOME/projects/openclaw}" # 2. Backup config files (good practice before update!) echo "=== Backing up config files ===" mkdir -p ~/.openclaw/backups BACKUP_SUFFIX=$(date +%Y%m%d-%H%M%S) # Backup main config cp ~/.openclaw/openclaw.json ~/.openclaw/backups/openclaw.json.bak.$BACKUP_SUFFIX echo "โœ… Backed up: openclaw.json" # Backup auth profiles (if exists) if [ -f ~/.openclaw/agents/main/agent/auth-profiles.json ]; then cp ~/.openclaw/agents/main/agent/auth-profiles.json \ ~/.openclaw/backups/auth-profiles.json.bak.$BACKUP_SUFFIX echo "โœ… Backed up: auth-profiles.json" fi echo "๐Ÿ’ก Backups saved to: ~/.openclaw/backups/" echo "" # 3. Add upstream repository (if not added) git remote add upstream https://github.com/openclaw/openclaw.git 2>/dev/null || true # 4. Fetch upstream changes git fetch upstream # 5. Update target branch (use merge or rebase based on user's choice) git checkout $BRANCH # merge: git merge upstream/$BRANCH # rebase: git rebase upstream/$BRANCH # 6. View changelog echo "=== Full Changelog ===" CURRENT_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "v$(node -e 'console.log(require("./package.json").version)')") echo "Current version: $CURRENT_TAG" echo "" # 7. Build and install npm run build npm i -g . # 8. Reinstall systemd service (to update version number) echo "=== Reinstalling Gateway service ===" openclaw daemon install --force # 9. Check version NEW_VERSION=$(openclaw --version) echo "โœ… Update complete! New version: $NEW_VERSION" echo "" # 10. Ask user whether to restart echo "=== Gateway needs restart to apply updates ===" echo "Confirm restart? (y/N)"

Quick Script

Run scripts/update.sh to automatically complete all steps above.

Command Line Options

./update.sh [OPTIONS] Options: --dir PATH OpenClaw project directory (default: $HOME/projects/openclaw) --branch NAME Git branch to update (default: main) --mode MODE Update mode: merge or rebase (if not specified, will analyze and recommend) --dry-run Show what would be done without executing --help Show this help message

Examples

# Update with defaults (will analyze and recommend) ./update.sh # Update specific branch ./update.sh --branch feat/my-branch # Force merge mode ./update.sh --mode merge # Force rebase mode ./update.sh --mode rebase # Dry run (preview only) ./update.sh --dry-run # Custom project path ./update.sh --dir /opt/openclaw --branch main

Notes

Rebase may cause conflicts - if conflicts occur, resolve manually and continue Force push - after rebase, if pushing to fork, use git push --force Service reinstall - will update version in systemd unit file User confirms restart - Gateway will not restart until you confirm Backup first - always backup before updating!

Git Conflicts During Rebase

# Resolve conflicts manually, then: git add . git rebase --continue # Continue with build steps

Build Fails

# Clean and retry: rm -rf node_modules dist npm install npm run build

Gateway Won't Start

# Check status: systemctl --user status openclaw-gateway # View logs: journalctl --user -u openclaw-gateway -n 50

Category context

Code helpers, APIs, CLIs, browser automation, testing, and developer operations.

Source: Tencent SkillHub

Largest current source with strong distribution and engagement signals.

Package contents

Included in package
1 Docs1 Scripts
  • SKILL.md Primary doc
  • scripts/update.sh Scripts