Skip to content

Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.

add script to uninstall openclaw-plugin (#933)

AutoCoderdd8863e2c508
diff --git a/examples/openclaw-plugin/upgrade_scripts/uninstall-openclaw-plugin.sh b/examples/openclaw-plugin/upgrade_scripts/uninstall-openclaw-plugin.sh
new file mode 100644
index 000000000..e26ebaaca
--- /dev/null
+++ b/examples/openclaw-plugin/upgrade_scripts/uninstall-openclaw-plugin.sh
@@ -0,0 +1,298 @@
+#!/bin/bash
+#
+# 卸载新版 openviking 插件的脚本
+#
+# 用法:
+# bash uninstall-openviking.sh
+# bash uninstall-openviking.sh --workdir ~/.openclaw-dir # 指定 OpenClaw 目录
+#
+set -euo pipefail
+
+info() { printf '\033[0;32m[INFO] \033[0m%s\n' "$*"; }
+warn() { printf '\033[1;33m[WARN] \033[0m%s\n' "$*"; }
+error() { printf '\033[0;31m[ERROR]\033[0m%s\n' "$*"; }
+
+HOME_DIR="${HOME}"
+OPENCLAW_DIR="${HOME_DIR}/.openclaw"
+
+while [[ $# -gt 0 ]]; do
+ case "$1" in
+ --workdir)
+ if [[ $# -lt 2 || -z "${2:-}" || "${2:-}" == -* ]]; then
+ error "--workdir 需要提供一个目录路径"
+ echo "用法:$0 [--workdir <openclaw目录>]"
+ exit 1
+ fi
+ OPENCLAW_DIR="$2"
+ shift 2 ;;
+ -h|--help)
+ echo "用法:$0 [--workdir <openclaw目录>]"
+ exit 0 ;;
+ *)
+ error "未知参数:$1"
+ exit 1 ;;
+ esac
+done
+
+CONFIG_FILE="${OPENCLAW_DIR}/openclaw.json"
+PLUGIN_ID="openviking"
+PLUGIN_DIR="${OPENCLAW_DIR}/extensions/${PLUGIN_ID}"
+DISABLED_DIR="${OPENCLAW_DIR}/disabled-extensions"
+PLUGIN_BACKUP_DIR="${DISABLED_DIR}/${PLUGIN_ID}-uninstall-backup-$(date +%Y%m%d%H%M%S)"
+BAK_SUFFIX=".pre-openviking-uninstall.bak"
+
+CONFIG_BACKUP_CREATED=0
+PLUGIN_MOVED=0
+
+rollback_on_error() {
+ local exit_code="$?"
+ trap - ERR
+
+ error "卸载过程中发生错误,正在尝试回滚..."
+
+ if [ "${CONFIG_BACKUP_CREATED}" -eq 1 ] && [ -f "${CONFIG_FILE}${BAK_SUFFIX}" ]; then
+ cp "${CONFIG_FILE}${BAK_SUFFIX}" "${CONFIG_FILE}" && warn "已恢复配置文件 ${CONFIG_FILE}"
+ fi
+
+ if [ "${PLUGIN_MOVED}" -eq 1 ] && [ -d "${PLUGIN_BACKUP_DIR}" ] && [ ! -d "${PLUGIN_DIR}" ]; then
+ mkdir -p "$(dirname "${PLUGIN_DIR}")"
+ mv "${PLUGIN_BACKUP_DIR}" "${PLUGIN_DIR}" && warn "已恢复插件目录 ${PLUGIN_DIR}"
+ fi
+
+ exit "${exit_code}"
+}
+
+trap 'rollback_on_error' ERR
+
+if ! command -v openclaw &>/dev/null; then
+ error "未找到 openclaw 命令,请先安装 OpenClaw"
+ exit 1
+fi
+
+if ! command -v node &>/dev/null; then
+ error "未找到 node 命令,无法自动清理 OpenClaw 配置"
+ exit 1
+fi
+
+if [ ! -d "${OPENCLAW_DIR}" ]; then
+ error "未找到 OpenClaw 目录:${OPENCLAW_DIR}"
+ error "如果使用了非默认安装路径,请通过 --workdir 参数指定:"
+ error " bash $0 --workdir /your/openclaw/dir"
+ exit 1
+fi
+
+if [ ! -f "${CONFIG_FILE}" ]; then
+ error "未找到 OpenClaw 配置文件:${CONFIG_FILE}"
+ if [ "${OPENCLAW_DIR}" = "${HOME_DIR}/.openclaw" ]; then
+ error "请确认 OpenClaw 已安装并初始化(openclaw onboard)"
+ error "如果使用了非默认安装路径,请通过 --workdir 参数指定:"
+ error " bash $0 --workdir /your/openclaw/dir"
+ else
+ error "请确认该目录下存在有效的 OpenClaw 配置"
+ fi
+ exit 1
+fi
+
+OC_ENV=()
+if [ "${OPENCLAW_DIR}" != "${HOME_DIR}/.openclaw" ]; then
+ OC_ENV=(env OPENCLAW_STATE_DIR="${OPENCLAW_DIR}")
+fi
+
+info "OpenClaw 目录:${OPENCLAW_DIR}"
+info "配置文件:${CONFIG_FILE}"
+info "OpenViking 服务/运行时:保留,不做卸载"
+echo ""
+
+# ============================================================
+# Step 1: 停止 OpenClaw gateway
+# ============================================================
+info "Step 1: 停止 OpenClaw gateway..."
+if "${OC_ENV[@]}" openclaw gateway stop 2>/dev/null; then
+ info "gateway 已停止"
+else
+ warn "gateway 可能未在运行,继续..."
+fi
+echo ""
+
+# ============================================================
+# Step 2: 备份当前配置
+# ============================================================
+info "Step 2: 备份当前配置..."
+cp "${CONFIG_FILE}" "${CONFIG_FILE}${BAK_SUFFIX}"
+CONFIG_BACKUP_CREATED=1
+info "配置已备份至 ${CONFIG_FILE}${BAK_SUFFIX}"
+echo ""
+
+# ============================================================
+# Step 3: 清理 openclaw.json 中的新版插件配置
+# ============================================================
+info "Step 3: 清理 openclaw.json 中的新版插件配置..."
+
+CONFIG_STATUS="$(
+node - "${CONFIG_FILE}" "${PLUGIN_ID}" <<'NODE'
+const fs = require('fs');
+
+const file = process.argv[2];
+const pluginId = process.argv[3];
+const pluginPathPattern = new RegExp(pluginId, 'i');
+const status = {
+ plugins: 'missing',
+ allow: 'skipped',
+ loadPaths: 'skipped',
+ entry: 'skipped',
+ slot: 'skipped',
+};
+
+let cfg;
+try {
+ cfg = JSON.parse(fs.readFileSync(file, 'utf8'));
+} catch (e) {
+ console.error('JSON 解析失败:' + e.message);
+ process.exit(1);
+}
+
+const plugins = cfg.plugins;
+if (!plugins) {
+ console.log(`plugins=${status.plugins}`);
+ console.log(`allow=${status.allow}`);
+ console.log(`loadPaths=${status.loadPaths}`);
+ console.log(`entry=${status.entry}`);
+ console.log(`slot=${status.slot}`);
+ process.exit(0);
+}
+
+status.plugins = 'present';
+
+if (Array.isArray(plugins.allow)) {
+ const nextAllow = plugins.allow.filter((x) => x !== pluginId);
+ status.allow = nextAllow.length !== plugins.allow.length ? 'removed' : 'unchanged';
+ plugins.allow = nextAllow;
+} else {
+ status.allow = 'unchanged';
+}
+
+if (Array.isArray(plugins.load?.paths)) {
+ const nextPaths = plugins.load.paths.filter((x) => typeof x !== 'string' || !pluginPathPattern.test(x));
+ status.loadPaths = nextPaths.length !== plugins.load.paths.length ? 'removed' : 'unchanged';
+ plugins.load.paths = nextPaths;
+} else {
+ status.loadPaths = 'unchanged';
+}
+
+if (plugins.entries && pluginId in plugins.entries) {
+ delete plugins.entries[pluginId];
+ status.entry = 'removed';
+} else {
+ status.entry = 'unchanged';
+}
+
+if (plugins.slots?.contextEngine === pluginId) {
+ plugins.slots.contextEngine = 'legacy';
+ status.slot = 'rolled_back';
+} else {
+ status.slot = 'unchanged';
+}
+
+fs.writeFileSync(file, JSON.stringify(cfg, null, 2) + '\n');
+console.log(`plugins=${status.plugins}`);
+console.log(`allow=${status.allow}`);
+console.log(`loadPaths=${status.loadPaths}`);
+console.log(`entry=${status.entry}`);
+console.log(`slot=${status.slot}`);
+NODE
+)"
+
+PLUGINS_STATUS=""
+ALLOW_STATUS=""
+LOAD_PATHS_STATUS=""
+ENTRY_STATUS=""
+SLOT_STATUS=""
+while IFS='=' read -r key value; do
+ case "${key}" in
+ plugins) PLUGINS_STATUS="${value}" ;;
+ allow) ALLOW_STATUS="${value}" ;;
+ loadPaths) LOAD_PATHS_STATUS="${value}" ;;
+ entry) ENTRY_STATUS="${value}" ;;
+ slot) SLOT_STATUS="${value}" ;;
+ esac
+done <<< "${CONFIG_STATUS}"
+
+if [ "${PLUGINS_STATUS}" = "missing" ]; then
+ warn "openclaw.json 中未找到 plugins 字段,未修改插件配置"
+else
+ if [ "${ALLOW_STATUS}" = "removed" ]; then
+ info "已从 plugins.allow 中移除 \"${PLUGIN_ID}\""
+ else
+ info "plugins.allow 中未找到 \"${PLUGIN_ID}\",跳过"
+ fi
+
+ if [ "${LOAD_PATHS_STATUS}" = "removed" ]; then
+ info "已从 plugins.load.paths 中移除包含 ${PLUGIN_ID} 的路径"
+ else
+ info "plugins.load.paths 中未找到包含 ${PLUGIN_ID} 的路径,跳过"
+ fi
+
+ if [ "${ENTRY_STATUS}" = "removed" ]; then
+ info "已删除 plugins.entries.${PLUGIN_ID}"
+ else
+ info "plugins.entries.${PLUGIN_ID} 不存在,跳过"
+ fi
+
+ if [ "${SLOT_STATUS}" = "rolled_back" ]; then
+ info "已将 plugins.slots.contextEngine 回退为 legacy"
+ else
+ info "plugins.slots.contextEngine 当前不是 ${PLUGIN_ID},保持不变"
+ fi
+fi
+echo ""
+
+# ============================================================
+# Step 4: 恢复 OpenClaw memory 为 memory-core
+# ============================================================
+info "Step 4: 恢复 OpenClaw memory 为 memory-core..."
+"${OC_ENV[@]}" openclaw plugins enable memory-core >/dev/null
+info "已执行:openclaw plugins enable memory-core"
+echo ""
+
+# ============================================================
+# Step 5: 备份插件目录
+# ============================================================
+info "Step 5: 备份插件目录..."
+if [ -d "${PLUGIN_DIR}" ]; then
+ mkdir -p "${DISABLED_DIR}"
+ mv "${PLUGIN_DIR}" "${PLUGIN_BACKUP_DIR}"
+ PLUGIN_MOVED=1
+ info "插件目录已移至 ${PLUGIN_BACKUP_DIR}"
+else
+ warn "未找到插件目录 ${PLUGIN_DIR},跳过目录备份"
+fi
+echo ""
+
+# ============================================================
+# Step 6: 保留 OpenViking 服务/运行时
+# ============================================================
+info "Step 6: 保留 OpenViking 服务/运行时..."
+info "已保留 Python 包 openviking、~/.openviking 目录及 openviking.env 环境文件"
+echo ""
+
+# ============================================================
+# 完成
+# ============================================================
+info "✓ 卸载完成"
+info ""
+info "请重启 OpenClaw 继续使用:"
+info " 服务模式:openclaw gateway start"
+info " 已在运行的服务:openclaw gateway restart"
+info " 前台直接运行:openclaw gateway"
+info ""
+info "如需恢复插件配置:"
+info " 1. openclaw gateway stop"
+info " 2. cp ${CONFIG_FILE}${BAK_SUFFIX} ${CONFIG_FILE}"
+if [ -d "${PLUGIN_BACKUP_DIR}" ]; then
+ info " 3. mv ${PLUGIN_BACKUP_DIR} ${PLUGIN_DIR}"
+fi
+info ""
+info "如需重新安装新版 openviking 插件:"
+info " npm install -g openclaw-openviking-setup-helper && ov-install"
+
+trap - ERR