OpenClaw（小龙虾）多系统部署教程
—— Windows / macOS / Linux 全平台
整理时间：2026-04-14涵盖系统：Windows 10/11、macOS 12+（含 M 系列）、Ubuntu 20.04+
【目录】 第一章 OpenClaw 项目介绍 第二章 三个系统通用准备 第三章 Windows 安装部署（PowerShell） 第四章 macOS 安装部署（Intel + Apple Silicon） 第五章 Linux / Ubuntu 安装部署 第六章 首次启动向导（Onboarding） 第七章 常用命令速查 第八章 技能（Skill）安装 第九章 接入 AI 模型（OpenAI / Claude / DeepSeek 等） 第十章 常见问题 FAQ 第十一章 卸载与清理第一章 OpenClaw 项目介绍
1.1 这是什么
OpenClaw（前身 ClawdBot/Moltbot）是一个开源、自托管的 AI Agent 框架，由奥地利开发者 Peter Steinberger 发起，2026 年初发布后在 GitHub 迅速获得 18 万+ stars。它填补了传统对话型 AI（如 ChatGPT、 Claude）与全自动型 Agent（如 Auto-GPT）之间的空白。因为官方图标是一只红色龙虾，国内用户昵称为「小龙虾」、「龙虾 AI」。
1.2 它能做什么
- 直接操作你的电脑：开浏览器、读写文件、发邮件、执行代码
- 模型无关：支持 OpenAI、Claude、DeepSeek、本地模型等
- 本地优先：数据在本机处理，不上传云端
- 技能化扩展：通过 Skill 系统按需安装能力（浏览器/记忆/MCP 等）
- IM 接入：原生支持飞书、钉钉、企业微信等国内 IM 渠道
1.3 与传统 AI 助手的区别
传统 AI OpenClaw ------- -------- 只能聊天 能直接执行操作 云端运行 本地运行 封闭协议 MIT 开源 固定能力 Skill 插件化1.4 许可证
MIT License，完全免费，可商用、可修改、可二次分发。1.5 官方资源
- 官方文档：https://docs.openclaw.ai/zh-CN
- GitHub 仓库：通过官方网站跳转
- Gateway 默认端口：18789
- 配置目录（默认）：~/.openclaw
第二章 三个系统通用准备
不管用哪个系统，都需要满足以下条件：2.1 硬件要求
- CPU：现代 x86_64 或 ARM64（含 Apple M 系列）
- 内存：最低 8 GB，推荐 16 GB
- 磁盘：至少 5 GB 可用空间（Skill 和缓存会增长）
- 网络：能访问 AI 模型服务的 API（OpenAI / Claude 等）
2.2 软件要求
- Node.js 22 或以上（必须，这是硬性要求）
- Git（用于拉取 Skill 和更新）
- 一个 AI 模型的 API Key（任选其一）：
- 现代浏览器（Chrome / Edge / Safari / Firefox 任一）
2.3 网络说明
国内用户建议使用国内 npm 镜像加速： registry.npmmirror.com官方也提供了国内优化安装脚本（见各章节）。
第三章 Windows 安装部署（PowerShell）
Windows 10 或 Windows 11 都适用，全程用 PowerShell 操作，10-15 分 钟可以完成。3.1 安装 Node.js 22+
方式 A：官网下载（推荐新手） 1. 浏览器打开：https://nodejs.org/zh-cn/ 2. 下载 LTS 版本（必须是 22 或以上） 3. 双击 .msi 安装包，一路 Next 4. 勾选「Automatically install the necessary tools」 5. 安装完成方式 B：用 winget（Windows 11 推荐）
以管理员身份打开 PowerShell 执行：
winget install OpenJS.NodeJS.LTS
3.2 安装 Git
winget install Git.Git或者去 https://git-scm.com/download/win 下载安装。
3.3 验证环境
新开一个 PowerShell（不要用老窗口，环境变量没刷新）：node -v # 应该显示 v22.x.x 或更高
npm -v # 应该显示 10.x 或更高
git --version
3.4 配置国内镜像（重要，国内用户必做）
npm config set registry https://registry.npmmirror.com npm config get registry # 验证3.5 全局安装 OpenClaw
npm install -g openclaw@latest如果提示权限错误，以管理员身份打开 PowerShell 重试。
安装完成后验证：
openclaw --version
3.6 创建工作目录并初始化
在 PowerShell 里执行：mkdir C:\openclaw-workspace
cd C:\openclaw-workspace
openclaw init
这会在当前目录创建配置文件和缓存。
3.7 启动 Gateway
openclaw gateway start成功会显示类似：
Gateway running on http://localhost:18789
3.8 打开控制台
浏览器访问： http://localhost:18789看到 OpenClaw 控制台页面就说明部署成功。第一次访问会进入配置向
导（Onboarding），见第六章。
第四章 macOS 安装部署（Intel + Apple Silicon）
4.1 系统要求
- macOS 12 Monterey 或更高版本
- 建议 M1/M2/M3/M4 芯片（Intel 也能跑但更慢）
- 16 GB 内存体验最佳
4.2 打开终端
按Command + Space 打开 Spotlight，输入 Terminal 回车。
4.3 安装 Homebrew（如果没装过）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"国内用户如果 GitHub 访问慢，可以用国内镜像：
/bin/bash -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
4.4 安装 Node.js 22+ 和 Git
brew install node@22 git brew link node@22 --force验证版本：
node -v
npm -v
git --version
4.5 方法 A：官方一键脚本（推荐）
OpenClaw 官方提供了一键安装脚本，国内用户使用镜像源版本：curl -fsSL https://clawd.org.cn/install.sh | bash -s -- --registry https://registry.npmmirror.com
脚本会自动：
- 检测 Node 版本
- 配置 npm 镜像
- 全局安装 openclaw
- 初始化配置目录
4.6 方法 B：手动 npm 安装
如果一键脚本不可用，手动执行：
npm config set registry https://registry.npmmirror.com
npm install -g openclaw
验证：
openclaw --version
4.7 启动配置向导
安装成功后，官方安装器会自动进入配置向导。如果没有，手动启动：openclaw onboard
按提示一步步配置 AI 模型、工作目录等。
4.8 启动 Gateway
openclaw gateway start4.9 打开控制台
Safari / Chrome 访问：http://localhost:187894.10 M 系列芯片注意事项
Apple Silicon 上运行非常流畅，内存占用约 500 MB-1 GB 空载。 如果某些 Skill 在 M 芯片下报错（兼容性问题），可以尝试用 Rosetta：arch -x86_64 zsh
npm install -g openclaw
第五章 Linux / Ubuntu 安装部署
以 Ubuntu 20.04 / 22.04 / 24.04 为例，其他发行版（Debian / CentOS） 步骤大同小异。5.1 更新系统
sudo apt update sudo apt upgrade -y sudo apt install -y curl git build-essential openssh-server5.2 安装 Node.js 22+
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs验证：
node -v # 应该是 v22.x.x
npm -v
5.3 配置 npm 国内镜像
npm config set registry https://registry.npmmirror.com5.4 方法 A：官方一键安装脚本（阿里云 CDN 加速）
curl -fsSL https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260303/chwrdl/openclaw_installer.sh -o openclaw_installer.sh bash openclaw_installer.sh在菜单中选择「Install OpenClaw」，脚本自动处理一切，约需 5-10 分钟。
5.5 方法 B：npm 直接安装
sudo npm install -g openclaw（sudo 用于全局安装，避免权限问题）
验证：
which openclaw
openclaw --version
5.6 创建工作目录
mkdir -p ~/openclaw-workspace cd ~/openclaw-workspace openclaw init5.7 放行防火墙端口
Ubuntu UFW 默认拦截 18789，如果想从局域网访问必须放行：sudo ufw allow 18789/tcp
sudo ufw reload
云服务器还要在 控制台安全组 里同步放行 18789。
5.8 启动 Gateway
openclaw gateway start如果想后台运行不占终端：
nohup openclaw gateway start > ~/openclaw.log 2>&1 &
5.9 设置开机自启（可选）
创建 systemd 服务：sudo nano /etc/systemd/system/openclaw.service
粘贴如下内容（注意把 YOUR_USERNAME 换成你的用户名）：
[Unit]
Description=OpenClaw Gateway
After=network.target
[Service]
Type=simple
User=YOUR_USERNAME
WorkingDirectory=/home/YOUR_USERNAME/openclaw-workspace
ExecStart=/usr/bin/openclaw gateway start
Restart=on-failure
RestartSec=5
[Install]
WantedBy=multi-user.target
启用并启动：
sudo systemctl daemon-reload
sudo systemctl enable openclaw
sudo systemctl start openclaw
sudo systemctl status openclaw
5.10 访问控制台
本机：http://localhost:18789 局域网/云服务器：http://服务器IP:18789第六章 首次启动向导（Onboarding）
不管哪个系统，第一次启动都会进入 Onboarding 向导。如果没有自动 进入，手动执行：openclaw onboard
向导大致步骤：
6.1 配置 AI 模型
会问你选用哪个模型提供商：[1] OpenAI
[2] Anthropic Claude
[3] DeepSeek
[4] 其他兼容 OpenAI API 的服务
[5] 本地 Ollama
选好后粘贴对应的 API Key 和可选的 Base URL。
6.2 选择默认模型
例如选 claude-sonnet-4-6、gpt-4o、deepseek-chat 等。6.3 配置工作目录
默认是当前目录，也可以指定一个永久路径存放 OpenClaw 的数据、 缓存和 Skill。6.4 安装初始 Skill
向导会推荐几个基础 Skill：- browser-skill - 浏览器操作
- filesystem-skill- 文件读写
- memory-skill - 持久化记忆
- updater-skill - 自动更新
6.5 完成配置
向导结束后，OpenClaw 会自动重启 Gateway。浏览器访问 18789 端口 就能看到完整的控制台。第七章 常用命令速查
命令 作用 -------- ---- openclaw --version 查看版本 openclaw init 初始化工作目录 openclaw onboard 重新运行配置向导 openclaw gateway start 启动 Gateway openclaw gateway stop 停止 Gateway openclaw gateway restart 重启 Gateway（改配置后必做） openclaw gateway status 查看运行状态 openclaw status 全局状态检查 openclaw skill list 查看已安装的 Skill openclaw skill add <name> 安装一个 Skill openclaw skill remove <name> 卸载 Skill openclaw skill update 更新所有 Skill openclaw config show 查看当前配置 openclaw config edit 编辑配置文件 openclaw logs 查看日志 openclaw update 升级 OpenClaw 本体第八章 技能（Skill）安装
OpenClaw 的核心魅力是「技能化」—— 按需给 Claw 加能力。8.1 浏览器技能
让 Claw 能操作真实浏览器（打开网页、填表、点击、截图）：openclaw skill add browser
第一次会下载 Chromium，约 150 MB。
8.2 文件系统技能
读写本地文件：openclaw skill add filesystem
8.3 记忆技能
持久化对话记忆，跨会话保留：openclaw skill add memory
8.4 代码执行技能
让 Claw 能真实执行 Python / JS / Shell：openclaw skill add code-execution
⚠️ 安全提醒：代码执行在沙箱外运行，请谨慎授权。
8.5 MCP 协议技能
接入 Model Context Protocol，可以用 Claude Desktop 等工具的 MCP Server：openclaw skill add mcp
8.6 IM 接入技能
接飞书 / 钉钉 / 企业微信：openclaw skill add feishu # 飞书
openclaw skill add dingtalk # 钉钉
openclaw skill add wecom # 企业微信
8.7 查看全部可用 Skill
openclaw skill list --all第九章 接入 AI 模型
9.1 OpenAI
openclaw config set provider openai openclaw config set api_key sk-xxxxxxxx openclaw config set model gpt-4o9.2 Anthropic Claude
openclaw config set provider anthropic openclaw config set api_key sk-ant-xxxxxxxx openclaw config set model claude-sonnet-4-69.3 DeepSeek
openclaw config set provider deepseek openclaw config set api_key sk-xxxxxxxx openclaw config set model deepseek-chat9.4 第三方 OpenAI 兼容服务（如国内代理）
openclaw config set provider openai-compatible openclaw config set api_base https://your-proxy.com/v1 openclaw config set api_key your-key openclaw config set model gpt-49.5 本地 Ollama
先装 Ollama 并拉模型：ollama pull llama3:8b
ollama serve
配置 OpenClaw：
openclaw config set provider ollama
openclaw config set api_base http://localhost:11434
openclaw config set model llama3:8b
9.6 切换模型后必须重启 Gateway
openclaw gateway restart第十章 常见问题 FAQ
Q1: 安装时报错「node 版本过低」 A: 必须 Node.js 22+，卸载老版本： Windows：控制面板卸载 Node.js，重装新版 macOS：brew uninstall node && brew install node@22 Linux：sudo apt remove nodejs，然后按第五章重新安装 NodeSourceQ2: npm install 卡住或报网络错误
A: 切换到国内镜像：
npm config set registry https://registry.npmmirror.com
再重试
Q3: 启动 Gateway 后浏览器打不开 http://localhost:18789
A: 检查以下几点：
① openclaw gateway status 看服务是否在运行
② 端口冲突：netstat -ano | grep 18789 (Linux/Mac) 或
netstat -ano | findstr 18789 (Windows)
③ 防火墙拦截：Linux 要放行 ufw，Windows 要允许防火墙入站规则
Q4: API Key 输入错误或模型切换失败
A: 手动编辑配置文件：
openclaw config edit
配置文件路径一般在：
Windows: %USERPROFILE%\.openclaw\config.yaml
macOS/Linux: ~/.openclaw/config.yaml
改完执行 openclaw gateway restart
Q5: Skill 安装失败
A: 先更新本体：openclaw update
如果是网络问题，配置代理：
export HTTPS_PROXY=http://127.0.0.1:7890
然后重试
Q6: 内存占用过高
A: 默认所有 Skill 都常驻。禁用不需要的：
openclaw skill disable <name>
只在需要时 enable
Q7: 怎么升级 OpenClaw 到最新版
A: openclaw update
或者重新安装最新版：
npm install -g openclaw@latest
Q8: 旧教程里的命令不能用了
A: 2026.3.2 版本有重大变更，很多老命令被废弃。建议：
① openclaw update 升级到最新
② 参考官方新文档：docs.openclaw.ai/zh-CN
③ 如果配置冲突，删除 ~/.openclaw 目录重新 onboard
Q9: 如何卸载 OpenClaw
A: 见第十一章
Q10: 是否支持多用户 / 团队协作
A: 官方支持 Team 版本，但需要付费订阅。社区版单机单用户。
第十一章 卸载与清理
如果想完全移除 OpenClaw：11.1 停止服务
openclaw gateway stop11.2 卸载主程序
npm uninstall -g openclaw11.3 清理配置和数据
# Windows（PowerShell） Remove-Item -Recurse -Force $HOME\.openclaw# macOS / Linux
rm -rf ~/.openclaw
rm -rf ~/openclaw-workspace # 如果有自建工作目录
11.4 卸载 systemd 服务（Linux only）
sudo systemctl stop openclaw sudo systemctl disable openclaw sudo rm /etc/systemd/system/openclaw.service sudo systemctl daemon-reload附录 端口与路径速查
默认端口 ：18789 默认配置目录 ： Windows ：%USERPROFILE%\.openclaw\ macOS/Linux ：~/.openclaw/默认日志路径 ：
Windows ：%USERPROFILE%\.openclaw\logs\gateway.log
macOS/Linux ：~/.openclaw/logs/gateway.log
默认 Skill 目录 ：~/.openclaw/skills/
默认配置文件 ：~/.openclaw/config.yaml
附录 一键命令汇总（复制粘贴）
Windows (PowerShell 管理员)
winget install OpenJS.NodeJS.LTS Git.Git npm config set registry https://registry.npmmirror.com npm install -g openclaw@latest mkdir C:\openclaw-workspace; cd C:\openclaw-workspace openclaw init openclaw gateway startmacOS (Terminal)
brew install node@22 git brew link node@22 --force npm config set registry https://registry.npmmirror.com curl -fsSL https://clawd.org.cn/install.sh | bash -s -- --registry https://registry.npmmirror.com openclaw gateway startUbuntu / Debian
sudo apt update && sudo apt install -y curl git build-essential curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs npm config set registry https://registry.npmmirror.com sudo npm install -g openclaw mkdir -p ~/openclaw-workspace && cd ~/openclaw-workspace openclaw init sudo ufw allow 18789/tcp openclaw gateway start附录 参考资料
官方文档（中文） ：https://docs.openclaw.ai/zh-CN 知乎深度分析 ：https://zhuanlan.zhihu.com/p/2010119008783987145 百度百科词条 ：https://baike.baidu.com/item/OpenClaw Mac 部署教程 ：https://cloud.tencent.com/developer/article/2643844 Ubuntu 避坑指南 ：https://www.cnblogs.com/databank/p/19610007 Windows 优化版 ：https://www.cnblogs.com/hibobo/p/19685803 完整安装指南 ：https://www.cnblogs.com/shanren/p/19685473 B 站视频教程 ：https://www.bilibili.com/video/BV1f99MBdEpV/—— 教程结束 —— 装好后别忘了给自己的小龙虾取个名字 🦞
评论 (0)
暂无评论