2026年从零搭建 OpenClaw:教你养一只“会自己干活”的数字小龙虾

从零搭建 OpenClaw:教你养一只“会自己干活”的数字小龙虾这不是那种 3 分钟速成 爽文 是真 从零开始 一步步带你把 OpenClaw 跑起来的保姆级教程 OpenClaw 能直接操作你电脑 服务器上的文件和命令 权限很大 用不好 给陌生人一把家门钥匙 安全部分我会反复啰嗦 嫌烦可以跳过 但后果自负

大家好,我是讯享网,很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



这不是那种“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时代。👍👍👍

 

小讯
上一篇 2026-03-31 21:52
下一篇 2026-03-31 21:50

相关推荐

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/228216.html