这不是那种“3 分钟速成”爽文,是真·从零开始,一步步带你把 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(沙盒)
为了安全,建议先在“沙盒模式”下玩,限制它只能访问特定目录 / 命令,避免删光你硬盘。
官方文档和社区实测:
CPU:基本没什么要求,哪怕是老笔记本 / 廉价云服务器都行。
内存:最低 2GB 就能跑,但建议 ≥ 4GB,否则多个 Skill 一起上可能会有点卡。
磁盘:预留 10GB 比较稳妥(模型、日志、缓存会慢慢占空间)。
支持三大平台:
macOS(Intel / Apple Silicon 都可以)
Linux(主流发行版:Ubuntu / Debian / CentOS 等)
Windows
官方推荐用 WSL2(Windows Subsystem for Linux)来跑,体验更稳。
也有纯 Windows 部署教程,但坑会多一点。
OpenClaw 是用 Node / TypeScript 写的,运行时依赖 Node.js ≥ 22。
去 Node.js 官网下载 LTS 版本:
https://nodejs.org/
安装时一路“下一步”,注意勾选:
Add to PATH(自动加环境变量)
验证安装:
node -v
# 建议看到 v22.x.x
npm -v
主要是为了拉取代码和部分 Skill 依赖。
官网下载:https://git-scm.com/
验证:
git --version
OpenClaw 提供了跨平台的一键脚本,会自动帮你装 Node、配置环境。
打开终端,执行:
curl -fsSL https://openclaw.ai/install.sh | bash
以管理员身份打开 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 --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 就行。
配置完,就可以启动了:
# 启动网关(前台运行,方便看日志)
openclaw gateway
# 或后台运行(推荐先前台,确认正常后再后台)
# openclaw gateway start
然后打开浏览器访问:
http://127.0.0.1:18789/chat
如果能看到一个聊天界面,并且你发一句“你好”,它能正常回复,恭喜你,OpenClaw 已经跑起来了。
官方 OpenClaw 主打海外平台,但国内有一个 openclaw-china 项目,专门支持钉钉、飞书、、企业微信、微信等。
# 安装统一包(包含所有国内渠道)
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
在钉钉群里 @机器人 发消息测试。
Skills 是 OpenClaw 的灵魂,有了它们,它才真的能“干活”。
# 搜索相关 Skills(例如:email)
openclaw skills search email
# 查看某个 Skill 的详情
openclaw skills info @openclaw/email-manager
社区有一个 awesome-openclaw-skills 仓库,已经整理了 5400+ Skills。
可以根据你自己的需求选装,比如:
@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 可以执行任意代码,恶意 Skill = 远程控制木马。
尽量只装:
官方 Skill
或你看得懂源码、社区口碑好的 Skill。
检查 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 真正干活”了。👏
至于后面它能帮你做多少事,就看你敢不敢“喂任务”,以及愿不愿花时间调教这只小龙虾了。
关注我,跟我一起学习,一起探索ai时代。👍👍👍
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/228216.html