这不是那种“3 分钟速成”爽文,是真从零开始,一步步带你把 OpenClaw 跑起来的保姆级教程。OpenClaw(昵称“龙虾AI”)作为2026年热门的开源个人AI助手,由PSPDFKit创始人Peter Steinberger开发,核心优势在于“真正执行任务”——不仅能聊天互动,还能自动处理邮件、管理日程、订机票、写代码等,且所有数据本地处理,隐私完全可控。
阿里云OpenClaw部署专题:点击直达
腾讯云OpenClaw部署专题:点击直达
京东云OpenClaw部署专题:点击直达
优刻得OpenClaw部署专题:点击直达
OpenClaw 能直接操作你电脑 / 服务器上的文件和命令,权限很大,用不好 = 给陌生人一把家门钥匙。
安全部分我会反复啰嗦,嫌烦可以跳过,但后果自负。
全文会有不少命令和配置,建议先收藏,再边看边实操。
一、先说结论:OpenClaw 到底是啥?
OpenClaw = 本地运行 + 能“真动手”的 AI 管家,不是只会聊天的那种。
官方定义:开源、自托管的个人 AI 助手,支持 WhatsApp、Telegram 、Slack、Discord、飞书、钉钉等一堆平台,你自己的设备上跑,数据不出你机器。
它能做的事:
读 / 写你电脑里的文件
执行 Shell 命令、脚本
帮你收发邮件、管理日程
定时跑任务、整理资料、写代码片段……
所以它最近在 GitHub 上直接飙到 24 万+ star,是这几年增长最快的开源 AI 项目之一。
openclaw GitHub地址
打个比方:
ChatGPT 是一个“只会嘴上说的顾问”,
OpenClaw 是一个“能直接帮你搬砖、填表、发邮件的实习生”。
二、适合谁?不适合谁?
有点命令行基础(能照着敲命令就行)。
想要:
自动整理本地文件 / 邮件 / 日程
定时跑一些“机器人任务”
自己掌控数据,不想再被第三方 SaaS 收割隐私
不太适合
完全不愿意打开终端 / PowerShell 的纯小白。
对“安全风险”毫无概念,又不打算学习隔离权限的人。
用一个流程图先给你建立整体概念(不用管细节,心里有个数就行):
三、先看一眼全局:你要做的大致流程
flowchart LR
A[准备一台电脑 / 服务器] --> B[安装 Node.js 和 Git]
B --> C[用一键脚本安装 OpenClaw]
C --> D[运行 openclaw onboard 配置向导]
D --> E[选择模型和平台]
E --> F[安装 Skills / 中国插件]
F --> G[启动并测试聊天]
G --> H[配置钉钉/飞书等国内平台]
H --> I[日常使用和维护]
————————————————
下面我们一步步来。
后面会频繁出现,先给你“翻译”一下:
四、名词速成:后面会反复出现的几个概念
Gateway(网关)
整个 OpenClaw 的“总管”,负责:
接收来自 Telegram / 飞书 / Web 等各处的消息
转发给 AI Agent 去处理
你本机上的 openclaw 命令,主要就是在启动这个网关。
Channels(通道)
各种聊天平台:Telegram、钉钉、飞书、企业微信、WebChat 等。
OpenClaw 就像“多口 USB Hub”,把所有平台统一成一个入口。
Skills(技能)
类似手机 App,比如:
文件整理 Skill
邮件管理 Skill
日历 Skill
社区已经有 5400+ Skills 可选。
Memory(记忆)
它会记住你之前的偏好、上下文,越用越“懂你”。
Sandbox(沙盒)
为了安全,建议先在“沙盒模式”下玩,限制它只能访问特定目录 / 命令,避免删光你硬盘。
五、硬件和环境要求
1、硬件
官方文档和社区实测:
- CPU:基本没什么要求,哪怕是老笔记本 / 廉价云服务器都行。
- 内存:最低 2GB 就能跑,但建议 ≥ 4GB,否则多个 Skill 一起上可能会有点卡。
- 磁盘:预留 10GB 比较稳妥(模型、日志、缓存会慢慢占空间)。
2、操作系统
支持三大平台:
macOS(Intel / Apple Silicon 都可以)
Linux (主流发行版:Ubuntu / Debian / CentOS 等)
Windows
官方推荐用 WSL2(Windows Subsystem for Linux)来跑,体验更稳。
也有纯 Windows 部署教程,但坑会多一点。
六、安装准备:Node.js + Git
- 安装 Node.js(≥ 22)
OpenClaw 是用 Node / TypeScript 写的,运行时依赖 Node.js ≥ 22。
去 Node.js 官网下载 LTS 版本:https://nodejs.org
安装时一路“下一步”,注意勾选:
Add to PATH(自动加环境变量)
验证安装:
node -v
建议看到 v22.x.x
npm -v
- 安装 Git
主要是为了拉取代码和部分 Skill 依赖。
官网下载:https://git-scm.com/
验证:
git –version
OpenClaw 提供了跨平台的一键脚本,会自动帮你装 Node、配置环境。
七、一键安装 OpenClaw(官方脚本)
- macOS / Linux
打开终端,执行:
curl -fsSL https://openclaw.ai/install.sh | bash
- Windows(PowerShell ,管理员模式)
以管理员身份打开 PowerShell,执行:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
iwr -useb https://openclaw.ai/install.ps1 | iex
说明:第一行命令是放开脚本执行权限,否则系统会拦住脚本运行。
脚本会:
检查 / 安装 Node.js ≥ 22
安装 openclaw 命令
帮你跑一遍基础配置向导
八、手动安装(备用方案)
如果一键脚本在你的网络环境下失败,可以用 npm / pnpm 手动装:
用 npm
npm install -g openclaw@latest
或用 pnpm(更快,更省空间)
pnpm add -g openclaw@latest
验证:
openclaw –version
openclaw –help
能看到版本号和帮助信息,就说明安装成功。
九、第一次配置:openclaw onboard
安装完,第一件事就是运行配置向导:
openclaw onboard
你也可以让它顺便装成后台服务(开机自启):
openclaw onboard –install-daemon
向导大致流程
不同版本界面会有点差异,但逻辑类似:
风险提示
提醒你这货权限很大,你要是给陌生人用,就是把自己的电脑拱手让人。
输入 yes 继续,no 就直接退出。
模式选择
QuickStart:新手建议选这个,自动配好一套默认值。
Advanced:老司机可以自己配端口、模型、权限等。
选择模型提供商(Model / Auth Provider)
这是 OpenClaw 的“大脑”,常见选择:
Qwen / 通义千问:国内网络友好,有免费额度,适合入门。
OpenAI / Anthropic / DeepSeek / Kimi 等:有对应账号 / API Key 就可以。
国内如果没有海外账号,优先选 Qwen、MiniMax、智谱等国产模型。
配置模型
按提示打开浏览器,登录对应平台,授权或复制 API Key。
向导会帮你写入配置文件 ~/.openclaw/openclaw.json。
选择通道(Channels)
海外:Telegram / WhatsApp / Discord / Slack 等。
国内:如果你要用钉钉 / 飞书 / 企业微信,这里可以先选“Skip for now”,后面再装中国插件。
安装基础 Skills
会问你要不要安装一些基础 Skills(文件操作、命令执行等)。
建议选 Yes,先装一套基础能力。
端口和其他配置
默认端口:18789(后面 Web UI 会用到)。
包管理器:npm / pnpm / bun,一般选 npm 就行。
十、启动并访问 Web 界面
配置完,就可以启动了:
启动网关(前台运行,方便看日志)
openclaw gateway
或后台运行(推荐先前台,确认正常后再后台)
openclaw gateway start
然后打开浏览器访问:
http://127.0.0.1:18789/chat
如果能看到一个聊天界面,并且你发一句“你好”,它能正常回复,恭喜你,OpenClaw 已经跑起来了。
十一、国内用户:接入钉钉 / 飞书 / 企业微信
官方 OpenClaw 主打海外平台,但国内有一个 openclaw-china 项目,专门支持钉钉、飞书、QQ、企业微信、微信等
- 安装中国插件(推荐)
安装统一包(包含所有国内渠道)
openclaw plugins install @openclaw-china/channels
运行交互式配置向导
openclaw china setup
或者只装单个渠道:
openclaw plugins install @openclaw-china/dingtalk
openclaw china setup
openclaw plugins install @openclaw-china/feishu-china
openclaw china setup
注意:Windows 上 npm 安装方式可能有兼容性问题,如果失败,可以用源码方式安装。
- 以钉钉为例(最简单)
钉钉是 openclaw-china 项目里配置最简单的之一:
在钉钉开放平台创建企业内部机器人 ,拿到:
clientId
clientSecret
执行:openclaw config set channels.dingtalk.enabled true
openclaw config set channels.dingtalk.clientId dingxxxxxx
openclaw config set channels.dingtalk.clientSecret your-app-secret
openclaw config set channels.dingtalk.enableAICard false
重启网关:openclaw gateway restart
在钉钉群里 @机器人 发消息测试。
十二、给 OpenClaw 装几个“技能包”(Skills)
Skills 是 OpenClaw 的灵魂,有了它们,它才真的能“干活”。
- 浏览和安装 Skills
搜索相关 Skills(例如:email)
openclaw skills search email
查看某个 Skill 的详情
openclaw skills info @openclaw/email-manager
社区有一个 awesome-openclaw-skills 仓库,已经整理了 5400+ Skills。
- 常用 Skill 推荐
可以根据你自己的需求选装,比如:
@openclaw/email-manager:邮件管理
@openclaw/calendar:日程 / 日历
@openclaw/file-organizer:本地文件整理
@openclaw/tavily-search:网页搜索
十三、安全:别让它变成“别人的后门”
OpenClaw 能直接操作文件和命令,权限非常大。安全公司已经公开过多个严重漏洞,比如:
通过反向代理配置错误导致未授权访问,最终可以远程控制 OpenClaw 实例。
通过恶意提示词注入,让 AI 执行危险命令。
所以,一定要做好下面几件事:
- 不要随便暴露在公网
不要简单把 http://127.0.0.1:18789 直接用 Nginx / Caddy 反向代理到公网,不做认证的话,任何人都能控制你的 OpenClaw。
至少要做到:
加上基本认证(用户名 / 密码)
或限制 IP 白名单
或只在内网使用
- 用“最小权限”原则
不要用 root / Administrator 直接跑 OpenClaw。
给它一个普通用户,限制只能访问特定目录。
- 先在沙盒里玩
在配置文件里启用沙盒模式,限制:
可执行的命令白名单
可访问的目录白名单
- 不要随便安装第三方 Skills
Skills 可以执行任意代码,恶意 Skill = 远程控制木马。
尽量只装:
官方 Skill
或你看得懂源码、社区口碑好的 Skill。
十四、常见问题与排查
- openclaw 命令找不到
检查 Node.js 是否正确安装,node -v 能看到版本。
确认 openclaw 是否在 PATH 中:
macOS / Linux:which openclaw
Windows:where openclaw
如果用 pnpm 安装,可能需要重新打开终端,或手动加 PATH。
- 模型上下文窗口太小
如果你用本地 Ollama 模型,可能会遇到:
Model context window too small (4096 tokens). Minimum is 16000.
解决方法:在 Ollama 中创建一个 32k 上下文的模型,然后在 OpenClaw 配置里把该模型的 contextWindow 改成 32768。
- 网络问题导致安装失败
国内服务器 / 网络可能连不上官方脚本源。
可以:
使用国内镜像(如腾讯云 npm 镜像)
或直接用 npm install -g openclaw@latest 手动安装。
十五、最后给普通人的几条真心建议👆
先在测试环境玩
不要一开始就把 OpenClaw 部署在存满重要资料的工作机上。
先跑通最简单的流程
先把 Web UI 聊天搞定,再接入钉钉 / 飞书。
从 1–2 个 Skills 开始
不要一口气装一堆 Skill,先让它稳定帮你干一两件事,比如:
每天发一个“今日简报”
自动整理某个文件夹的文档
多看日志,多思考
OpenClaw 很强,但也挺“野”,多观察它在干什么,别给陌生人递“钥匙”。
如果你能照着这篇文章,把 OpenClaw 跑起来,并且让它帮你完成一件小任务,那么恭喜你:
你已经从“只会用 AI 聊天”升级到“会用 AI 真正干活”了。
至于后面它能帮你做多少事,就看你敢不敢“喂任务”,以及愿不愿花时间调教这只小龙虾了。
目前值得购买的便宜VPS优惠:
- 支持快速部署OpenClaw商家整理《2026年支持快速部署OpenClaw的VPS云服务器商家整理》
- 搬瓦工CN2 GIA(国外高速VPS):《2026新搬瓦工VPS新手注册及购买图文教程,新优惠码,支付宝/银联支付教程》
- 便宜美国VPS:《RackNerd黑五促销 国外KVM 美国VPS低至$10.99/年 美国/欧洲七大机房可以选》
- 丽萨主机双ISP原生住宅IP:《2026年丽萨主机LisaHost新优惠码 lisa新优惠活动整理汇总》
- RAKsmart 年终云服务器大促 VPS低至$0.99《RAKsmart 年终云服务器大促,爆款产品冰雪特惠,云服务器、VPS低至$0.99,限量抢购。》
- DMIT美国vps低至9.9美元月《2026年DMIT新优惠活动 国外高品质线路vps 美国CN2 GIA 美国VPS年付7.5折起 低至$9.9/月》
- Lightlayer海外特价vps《lightlayer限时秒杀:云服务器特价$2/月起,香港/台湾/美国机房优化线路$24.99/年》
关注公众号VPS55
推送VPS优惠信息
优惠QQ三群号:798695151
主机优惠发布与交流











