2026 OpenClaw（小龙虾）本地部署教程：安全警示 + 沙盒虚拟机安装指南

重要安全警示（必看！）：OpenClaw（小龙虾）具有极高的系统操作权限，可直接执行终端命令、读写本地文件、调用系统工具，非常危险。强烈不建议在个人本地物理机安装测试，避免因 AI 误操作、权限失控导致本地数据泄露、文件损坏、系统异常等严重问题；所有安装测试操作，务必在沙盒虚拟机中进行，隔离本地物理机环境，保障数据安全。

本文教程全程基于「沙盒虚拟机」环境编写，适配 Windows/macOS/Linux 全平台虚拟机，纯本地、无 API、全开源，附详细安装步骤 + 安全加固，运维 / 开发友好，重点规避安全风险。

一、OpenClaw 是什么

OpenClaw（曾用名 ClawdBot）是开源 AI 执行网关 / 智能体，核心是让大模型拥有 “手脚”—— 区别于普通聊天 AI，它能直接读写文件、执行终端命令、调用系统工具、自动完成各类操作，对接 Ollama 本地模型后可完全离线运行，2026 年 GitHub 星标破 19 万，被称为 “AI 数字员工”。

⚠️ 三大核心风险点（养龙虾必知）：

指令诱导风险：攻击者可通过提示词注入、隐藏恶意指令，诱导 AI 越权执行删除、外发数据等高危操作，无视安全限制。
配置缺陷风险：默认公网暴露、无认证、敏感信息明文存储、权限过宽，极易被远程接管。
信息泄露与系统受控风险：越权执行、凭证窃取、恶意插件投毒，可导致数据泄露、系统完全受控。

因此，沙盒虚拟机是唯一安全的测试环境。

二、核心优势（为什么选它，明确适用场景）

真执行：不只是对话，能自动完成系统操作、文件处理、命令执行，而非单纯输出指令；
全本地：对接 Ollama 本地模型，无需依赖云 API、无流量费，数据 100% 本地存储（仅限沙盒环境）；
运维友好：可直接执行 Linux/Windows 命令、排查服务器问题（测试环境下）；
安全可控：支持权限隔离、操作审计，在沙盒环境中可进一步限制其操作范围，降低风险。

三、前置准备（沙盒虚拟机优先，必做）

1. 沙盒虚拟机环境准备（核心！）

推荐使用以下虚拟机工具，创建独立沙盒环境，与本地物理机完全隔离，避免风险：

虚拟机工具：VMware Workstation（Windows/macOS）、VirtualBox（免费，全平台）、Parallels Desktop（macOS）；
虚拟机系统：推荐 Ubuntu 22.04（最稳定，适配 OpenClaw）、Windows 11（测试 Windows 环境）；
虚拟机配置：内存≥16GB、显存≥4GB、磁盘≥50GB（用于存储模型和工具）；
关键设置：关闭虚拟机与物理机的文件共享、剪切板共享，避免 AI 误操作影响本地物理机。

2. 硬件 / 软件基础要求（虚拟机内配置）

基础软件：Node.js 22+（OpenClaw 运行必备）、Ollama（本地模型引擎，必装）；
内存≥16GB、显存≥4GB（跑 4B 模型，7B 模型需 8GB + 显存）；
网络：虚拟机需联网（用于下载安装包和模型），测试完成后可断网离线使用。

3. 推荐本地模型（中文 + 运维优先，虚拟机内使用）

表格

模型	大小	显存要求	适用场景（沙盒测试）
qwen2.5:4b	4GB	4GB+	简单命令执行、文件操作测试
qwen2.5:7b	7GB	8GB+	复杂推理、代码测试、运维命令测试
deepseek-r1:7b	7GB	8GB+	逻辑推理、任务规划测试

四、沙盒虚拟机内安装教程（全平台，保姆级）

第一步：安装 Node.js（必备，全平台通用）

访问 Node.js 官网，下载「LTS 22.x」版本（对应虚拟机系统）；
Windows 虚拟机：双击安装包，勾选「Add to PATH」，一路下一步，完成后重启终端；
macOS/Linux 虚拟机：按官网对应系统的安装指令执行（Linux 可通过 apt/yum 安装，macOS 可通过 brew 安装）；
验证安装：打开虚拟机终端，输入以下命令，显示版本号即成功：bash运行node -v npm -v

第二步：安装 OpenClaw（虚拟机内执行）

以管理员 /root 权限打开虚拟机终端，执行以下命令，一键安装：

# 全局安装OpenClaw（全平台通用命令）
npm install -g openclaw

# 验证安装是否成功
openclaw --version

显示版本号（如 openclaw 0.12.0），说明安装成功；若提示权限不足，Windows 虚拟机以管理员身份运行终端，Linux/macOS 虚拟机在命令前加 sudo。

