Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
Python agent-contextagent-memoryagent-pluginsagentic-ragcontext-databasedsh-pluginknowledge-basememorymemory-managementself-evolvingvector-database
支持通过curl方式安装部署openclaw+openviking插件 (#415)
LinQiang391bb6087a96a1b
diff --git a/examples/openclaw-memory-plugin/INSTALL-ZH.md b/examples/openclaw-memory-plugin/INSTALL-ZH.mdindex 241fde3c7..18bcd2c17 100644--- a/examples/openclaw-memory-plugin/INSTALL-ZH.md+++ b/examples/openclaw-memory-plugin/INSTALL-ZH.md@@ -4,6 +4,24 @@---+## 一键安装(Linux / macOS)++**前置条件:** Python >= 3.10、Node.js >= 22。脚本会自动校验这些依赖,若有缺失会给出安装指引。++```bash+curl -fsSL https://raw.githubusercontent.com/volcengine/OpenViking/main/examples/openclaw-memory-plugin/install.sh | bash+```++非交互模式(使用默认配置):++```bash+curl -fsSL https://raw.githubusercontent.com/volcengine/OpenViking/main/examples/openclaw-memory-plugin/install.sh | bash -s -y+```++脚本会:1) 校验 OpenViking 运行环境(并检查是否已安装 OpenClaw);2) 仅安装 OpenViking;3) 配置并部署记忆插件。++---+## 一、快速开始(让 OpenClaw 自动安装)先将技能文件复制到 OpenClaw 技能目录,再让 OpenClaw 完成后续步骤:diff --git a/examples/openclaw-memory-plugin/INSTALL.md b/examples/openclaw-memory-plugin/INSTALL.mdindex 0c8b0e313..1030693f7 100644--- a/examples/openclaw-memory-plugin/INSTALL.md+++ b/examples/openclaw-memory-plugin/INSTALL.md@@ -4,6 +4,24 @@ Give [OpenClaw](https://github.com/openclaw/openclaw) long-term memory powered b---+## One-Click Install (Linux / macOS)++**Prerequisites:** Python >= 3.10, Node.js >= 22. The script checks these and prompts you to install any missing components.++```bash+curl -fsSL https://raw.githubusercontent.com/volcengine/OpenViking/main/examples/openclaw-memory-plugin/install.sh | bash+```++Non-interactive mode:++```bash+curl -fsSL https://raw.githubusercontent.com/volcengine/OpenViking/main/examples/openclaw-memory-plugin/install.sh | bash -s -y+```++The script will: 1) validate the OpenViking runtime environment (and check that OpenClaw is installed), 2) install OpenViking only, 3) configure and deploy the memory plugin.++---+## 1. Quick Start (Let OpenClaw Install It)Copy the skill file into OpenClaw's skill directory, then let OpenClaw handle the rest:diff --git a/examples/openclaw-memory-plugin/install.ps1 b/examples/openclaw-memory-plugin/install.ps1new file mode 100644index 000000000..eb83fd1b4--- /dev/null+++ b/examples/openclaw-memory-plugin/install.ps1@@ -0,0 +1,385 @@+param(+ [switch]$Yes,+ [switch]$Zh+)++$ErrorActionPreference = "Stop"++function T {+ param(+ [string]$En,+ [string]$ZhText+ )+ if ($Zh) { return $ZhText }+ return $En+}++function Info($m) { Write-Host "[INFO] $m" -ForegroundColor Green }+function Warn($m) { Write-Host "[WARN] $m" -ForegroundColor Yellow }+function Err($m) { Write-Host "[ERROR] $m" -ForegroundColor Red }+function Title($m) { Write-Host $m -ForegroundColor Cyan }+function Write-Utf8NoBom {+ param(+ [string]$Path,+ [string]$Content+ )+ $enc = New-Object System.Text.UTF8Encoding($false)+ [System.IO.File]::WriteAllText($Path, $Content, $enc)+}++$Repo = if ($env:REPO) { $env:REPO } else { "volcengine/OpenViking" }+$Branch = if ($env:BRANCH) { $env:BRANCH } else { "main" }+$NpmRegistry = if ($env:NPM_REGISTRY) { $env:NPM_REGISTRY } else { "https://registry.npmmirror.com" }+$PipIndexUrl = if ($env:PIP_INDEX_URL) { $env:PIP_INDEX_URL } else { "https://pypi.tuna.tsinghua.edu.cn/simple" }++$HomeDir = if ($env:USERPROFILE) { $env:USERPROFILE } else { $HOME }+$OpenClawDir = Join-Path $HomeDir ".openclaw"+$OpenVikingDir = Join-Path $HomeDir ".openviking"+$PluginDest = Join-Path $OpenClawDir "extensions\memory-openviking"++$DefaultServerPort = 1933+$DefaultAgfsPort = 1833+$DefaultVlmModel = "doubao-seed-1-8-251228"+$DefaultEmbeddingModel = "doubao-embedding-vision-250615"++function Get-PythonCommand {+ if ($env:OPENVIKING_PYTHON) { return $env:OPENVIKING_PYTHON }+ if (Get-Command python -ErrorAction SilentlyContinue) { return "python" }+ if (Get-Command python3 -ErrorAction SilentlyContinue) { return "python3" }+ return $null+}++function Check-Python {+ $py = Get-PythonCommand+ if (-not $py) {+ return @{ Ok = $false; Detail = (T "Python not found. Install Python >= 3.10." "Python 未找到,请安装 Python >= 3.10") }+ }+ try {+ $v = & $py -c "import sys; print(f'{sys.version_info.major}.{sys.version_info.minor}')" 2>$null+ if (-not $v) {+ return @{ Ok = $false; Detail = (T "Python command failed." "Python 命令执行失败") }+ }+ $parts = $v.Trim().Split(".")+ $major = [int]$parts[0]+ $minor = [int]$parts[1]+ if ($major -lt 3 -or ($major -eq 3 -and $minor -lt 10)) {+ return @{ Ok = $false; Detail = (T "Python $v is too old. Need >= 3.10." "Python 版本 $v 过低,需要 >= 3.10") }+ }+ return @{ Ok = $true; Detail = "$v ($py)"; Cmd = $py }+ } catch {+ return @{ Ok = $false; Detail = $_.Exception.Message }+ }+}++function Check-Node {+ try {+ if (-not (Get-Command node -ErrorAction SilentlyContinue)) {+ return @{ Ok = $false; Detail = (T "Node.js not found. Install Node.js >= 22." "Node.js 未找到,请安装 Node.js >= 22") }+ }+ $v = (node -v).Trim()+ $major = [int]($v.TrimStart("v").Split(".")[0])+ if ($major -lt 22) {+ return @{ Ok = $false; Detail = (T "Node.js $v is too old. Need >= 22." "Node.js 版本 $v 过低,需要 >= 22") }+ }+ return @{ Ok = $true; Detail = $v }+ } catch {+ return @{ Ok = $false; Detail = $_.Exception.Message }+ }+}++function Validate-Environment {+ Info (T "Checking OpenViking runtime environment..." "正在校验 OpenViking 运行环境...")+ Write-Host ""++ $missing = @()++ $py = Check-Python+ if ($py.Ok) {+ Info (" Python: {0} ✓" -f $py.Detail)+ } else {+ $missing += "Python >= 3.10"+ Err (" {0}" -f $py.Detail)+ }++ $node = Check-Node+ if ($node.Ok) {+ Info (" Node.js: {0} ✓" -f $node.Detail)+ } else {+ $missing += "Node.js >= 22"+ Err (" {0}" -f $node.Detail)+ }++ if ($missing.Count -gt 0) {+ Write-Host ""+ Err (T "Environment check failed. Install missing dependencies first." "环境校验未通过,请先安装以下缺失组件。")+ Write-Host ""+ if ($missing -contains "Python >= 3.10") {+ Write-Host (T "Python (example via winget):" "Python(可使用 winget 安装示例):")+ Write-Host " winget install --id Python.Python.3.11 -e"+ Write-Host ""+ }+ if ($missing -contains "Node.js >= 22") {+ Write-Host (T "Node.js (example via nvm-windows):" "Node.js(可使用 nvm-windows 安装示例):")+ Write-Host " nvm install 22.22.0"+ Write-Host " nvm use 22.22.0"+ Write-Host ""+ }+ exit 1+ }++ Write-Host ""+ Info (T "Environment check passed ✓" "环境校验通过 ✓")+ Write-Host ""+}++function Check-OpenClaw {+ if ($env:SKIP_OPENCLAW -eq "1") {+ Info (T "Skipping OpenClaw check (SKIP_OPENCLAW=1)" "跳过 OpenClaw 校验 (SKIP_OPENCLAW=1)")+ return+ }++ Info (T "Checking OpenClaw..." "正在校验 OpenClaw...")+ if (Get-Command openclaw -ErrorAction SilentlyContinue) {+ Info (T "OpenClaw detected ✓" "OpenClaw 已安装 ✓")+ return+ }++ Err (T "OpenClaw not found. Install it manually, then rerun this script." "未检测到 OpenClaw,请先手动安装后再执行本脚本")+ Write-Host ""+ Write-Host (T "Recommended command:" "推荐命令:")+ Write-Host " npm install -g openclaw --registry $NpmRegistry"+ Write-Host ""+ Write-Host " openclaw --version"+ Write-Host " openclaw onboard"+ Write-Host ""+ exit 1+}++function Install-OpenViking {+ if ($env:SKIP_OPENVIKING -eq "1") {+ Info (T "Skipping OpenViking install (SKIP_OPENVIKING=1)" "跳过 OpenViking 安装 (SKIP_OPENVIKING=1)")+ return+ }++ $py = (Check-Python).Cmd+ Info (T "Installing OpenViking from PyPI..." "正在安装 OpenViking (PyPI)...")+ Info ("{0} {1}" -f (T "Using pip index:" "使用 pip 镜像源:"), $PipIndexUrl)+ & $py -m pip install --upgrade pip -i $PipIndexUrl | Out-Host+ & $py -m pip install openviking -i $PipIndexUrl | Out-Host+ Info (T "OpenViking installed ✓" "OpenViking 安装完成 ✓")+}++function Prompt-OrDefault {+ param(+ [string]$PromptText,+ [string]$DefaultValue+ )+ $v = Read-Host "$PromptText [$DefaultValue]"+ if ([string]::IsNullOrWhiteSpace($v)) { return $DefaultValue }+ return $v.Trim()+}++function Prompt-Optional {+ param([string]$PromptText)+ $v = Read-Host $PromptText+ if ([string]::IsNullOrWhiteSpace($v)) { return "" }+ return $v.Trim()+}++function Configure-OvConf {+ New-Item -ItemType Directory -Force -Path $OpenVikingDir | Out-Null++ $workspace = Join-Path $OpenVikingDir "data"+ $serverPort = "$DefaultServerPort"+ $agfsPort = "$DefaultAgfsPort"+ $vlmModel = $DefaultVlmModel+ $embeddingModel = $DefaultEmbeddingModel++ $legacyKey = if ($env:OPENVIKING_ARK_API_KEY) { $env:OPENVIKING_ARK_API_KEY } else { "" }+ $vlmApiKey = if ($env:OPENVIKING_VLM_API_KEY) { $env:OPENVIKING_VLM_API_KEY } else { $legacyKey }+ $embeddingApiKey = if ($env:OPENVIKING_EMBEDDING_API_KEY) { $env:OPENVIKING_EMBEDDING_API_KEY } else { $legacyKey }++ if (-not $Yes) {+ Write-Host ""+ $workspace = Prompt-OrDefault (T "OpenViking workspace path" "OpenViking 数据目录") $workspace+ $serverPort = Prompt-OrDefault (T "OpenViking HTTP port" "OpenViking HTTP 端口") $serverPort+ $agfsPort = Prompt-OrDefault (T "AGFS port" "AGFS 端口") $agfsPort+ $vlmModel = Prompt-OrDefault (T "VLM model" "VLM 模型") $vlmModel+ $embeddingModel = Prompt-OrDefault (T "Embedding model" "Embedding 模型") $embeddingModel+ Write-Host (T "VLM and Embedding API keys can differ. You can leave either empty and edit ov.conf later." "说明:VLM 与 Embedding 的 API Key 可能不同,可分别填写;留空后续可在 ov.conf 修改。")+ $vlmInput = Prompt-Optional (T "VLM API key (optional)" "VLM API Key(可留空)")+ $embInput = Prompt-Optional (T "Embedding API key (optional)" "Embedding API Key(可留空)")+ if ($vlmInput) { $vlmApiKey = $vlmInput }+ if ($embInput) { $embeddingApiKey = $embInput }+ }++ New-Item -ItemType Directory -Force -Path $workspace | Out-Null++ $cfg = @{+ server = @{+ host = "127.0.0.1"+ port = [int]$serverPort+ root_api_key = $null+ cors_origins = @("*")+ }+ storage = @{+ workspace = $workspace+ vectordb = @{ name = "context"; backend = "local"; project = "default" }+ agfs = @{ port = [int]$agfsPort; log_level = "warn"; backend = "local"; timeout = 10; retry_times = 3 }+ }+ embedding = @{+ dense = @{+ backend = "volcengine"+ api_key = $(if ($embeddingApiKey) { $embeddingApiKey } else { $null })+ model = $embeddingModel+ api_base = "https://ark.cn-beijing.volces.com/api/v3"+ dimension = 1024+ input = "multimodal"+ }+ }+ vlm = @{+ backend = "volcengine"+ api_key = $(if ($vlmApiKey) { $vlmApiKey } else { $null })+ model = $vlmModel+ api_base = "https://ark.cn-beijing.volces.com/api/v3"+ temperature = 0.1+ max_retries = 3+ }+ }++ $confPath = Join-Path $OpenVikingDir "ov.conf"+ $cfgJson = $cfg | ConvertTo-Json -Depth 10+ Write-Utf8NoBom -Path $confPath -Content $cfgJson+ Info ("{0} {1}" -f (T "Config generated:" "已生成配置:"), $confPath)+ return [int]$serverPort+}++function Download-Plugin {+ $rawBase = "https://raw.githubusercontent.com/$Repo/$Branch"+ $files = @(+ "examples/openclaw-memory-plugin/index.ts",+ "examples/openclaw-memory-plugin/config.ts",+ "examples/openclaw-memory-plugin/openclaw.plugin.json",+ "examples/openclaw-memory-plugin/package.json",+ "examples/openclaw-memory-plugin/package-lock.json",+ "examples/openclaw-memory-plugin/.gitignore"+ )++ New-Item -ItemType Directory -Force -Path $PluginDest | Out-Null+ Info (T "Downloading memory-openviking plugin..." "正在下载 memory-openviking 插件...")+ Info ("{0} $Repo@$Branch" -f (T "Plugin source:" "插件来源:"))++ foreach ($rel in $files) {+ $name = Split-Path $rel -Leaf+ $url = "$rawBase/$rel"+ $dst = Join-Path $PluginDest $name+ try {+ Invoke-WebRequest -Uri $url -OutFile $dst -UseBasicParsing | Out-Null+ } catch {+ Err ("{0} $url" -f (T "Download failed:" "下载失败:"))+ throw+ }+ }++ Push-Location $PluginDest+ try {+ npm install --no-audit --no-fund | Out-Host+ } finally {+ Pop-Location+ }+ Info ("{0} $PluginDest" -f (T "Plugin deployed:" "插件部署完成:"))+}++function Configure-OpenClawPlugin {+ param([int]$ServerPort)+ Info (T "Configuring OpenClaw plugin..." "正在配置 OpenClaw 插件...")++ $cfgPath = Join-Path $OpenClawDir "openclaw.json"+ $cfg = @{}+ if (Test-Path $cfgPath) {+ try {+ $raw = Get-Content -Raw -Path $cfgPath+ if (-not [string]::IsNullOrWhiteSpace($raw)) {+ $obj = $raw | ConvertFrom-Json -AsHashtable+ if ($obj) { $cfg = $obj }+ }+ } catch {+ Warn (T "Existing openclaw.json is invalid. Rebuilding required sections." "检测到已有 openclaw.json 非法,将重建相关配置节点。")+ }+ }++ if (-not $cfg.ContainsKey("plugins")) { $cfg["plugins"] = @{} }+ if (-not $cfg.ContainsKey("gateway")) { $cfg["gateway"] = @{} }+ if (-not $cfg["plugins"].ContainsKey("slots")) { $cfg["plugins"]["slots"] = @{} }+ if (-not $cfg["plugins"].ContainsKey("load")) { $cfg["plugins"]["load"] = @{} }+ if (-not $cfg["plugins"].ContainsKey("entries")) { $cfg["plugins"]["entries"] = @{} }++ # Keep plugin load paths unique.+ $existingPaths = @()+ if ($cfg["plugins"]["load"].ContainsKey("paths") -and $cfg["plugins"]["load"]["paths"]) {+ $existingPaths = @($cfg["plugins"]["load"]["paths"])+ }+ $mergedPaths = @($existingPaths + @($PluginDest) | Select-Object -Unique)++ $cfg["plugins"]["enabled"] = $true+ $cfg["plugins"]["allow"] = @("memory-openviking")+ $cfg["plugins"]["slots"]["memory"] = "memory-openviking"+ $cfg["plugins"]["load"]["paths"] = $mergedPaths+ $cfg["plugins"]["entries"]["memory-openviking"] = @{+ config = @{+ mode = "local"+ configPath = "~/.openviking/ov.conf"+ port = $ServerPort+ targetUri = "viking://"+ autoRecall = $true+ autoCapture = $true+ }+ }+ $cfg["gateway"]["mode"] = "local"++ $cfgJson = $cfg | ConvertTo-Json -Depth 20+ Write-Utf8NoBom -Path $cfgPath -Content $cfgJson++ Info (T "OpenClaw plugin configured" "OpenClaw 插件配置完成")+}++function Write-OpenVikingEnv {+ $pyCmd = Get-PythonCommand+ $pyPath = ""+ if ($pyCmd) {+ $g = Get-Command $pyCmd -ErrorAction SilentlyContinue+ if ($g) { $pyPath = $g.Source }+ }++ New-Item -ItemType Directory -Force -Path $OpenClawDir | Out-Null+ $envPath = Join-Path $OpenClawDir "openviking.env.ps1"+ $envContent = '$env:OPENVIKING_PYTHON = "' + $pyPath + '"'+ Write-Utf8NoBom -Path $envPath -Content $envContent++ Info ("{0} $envPath" -f (T "Environment file generated:" "已生成环境文件:"))+}++Title (T "🦣 OpenClaw + OpenViking Installer" "🦣 OpenClaw + OpenViking 一键安装")+Write-Host ""++Validate-Environment+Check-OpenClaw+Install-OpenViking+$serverPort = Configure-OvConf+Download-Plugin+Configure-OpenClawPlugin -ServerPort $serverPort+Write-OpenVikingEnv++Write-Host ""+Title "═══════════════════════════════════════════════════════════"+Title (" {0}" -f (T "Installation complete!" "安装完成!"))+Title "═══════════════════════════════════════════════════════════"+Write-Host ""+Info (T "Run these commands to start OpenClaw + OpenViking:" "请按以下命令启动 OpenClaw + OpenViking:")+Write-Host " 1) openclaw --version"+Write-Host " 2) openclaw onboard"+Write-Host " 3) . `"$OpenClawDir\openviking.env.ps1`"; openclaw gateway"+Write-Host " 4) openclaw status"+Write-Host ""+Info ("{0} $OpenVikingDir\ov.conf" -f (T "You can edit the config freely:" "你可以按需自由修改配置文件:"))+Write-Host ""diff --git a/examples/openclaw-memory-plugin/install.sh b/examples/openclaw-memory-plugin/install.shnew file mode 100644index 000000000..83ee10519--- /dev/null+++ b/examples/openclaw-memory-plugin/install.sh@@ -0,0 +1,440 @@+#!/bin/bash+#+# OpenClaw + OpenViking one-click installer+# Usage: curl -fsSL https://raw.githubusercontent.com/volcengine/OpenViking/main/examples/openclaw-memory-plugin/install.sh | bash+#+# Environment variables:+# REPO=owner/repo - GitHub repository (default: volcengine/OpenViking)+# BRANCH=branch - Git branch/tag/commit (default: main)+# OPENVIKING_INSTALL_YES=1 - non-interactive mode (same as -y)+# SKIP_OPENCLAW=1 - skip OpenClaw check+# SKIP_OPENVIKING=1 - skip OpenViking installation+# NPM_REGISTRY=url - npm registry (default: https://registry.npmmirror.com)+# PIP_INDEX_URL=url - pip index URL (default: https://pypi.tuna.tsinghua.edu.cn/simple)+# OPENVIKING_VLM_API_KEY - VLM model API key (optional)+# OPENVIKING_EMBEDDING_API_KEY - Embedding model API key (optional)+# OPENVIKING_ARK_API_KEY - legacy fallback for both keys+#++set -e++REPO="${REPO:-volcengine/OpenViking}"+BRANCH="${BRANCH:-main}"+INSTALL_YES="${OPENVIKING_INSTALL_YES:-0}"+SKIP_OC="${SKIP_OPENCLAW:-0}"+SKIP_OV="${SKIP_OPENVIKING:-0}"+NPM_REGISTRY="${NPM_REGISTRY:-https://registry.npmmirror.com}"+PIP_INDEX_URL="${PIP_INDEX_URL:-https://pypi.tuna.tsinghua.edu.cn/simple}"+HOME_DIR="${HOME:-$USERPROFILE}"+OPENCLAW_DIR="${HOME_DIR}/.openclaw"+OPENVIKING_DIR="${HOME_DIR}/.openviking"+PLUGIN_DEST="${OPENCLAW_DIR}/extensions/memory-openviking"+DEFAULT_SERVER_PORT=1933+DEFAULT_AGFS_PORT=1833+DEFAULT_VLM_MODEL="doubao-seed-1-8-251228"+DEFAULT_EMBED_MODEL="doubao-embedding-vision-250615"+SELECTED_SERVER_PORT="${DEFAULT_SERVER_PORT}"+LANG_UI="en"++# Parse args (supports curl | bash -s -- ...)+for arg in "$@"; do+ [[ "$arg" == "-y" || "$arg" == "--yes" ]] && INSTALL_YES="1"+ [[ "$arg" == "--zh" ]] && LANG_UI="zh"+ [[ "$arg" == "-h" || "$arg" == "--help" ]] && {+ echo "Usage: curl -fsSL <INSTALL_URL> | bash [-s -- -y --zh]"+ echo ""+ echo "Options:"+ echo " -y, --yes Non-interactive mode"+ echo " --zh Chinese prompts"+ echo " -h, --help Show this help"+ echo ""+ echo "Env vars: REPO, BRANCH, OPENVIKING_INSTALL_YES, SKIP_OPENCLAW, SKIP_OPENVIKING, NPM_REGISTRY, PIP_INDEX_URL"+ exit 0+ }+done++tr() {+ local en="$1"+ local zh="$2"+ if [[ "$LANG_UI" == "zh" ]]; then+ echo "$zh"+ else+ echo "$en"+ fi+}++# Prefer interactive mode. Even with curl | bash, try reading from /dev/tty.+# Fall back to defaults only when no interactive TTY is available.+if [[ ! -t 0 && "$INSTALL_YES" != "1" ]]; then+ if [[ ! -r /dev/tty ]]; then+ INSTALL_YES="1"+ echo "[WARN] $(tr "No interactive TTY detected. Falling back to defaults (-y)." "未检测到可交互终端,自动切换为默认配置模式(等同于 -y)")"+ else+ echo "[INFO] $(tr "Pipeline execution detected. Interactive prompts will use /dev/tty." "检测到管道执行,将通过 /dev/tty 进入交互配置")"+ fi+fi++# 颜色与输出+RED='\033[0;31m'+GREEN='\033[0;32m'+YELLOW='\033[1;33m'+BOLD='\033[1m'+NC='\033[0m'++info() { echo -e "${GREEN}[INFO]${NC} $1"; }+warn() { echo -e "${YELLOW}[WARN]${NC} $1"; }+err() { echo -e "${RED}[ERROR]${NC} $1"; }+bold() { echo -e "${BOLD}$1${NC}"; }++# Detect OS+detect_os() {+ case "$(uname -s)" in+ Linux*) OS="linux";;+ Darwin*) OS="macos";;+ CYGWIN*|MINGW*|MSYS*) OS="windows";;+ *) OS="unknown";;+ esac+ if [[ "$OS" == "windows" ]]; then+ err "$(tr "Windows is not supported by this installer yet. Please follow the docs for manual setup." "Windows 暂不支持此一键安装脚本,请参考文档手动安装。")"+ exit 1+ fi+}++# Detect Linux distro+detect_distro() {+ DISTRO="unknown"+ if [[ -f /etc/os-release ]]; then+ . /etc/os-release 2>/dev/null || true+ case "${ID:-}" in+ ubuntu|debian|linuxmint) DISTRO="debian";;+ fedora|rhel|centos|rocky|almalinux|openeuler) DISTRO="rhel";;+ esac+ fi+ if command -v apt &>/dev/null; then+ DISTRO="debian"+ elif command -v dnf &>/dev/null || command -v yum &>/dev/null; then+ DISTRO="rhel"+ fi+}++# ─── Environment checks ───++check_python() {+ local py="${OPENVIKING_PYTHON:-python3}"+ local out+ if ! out=$("$py" -c "import sys; print(f'{sys.version_info.major}.{sys.version_info.minor}')" 2>/dev/null); then+ echo "fail|$py|$(tr "Python not found. Install Python >= 3.10." "Python 未找到,请安装 Python >= 3.10")"+ return 1+ fi+ local major minor+ IFS=. read -r major minor <<< "$out"+ if [[ "$major" -lt 3 ]] || [[ "$major" -eq 3 && "$minor" -lt 10 ]]; then+ echo "fail|$out|$(tr "Python $out is too old. Need >= 3.10." "Python 版本 $out 过低,需要 >= 3.10")"+ return 1+ fi+ echo "ok|$out|$py"+ return 0+}++check_node() {+ local out+ if ! out=$(node -v 2>/dev/null); then+ echo "fail||$(tr "Node.js not found. Install Node.js >= 22." "Node.js 未找到,请安装 Node.js >= 22")"+ return 1+ fi+ local v="${out#v}"+ local major+ major="${v%%.*}"+ if [[ -z "$major" ]] || [[ "$major" -lt 22 ]]; then+ echo "fail|$out|$(tr "Node.js $out is too old. Need >= 22." "Node.js 版本 $out 过低,需要 >= 22")"+ return 1+ fi+ echo "ok|$out|node"+ return 0+}++# Print guidance for missing dependencies+print_install_hints() {+ local missing=("$@")+ bold "\n═══════════════════════════════════════════════════════════"+ bold " $(tr "Environment check failed. Install missing dependencies first:" "环境校验未通过,请先安装以下缺失组件:")"+ bold "═══════════════════════════════════════════════════════════\n"++ for item in "${missing[@]}"; do+ local name="${item%%|*}"+ local rest="${item#*|}"+ err "$(tr "Missing: $name" "缺失: $name")"+ [[ -n "$rest" ]] && echo " $rest"+ echo ""+ done++ detect_distro+ echo "$(tr "Based on your system ($DISTRO), you can run:" "根据你的系统 ($DISTRO),可执行以下命令安装:")"+ echo ""++ if printf '%s\n' "${missing[@]}" | grep -q "Python"; then+ echo " # $(tr "Install Python 3.10+ (pyenv recommended)" "安装 Python 3.10+(推荐 pyenv)")"+ echo " curl https://pyenv.run | bash"+ echo " export PATH=\"\$HOME/.pyenv/bin:\$PATH\""+ echo " eval \"\$(pyenv init -)\""+ echo " pyenv install 3.11.12"+ echo " pyenv global 3.11.12"+ echo " python3 --version # $(tr "verify >= 3.10" "确认 >= 3.10")"+ echo ""+ fi++ if printf '%s\n' "${missing[@]}" | grep -q "Node"; then+ echo " # $(tr "Install Node.js 22+ (nvm)" "安装 Node.js 22+(nvm)")"+ echo " curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash"+ echo " source ~/.bashrc"+ echo " nvm install 22"+ echo " nvm use 22"+ echo " node -v # $(tr "verify >= v22" "确认 >= v22")"+ echo ""+ fi++ bold "$(tr "After installation, rerun this script." "安装完成后,请重新运行本脚本。")"+ bold "$(tr "See details: https://github.com/${REPO}/blob/${BRANCH}/examples/openclaw-memory-plugin/INSTALL.md" "详细说明见: https://github.com/${REPO}/blob/${BRANCH}/examples/openclaw-memory-plugin/INSTALL-ZH.md")"+ echo ""+ exit 1+}++# Validate environment+validate_environment() {+ info "$(tr "Checking OpenViking runtime environment..." "正在校验 OpenViking 运行环境...")"+ echo ""++ local missing=()+ local r++ r=$(check_python) || missing+=("Python 3.10+ | $(echo "$r" | cut -d'|' -f3)")+ if [[ "${r%%|*}" == "ok" ]]; then+ info " Python: $(echo "$r" | cut -d'|' -f2) ✓"+ fi++ r=$(check_node) || missing+=("Node.js 22+ | $(echo "$r" | cut -d'|' -f3)")+ if [[ "${r%%|*}" == "ok" ]]; then+ info " Node.js: $(echo "$r" | cut -d'|' -f2) ✓"+ fi++ if [[ ${#missing[@]} -gt 0 ]]; then+ echo ""+ print_install_hints "${missing[@]}"+ fi++ echo ""+ info "$(tr "Environment check passed ✓" "环境校验通过 ✓")"+ echo ""+}++# ─── Install flow ───++install_openclaw() {+ if [[ "$SKIP_OC" == "1" ]]; then+ info "$(tr "Skipping OpenClaw check (SKIP_OPENCLAW=1)" "跳过 OpenClaw 校验 (SKIP_OPENCLAW=1)")"+ return 0+ fi+ info "$(tr "Checking OpenClaw..." "正在校验 OpenClaw...")"+ if command -v openclaw >/dev/null 2>&1; then+ info "$(tr "OpenClaw detected ✓" "OpenClaw 已安装 ✓")"+ return 0+ fi++ err "$(tr "OpenClaw not found. Install it manually, then rerun this script." "未检测到 OpenClaw,请先手动安装后再执行本脚本")"+ echo ""+ echo "$(tr "Recommended command:" "推荐命令:")"+ echo " npm install -g openclaw --registry ${NPM_REGISTRY}"+ echo ""+ echo "$(tr "If npm global install fails, install Node via nvm and retry." "如 npm 全局安装失败,建议先用 nvm 安装 Node 后再执行上述命令。")"+ echo "$(tr "After installation, run:" "安装完成后,运行:")"+ echo " openclaw --version"+ echo " openclaw onboard"+ echo ""+ exit 1+}++install_openviking() {+ if [[ "$SKIP_OV" == "1" ]]; then+ info "$(tr "Skipping OpenViking install (SKIP_OPENVIKING=1)" "跳过 OpenViking 安装 (SKIP_OPENVIKING=1)")"+ return 0+ fi+ info "$(tr "Installing OpenViking from PyPI..." "正在安装 OpenViking (PyPI)...")"+ info "$(tr "Using pip index: ${PIP_INDEX_URL}" "使用 pip 镜像源: ${PIP_INDEX_URL}")"+ python3 -m pip install --upgrade pip -q -i "${PIP_INDEX_URL}"+ python3 -m pip install openviking -i "${PIP_INDEX_URL}" || {+ err "$(tr "OpenViking install failed. Check Python version (>=3.10) and pip." "OpenViking 安装失败,请检查 Python 版本 (需 >= 3.10) 及 pip")"+ exit 1+ }+ info "$(tr "OpenViking installed ✓" "OpenViking 安装完成 ✓")"+}++configure_openviking_conf() {+ mkdir -p "${OPENVIKING_DIR}"++ local workspace="${OPENVIKING_DIR}/data"+ local server_port="${DEFAULT_SERVER_PORT}"+ local agfs_port="${DEFAULT_AGFS_PORT}"+ local vlm_model="${DEFAULT_VLM_MODEL}"+ local embedding_model="${DEFAULT_EMBED_MODEL}"+ local vlm_api_key="${OPENVIKING_VLM_API_KEY:-${OPENVIKING_ARK_API_KEY:-}}"+ local embedding_api_key="${OPENVIKING_EMBEDDING_API_KEY:-${OPENVIKING_ARK_API_KEY:-}}"+ local conf_path="${OPENVIKING_DIR}/ov.conf"+ local vlm_api_json="null"+ local embedding_api_json="null"++ if [[ "$INSTALL_YES" != "1" ]]; then+ echo ""+ read -r -p "$(tr "OpenViking workspace path [${workspace}]: " "OpenViking 数据目录 [${workspace}]: ")" _workspace < /dev/tty || true+ read -r -p "$(tr "OpenViking HTTP port [${server_port}]: " "OpenViking HTTP 端口 [${server_port}]: ")" _server_port < /dev/tty || true+ read -r -p "$(tr "AGFS port [${agfs_port}]: " "AGFS 端口 [${agfs_port}]: ")" _agfs_port < /dev/tty || true+ read -r -p "$(tr "VLM model [${vlm_model}]: " "VLM 模型 [${vlm_model}]: ")" _vlm_model < /dev/tty || true+ read -r -p "$(tr "Embedding model [${embedding_model}]: " "Embedding 模型 [${embedding_model}]: ")" _embedding_model < /dev/tty || true+ echo "$(tr "VLM and Embedding API keys can differ. You can leave either empty and edit ov.conf later." "说明:VLM 与 Embedding 的 API Key 可能不同,可分别填写;留空后续可在 ov.conf 修改。")"+ read -r -p "$(tr "VLM API key (optional): " "VLM API Key(可留空): ")" _vlm_api_key < /dev/tty || true+ read -r -p "$(tr "Embedding API key (optional): " "Embedding API Key(可留空): ")" _embedding_api_key < /dev/tty || true++ workspace="${_workspace:-$workspace}"+ server_port="${_server_port:-$server_port}"+ agfs_port="${_agfs_port:-$agfs_port}"+ vlm_model="${_vlm_model:-$vlm_model}"+ embedding_model="${_embedding_model:-$embedding_model}"+ vlm_api_key="${_vlm_api_key:-$vlm_api_key}"+ embedding_api_key="${_embedding_api_key:-$embedding_api_key}"+ fi++ if [[ -n "${vlm_api_key}" ]]; then+ vlm_api_json="\"${vlm_api_key}\""+ fi+ if [[ -n "${embedding_api_key}" ]]; then+ embedding_api_json="\"${embedding_api_key}\""+ fi++ mkdir -p "${workspace}"+ cat > "${conf_path}" <<EOF+{+ "server": {+ "host": "127.0.0.1",+ "port": ${server_port},+ "root_api_key": null,+ "cors_origins": ["*"]+ },+ "storage": {+ "workspace": "${workspace}",+ "vectordb": { "name": "context", "backend": "local", "project": "default" },+ "agfs": { "port": ${agfs_port}, "log_level": "warn", "backend": "local", "timeout": 10, "retry_times": 3 }+ },+ "embedding": {+ "dense": {+ "backend": "volcengine",+ "api_key": ${embedding_api_json},+ "model": "${embedding_model}",+ "api_base": "https://ark.cn-beijing.volces.com/api/v3",+ "dimension": 1024,+ "input": "multimodal"+ }+ },+ "vlm": {+ "backend": "volcengine",+ "api_key": ${vlm_api_json},+ "model": "${vlm_model}",+ "api_base": "https://ark.cn-beijing.volces.com/api/v3",+ "temperature": 0.1,+ "max_retries": 3+ }+}+EOF+ SELECTED_SERVER_PORT="${server_port}"+ info "$(tr "Config generated: ${conf_path}" "已生成配置: ${conf_path}")"+}++download_plugin() {+ local gh_raw="https://raw.githubusercontent.com/${REPO}/${BRANCH}"+ local files=(+ "examples/openclaw-memory-plugin/index.ts"+ "examples/openclaw-memory-plugin/config.ts"+ "examples/openclaw-memory-plugin/openclaw.plugin.json"+ "examples/openclaw-memory-plugin/package.json"+ "examples/openclaw-memory-plugin/package-lock.json"+ "examples/openclaw-memory-plugin/.gitignore"+ )++ mkdir -p "${PLUGIN_DEST}"+ info "$(tr "Downloading memory-openviking plugin..." "正在下载 memory-openviking 插件...")"+ info "$(tr "Plugin source: ${REPO}@${BRANCH}" "插件来源: ${REPO}@${BRANCH}")"+ for rel in "${files[@]}"; do+ local name="${rel##*/}"+ local url="${gh_raw}/${rel}"+ curl -fsSL -o "${PLUGIN_DEST}/${name}" "${url}" || {+ err "$(tr "Download failed: ${url}" "下载失败: ${url}")"+ exit 1+ }+ done+ (cd "${PLUGIN_DEST}" && npm install --no-audit --no-fund) || {+ err "$(tr "Plugin dependency install failed: ${PLUGIN_DEST}" "插件依赖安装失败: ${PLUGIN_DEST}")"+ exit 1+ }+ info "$(tr "Plugin deployed: ${PLUGIN_DEST}" "插件部署完成: ${PLUGIN_DEST}")"+}++configure_openclaw_plugin() {+ local server_port="${SELECTED_SERVER_PORT}"+ local config_path="~/.openviking/ov.conf"+ info "$(tr "Configuring OpenClaw plugin..." "正在配置 OpenClaw 插件...")"++ openclaw config set plugins.enabled true+ openclaw config set plugins.allow '["memory-openviking"]' --json+ openclaw config set gateway.mode local+ openclaw config set plugins.slots.memory memory-openviking+ openclaw config set plugins.load.paths "[\"${PLUGIN_DEST}\"]" --json+ openclaw config set plugins.entries.memory-openviking.config.mode local+ openclaw config set plugins.entries.memory-openviking.config.configPath "${config_path}"+ openclaw config set plugins.entries.memory-openviking.config.port "${server_port}"+ openclaw config set plugins.entries.memory-openviking.config.targetUri viking://+ openclaw config set plugins.entries.memory-openviking.config.autoRecall true --json+ openclaw config set plugins.entries.memory-openviking.config.autoCapture true --json+ info "$(tr "OpenClaw plugin configured" "OpenClaw 插件配置完成")"+}++write_openviking_env() {+ local py_path+ py_path="$(command -v python3 || command -v python || true)"+ mkdir -p "${OPENCLAW_DIR}"+ cat > "${OPENCLAW_DIR}/openviking.env" <<EOF+export OPENVIKING_PYTHON='${py_path}'+EOF+ info "$(tr "Environment file generated: ${OPENCLAW_DIR}/openviking.env" "已生成环境文件: ${OPENCLAW_DIR}/openviking.env")"+}++# ─── 主流程 ───++main() {+ echo ""+ bold "$(tr "🦣 OpenClaw + OpenViking Installer" "🦣 OpenClaw + OpenViking 一键安装")"+ echo ""++ detect_os+ validate_environment++ install_openclaw+ install_openviking+ configure_openviking_conf+ download_plugin+ configure_openclaw_plugin+ write_openviking_env++ echo ""+ bold "═══════════════════════════════════════════════════════════"+ bold " $(tr "Installation complete!" "安装完成!")"+ bold "═══════════════════════════════════════════════════════════"+ echo ""+ info "$(tr "Run these commands to start OpenClaw + OpenViking:" "请按以下命令启动 OpenClaw + OpenViking:")"+ echo " 1) openclaw --version"+ echo " 2) openclaw onboard"+ echo " 3) source ${OPENCLAW_DIR}/openviking.env && openclaw gateway"+ echo " 4) openclaw status"+ echo ""+ info "$(tr "You can edit the config freely: ${OPENVIKING_DIR}/ov.conf" "你可以按需自由修改配置文件: ${OPENVIKING_DIR}/ov.conf")"+ echo ""+}++main "$@"