以下是完整的部署指南，适合发博客：

---

OpenClaw 本地部署踩坑记录：极简桌面文件整理方案

前言

出于安全性考虑，我只想让 AI 在本地帮我整理桌面文件，不打算拓展任何联网功能（不接入聊天工具、不用 Web 搜索、不连接第三方服务）。本文记录从下载源码压缩包踩坑，到最终成功部署的极简方案。

---

一、环境准备

1.1 安装 Node.js

• 版本要求：v18+（推荐 v22）
• 下载地址：https://nodejs.org/zh-cn
• 验证安装：

node -v    # 应显示 v18.x.x 或更高
npm -v     # 应显示 9.x.x 或更高

1.2 安装 Git

• 下载地址：https://git-scm.com/download/win
• 验证安装：

git --version

---

二、踩坑记录：源码压缩包安装失败

2.1 错误尝试（别学我）

一开始从官网下载了 openclaw-2026.3.13-1 压缩包，想着本地解压就能用：

cd openclaw-2026.3.13-1
npm link
openclaw --version

报错：

Error: openclaw: missing dist/entry.(m)js (build output)

2.2 错误原因

下载的是源码包（Source Code），不是预编译的发行版。缺少 dist 文件夹（存放编译后的文件），需要先构建才能运行。

2.3 源码包的正确打开方式（可选）

如果坚持用源码包，需要先构建：

cd openclaw-2026.3.13-1
npm install      # 安装依赖
npm run build    # 构建项目（生成 dist 文件夹）
npm link         # 创建全局链接
openclaw --version

但推荐直接用 npm 安装，更简单！

---

三、正确安装方式：npm 全局安装

以管理员身份运行 PowerShell，执行：

npm install -g openclaw@latest clawhub@latest --unsafe-perm

验证安装：

openclaw --version
# 应显示：OpenClaw 2026.3.13 (61d171a)

---

四、初始化配置（极简安全版）

4.1 启动配置向导

openclaw onboard

4.2 配置选项（全部最小化）

步骤	选项	理由
免责声明	yes	必须接受
配置模式	QuickStart	快速启动
AI 模型	MiniMax	国内可用，无需翻墙
认证方式	MiniMax CN — OAuth	Coding plan 用户选这个
模型版本	MiniMax-M2.5-highspeed	极速版专属
聊天工具	Skip for now	❌ 不接入任何聊天平台
Web 搜索	Skip for now	❌ 不让 AI 联网搜索
配置 Skills	Yes	必须开启，要装文件整理
依赖安装	Skip for now	❌ 跳过所有额外依赖
Hooks	session-memory	✅ 只开这个，保存会话状态
启动方式	Hatch in TUI	本地终端交互

4.3 所有 API Key 一律选 No

以下全部跳过，不连接任何外部服务：

• GOOGLE_PLACES_API_KEY → ❌ No
• GEMINI_API_KEY → ❌ No
• NOTION_API_KEY → ❌ No
• OPENAI_API_KEY (image-gen) → ❌ No
• OPENAI_API_KEY (whisper) → ❌ No
• ELEVENLABS_API_KEY → ❌ No

原则：只留本地文件操作能力，其他一律关闭。

---

五、启动服务

配置完成后，启动网关服务：

openclaw gateway start

浏览器自动打开本地地址：http://127.0.0.1:18789/chat

---

六、使用 OpenClaw 整理桌面文件

在 Web 界面底部输入框输入指令：

指令示例	功能
"整理我的桌面，按文件类型分类"	自动分类所有文件
"把桌面上的图片移到图片文件夹"	移动特定类型文件
"清理桌面，删除所有临时文件"	删除垃圾文件
"按日期整理桌面文件"	时间归档

---

七、完整问题汇总

Q1：源码压缩包安装报错 missing dist/entry.(m)js

原因：下载的是未编译的源码包，缺少构建产物
解决：要么执行 npm run build 自行构建，要么直接用 npm install -g openclaw@latest 安装（推荐后者）

Q2：--unsafe-perm 参数警告

现象：npm warn Unknown cli config "--unsafe-perm"
解决：可忽略，或去掉该参数重新安装

Q3：安装依赖时要求至少选一个

现象：Please select at least one option
解决：按空格选中 Skip for now，或随便选一个然后回车

Q4：如何确认 file-organizer 技能已安装？

解决：在 Web 界面输入 "你能做什么？" 查看支持的功能，或手动安装：

clawhub install file-organizer
openclaw skills enable file-organizer

Q5：如何重启服务？

openclaw gateway restart

---

八、总结：我的极简安全策略

功能	我的选择	理由
AI 模型	MiniMax M2.5	国内可用，速度快
聊天工具	❌ 跳过	不暴露到任何平台
Web 搜索	❌ 跳过	不让 AI 联网
第三方 API	❌ 全部跳过	不连接外部服务
技能依赖	❌ 跳过	减少攻击面
本地 Hooks	✅ session-memory	只保留会话记忆

关键教训

1. 不要直接下载源码压缩包安装，除非你是开发者
2. npm 全局安装 是一键到位的正确姿势
3. 配置时大胆跳过，只留最核心的本地文件整理功能
4. 安全性优先：不联网、不接入第三方、最小权限原则

现在可以用自然语言让 AI 在完全本地、隔离的环境下帮我整理桌面了，既方便又安心！

---

参考链接

• OpenClaw 官网：https://openclaw.ai
• GitHub：https://github.com/stackblitz-labs/openclaw
• 官方文档：https://docs.openclaw.ai