第三步：安装 Ollama（本地模型引擎，必装）

1. Windows 虚拟机

powershell

# 命令行一键安装Ollama
iwr -useb https://ollama.com/install.ps1 | iex

2. macOS 虚拟机

# 用brew安装（需先安装brew）
brew install ollama

3. Linux 虚拟机（Ubuntu/Debian）

# 一键安装Ollama
curl -fsSL https://ollama.com/install.sh | sh

4. 拉取本地模型（虚拟机内执行）

安装完成后，拉取推荐的中文模型（以 qwen2.5:4b 轻量版为例，适合测试）：

ollama pull qwen2.5:4b

模型下载速度取决于网络，下载完成后会自动缓存，下次可直接调用；若虚拟机配置较低，优先选择 4B 轻量版，避免显存不足。

第四步：初始化 OpenClaw（关键配置，虚拟机内执行）

初始化是核心步骤，将 OpenClaw 与 Ollama 本地模型对接，同时配置基础权限（务必按以下步骤操作，降低风险）：

# 启动OpenClaw配置向导（管理员/root权限）
openclaw onboard --install-daemon

按向导提示逐步操作，重点配置如下（规避风险）：

出现风险提示，仔细阅读后选择「Yes」（确认已在沙盒虚拟机中操作）；
选择「QuickStart」快速配置（适合测试，无需复杂设置）；
Model Provider（模型提供商）选择「Ollama」（本地模型，避免联网风险）；
输入 Ollama 地址：默认 http://localhost:11434（无需修改，虚拟机内默认地址）；
选择模型：优先选「qwen2.5:4b」（轻量、低配置、风险更低）；
聊天渠道：选择「TUI」（终端界面，仅在虚拟机内交互，避免外部接入风险）；
技能配置：暂时只勾选「文件管理、基础命令执行」，取消「系统重启、权限修改」等高危技能；
等待配置完成，系统会自动启动 OpenClaw 后台服务。

第五步：启动 OpenClaw（虚拟机内测试）

配置完成后，在虚拟机终端执行以下命令，启动并进入交互界面：

# 启动OpenClaw后台服务
openclaw start

# 进入终端交互界面
openclaw chat

出现 🦞 > 提示符，说明启动成功；此时可进行简单测试（仅限虚拟机内操作），测试完成后及时关闭服务，避免长期运行带来风险。

五、安全加固（必做！进一步降低沙盒内风险）

即使在沙盒虚拟机中，也需进行权限限制，避免 OpenClaw 执行高危操作，步骤如下：

找到 OpenClaw 配置文件：路径为 ~/.openclaw/openclaw.json（虚拟机内）；
编辑配置文件，添加以下权限限制（复制粘贴到对应位置）：json{ "filesystem": { "allowedPaths": ["/home/user/test", "/tmp"], // 仅允许访问测试目录和临时目录 "blockedPaths": ["/", "/etc", "/root", "/home/user"] // 禁止访问系统核心目录 }, "commands": { "allowed": ["ls", "ps", "df", "grep", "pwd"], // 仅允许执行安全命令 "blocked": ["rm", "sudo", "chmod", "chown", "reboot", "shutdown"] // 禁止高危命令 }, "audit": { "enabled": true, "logPath": "~/.openclaw/audit.log" // 开启操作审计，记录所有AI执行行为 } }
保存配置文件，重启 OpenClaw 服务生效：bash运行openclaw restart

⚠️ 补充提醒：测试完成后，建议及时关闭 OpenClaw 服务，若无需继续测试，可卸载 OpenClaw 和 Ollama，避免虚拟机内残留风险。

六、常见问题（避坑指南，沙盒环境专属）

Ollama 连接失败：检查 Ollama 是否启动（执行 ollama serve），确认虚拟机内端口 11434 未被占用；
模型加载慢 / 显存不足：换 qwen2.5:4b 轻量版，关闭虚拟机内其他占用内存、显存的软件；
权限不足：Windows 虚拟机以管理员身份运行终端，Linux/macOS 虚拟机加 sudo 执行命令；
配置文件修改后不生效：重启 OpenClaw 服务，若仍无效，重新执行初始化向导；
风险防控：严禁在虚拟机内存放敏感数据，测试完成后及时清理虚拟机环境。

七、总结

OpenClaw（小龙虾）是一款功能强大的 AI 执行智能体，能让大模型真正 “动手” 操作系统，但安全风险极高，务必牢记：

❌ 严禁在个人本地物理机安装测试，避免数据泄露、系统异常；
✅ 所有安装、测试操作，必须在沙盒虚拟机中进行，与本地物理机完全隔离；
✅ 安装后务必做安全加固，限制操作权限、开启审计日志，降低 AI 误操作风险。