乐于分享
好东西不私藏

�� OpenClaw 最全安装调试教程:从安装前注意 → 安全人设 → 实战案例 → 工具对比

�� OpenClaw 最全安装调试教程:从安装前注意 → 安全人设 → 实战案例 → 工具对比

导语:AI 圈这段时间最火的词,不是某个大模型,而是——OpenClaw(江湖人称"小龙虾"🦞)。它让 AI 从"只会聊天"变成了"真的能帮你干活":自动写代码、自动搜资料、自动整理文件……这篇文章把网上最靠谱的教程整合在一起,一篇读完,直接上手。

️ 一、安装前必读:这些坑先看

OpenClaw 到底是什么?OpenClaw 是一个开源 AI 智能体框架,基于 Claude Code 底层能力构建,支持接入多种大模型(含国内 GLM、Qwen、DeepSeek 等)。核心能力:完整文件系统访问 · 执行 Shell 命令 · 网页浏览检索 · 多 Agent 自动化工作流。

️ 高权限警告OpenClaw 相当于把 AI 的手伸进了你的电脑。权限很高,必须谨慎配置,安装前注意事项不要跳过。 

5 个安装前必知事项:

·🛡️ 不要在主力机直接裸跑——第一次体验,建议先用虚拟机、旧电脑或独立 Windows 账号测试

·🌐确认网络环境——用官方 Claude 模型需科学上网;接入 DeepSeek/GLM 等国内模型可直连

·📦检查 Node.js 版本——官方要求 Node 24(推荐),最低 Node 22.16+,先运行 node -v 确认

·🪟Windows 用户额外注意——需开放 PowerShell 执行策略,官方推荐用 WSL2 安装,兼容性最佳

·🚫不要用第三方一键镜像——VPS 部署请用干净的基础 OS 镜像(如 Ubuntu 22.04)

💻 二、安装 OpenClaw(全平台步骤)

方式一:官方一键脚本(推荐大多数人)脚本自动检测安装 Node、完成初始化引导,最省心。

macOS / Linux:

curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard

Windows PowerShell(管理员权限):

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
irm https://openclaw.ai/install.ps1 | iex
openclaw onboard

方式二:npm 全局安装

npm config set registry https://registry.npmmirror.com
npm install -g @openclaw/cli
openclaw onboard

方式三:WSL2 安装(Windows 强烈推荐)

# PowerShell 中启用 WSL2
wsl --install
# 重启后在 WSL Ubuntu 终端执行
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard

 安装验证:运行 openclaw --version,看到版本号和小龙虾 🦞 图案,安装成功! 

🔒 三、安全设置:装完必做,别跳过

1. 配置操作权限白名单在项目根目录或全局配置文件中,把 AI 的操作范围锁定在你的工作目录内:

permissions:
allow:
-read: "~/projects/**"# 只读写项目目录
-write: "~/projects/**"
deny:
-read: "~/.ssh/**"# 禁止碰 SSH 密钥
-write: "/etc/**"# 禁止写系统目录
-execute: "rm -rf"# 禁止危险命令

2. 网关访问控制(VPS 部署必配)

gateway:
port:3000
allowFrom:
-"127.0.0.1"# 只允许本地访问
dmPolicy:"closed"# 关闭陌生人访问

🔑 API Key 安全三原则

·永远不要把 Key 硬编码在配置文件里传到 GitHub

·用环境变量存储:export OPENCLAW_API_KEY="your_key"

·为 OpenClaw 单独建一个 Key,随时可吊销不影响其他服务

🎭 四、人设调试:让 AI 变成你的样子

CLAUDE.md 是什么?CLAUDE.md 是放在项目根目录的特殊文件,相当于给 OpenClaw 注入"灵魂"的全局系统提示词。每次启动 AI 都会自动读取,作为行为准则。

人设配置模板(直接可用)

## 角色定义
你是一位专业全栈工程师,同时是高效工作助理。
## 行为准则
- 每次操作前先简要说明要做什么
- 遇到不确定的事情,先问我再动手
- 最小化改动范围,保留原有逻辑
- 使用中文回复,代码注释也用中文
## 禁止事项
- 不得删除任何文件,除非我明确要求
- 不得修改 .env 和核心配置文件
## 工作风格
- 输出简洁,避免啰嗦
- 遇到报错先自主尝试解决

💡 进阶技巧:为不同项目建不同 CLAUDE.md,实现"写代码模式"/"整理文件模式"/"调研模式"自由切换。在文件里加入项目背景和技术栈说明,让 AI 每次都"记得"你的项目情况。 

🚀 五、3 个简单上手案例

1. 自动整理桌面文件夹

"我的 Desktop/混乱文件夹 里有各种文件,请按文件类型(图片/文档/视频/其他)分类整理到子文件夹,整理前先列出计划,等我确认后再执行。"

 效果:AI 先展示整理方案等你审核,确认后自动创建文件夹并移动文件,全程透明可控,零风险。

2. 自动批量处理 Excel 数据

"我的项目目录下有 sales_data.xlsx,里面有销售额列,请帮我计算每月总额、找出前5名,把结果输出成新文件 sales_summary.xlsx。"

 效果:AI 自动调用脚本处理数据,几十秒内生成结果文件,不需要你写一行代码

3. 一键搭建项目脚手架

"帮我创建一个 React + TypeScript + Vite + Tailwind CSS 的前端项目,配好 ESLint 和 Prettier,创建示例 Hello World 页面,配置文件用中文注释。"

 效果:AI 自动执行一系列命令,从创建项目到安装依赖、写配置、生成示例页面,一条指令全搞定

🔍 六、横向对比:主流"小龙虾"工具

2026年,以 OpenClaw 为底座衍生出了一批国产 AI 智能体产品,下面重点比较最常见的几款:

对比维度

OpenClaw

KimiClaw

WorkBuddy

QClaw

开发方

开源社区

Moonshot AI

腾讯云

腾讯

是否开源

 完全开源

 商业

 商业

 商业

底层模型

Claude/多模型

Kimi 大模型

混元/多模型

混元/多模型

国内直连

️ 需配国内模型

 开箱即用

 开箱即用

 开箱即用

上手难度

⭐⭐⭐ 中等

⭐⭐ 较易

⭐⭐ 较易

⭐⭐ 较易

自定义能力

⭐⭐⭐⭐⭐ 极强

⭐⭐⭐ 中等

⭐⭐⭐ 中等

⭐⭐⭐ 中等

数据隐私

 完全本地

️ 数据上云

️ 数据上云

️ 数据上云

价格

免费(API自付)

按量付费

免费额度+付费

免费额度+付费

怎么选?一句话建议:

🧑💻开发者 / 折腾党 → OpenClaw完全开源,自由度最高,可接任意模型,数据隐私最安全

📱普通用户 / 快速上手 → KimiClaw 或 WorkBuddy开箱即用,中文优化好,不用自己配置环境

🏢腾讯生态用户 → QClaw 或 WorkBuddy与企业微信、腾讯会议、腾讯文档等集成更顺畅

🔒数据隐私敏感 → OpenClaw(本地部署)数据完全在本地,不经过任何云端服务器

🦞

OpenClaw 的出现代表着 AI 进入新阶段——          "问答机器人""真正能动手干活的智能体"

安装它不难,难的是学会安全地用好它。          先从案例一(整理文件夹)开始试试吧!

觉得有用?转发给朋友 👇

关注我们,持续更新最实用的 AI 工具教程~