OpenClaw(大龙虾机器人)是一款本地部署的全能 AI 助手,可通过 WhatsApp、Telegram、飞书等聊天软件实现邮件处理、日历管理、系统操作等功能,数据本地存储更隐私。本教程适配 macOS/Linux/Windows 系统,包含基础安装、初始化配置、聊天软件对接及常见问题解决。
一、安装前准备
1. 系统与硬件要求
| 配置项 | 最低要求 | 推荐配置 |
|---|
OpenClaw 是一款支持多平台的本地 AI 助手工具,提供邮件处理、日历管理及系统操作功能。档详细介绍了在 macOS、Linux 及 Windows 系统上的安装步骤,包括 Node.js 环境配置、AI 模型 API Key 设置及飞书等聊天软件对接流程。内容涵盖基础安装脚本执行、初始化配置向导、权限管理与常见问题排查,帮助用户快速搭建私有化 AI 工作流并实现自动化任务调度。
OpenClaw(大龙虾机器人)是一款本地部署的全能 AI 助手,可通过 WhatsApp、Telegram、飞书等聊天软件实现邮件处理、日历管理、系统操作等功能,数据本地存储更隐私。本教程适配 macOS/Linux/Windows 系统,包含基础安装、初始化配置、聊天软件对接及常见问题解决。
| 配置项 | 最低要求 | 推荐配置 |
|---|
| 操作系统 | macOS 12+/Ubuntu 20.04+/Windows 10(需 WSL2) | macOS 14+/Ubuntu 22.04+/Windows 11 |
| 内存 | 4GB | 8GB+ |
| 磁盘空间 | 2GB 可用 | 10GB+ SSD |
| 核心依赖 | Node.js 18.0+ | Node.js v22 LTS 最新版 |
打开终端,执行官方一键安装脚本(自动安装 Node.js 及所有依赖):
curl -fsSL https://openclaw.ai/install.sh | bash
验证安装成功:
openclaw --version
显示版本号即安装完成。
也可通过 npm 全局安装(备用方式):
# 配置国内 npm 镜像(可选,加速下载)
npm config set registry https://registry.npmmirror.com
# 全局安装 OpenClaw
npm install -g openclaw@latest
Windows 原生对 OpenClaw 支持较弱,需先配置 Node.js 环境,全程用管理员权限打开 PowerShell 操作:
若遇执行策略报错,先执行以下命令再重新安装:
Set-ExecutionPolicy ExecutionPolicy RemoteSigned -Scope CurrentUser
执行 Windows 专属安装脚本:
iwr -UseBasicParsing https://openclaw.ai/install.ps1 | iex
安装 Node.js v22:
# 安装 nvm(Node 版本管理工具,推荐)
iwr -UseBasicParsing https://raw.githubusercontent.com/coreybutler/nvm-windows/master/nvm-setup.exe | iex
# 安装并使用 Node.js 22
nvm install 22
nvm use 22.22.0
验证安装:
openclaw --version
适合需要自定义开发、修改源码的用户,macOS/Linux/Windows(WSL2)均可使用:
# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
# 进入目录并安装依赖
cd openclaw && pnpm install && pnpm run build
# 初始化
pnpm run openclaw onboard
安装完成后,执行初始化命令进入交互式配置向导,配置 AI 模型和基础参数:
# 通用初始化命令
openclaw onboard
# Windows 新手推荐快速配置
openclaw onboard --flow quickstart
首次配置会出现风险提示:I understand this is powerful and inherently risky. Continue?,选择 Yes 继续。
sk-xxxxxxxx),回车确认;session-memory(启用多轮对话记忆,避免重复说明需求),其他默认;18789。配置完成后,浏览器会自动打开本地控制台,手动访问地址:
http://127.0.0.1:18789
首次进入需输入初始化生成的配置 Token(妥善保存,丢失需重新初始化)。
OpenClaw 支持 WhatsApp、Telegram、飞书、钉钉、微信等平台,飞书配置难度低、稳定性高,以下为详细对接步骤,其他平台操作逻辑类似。
在终端/PowerShell 执行插件安装命令:
openclaw plugins install @m1heng-clawd/feishu
# 进入插件目录完成依赖安装
cd /root/.openclaw/extensions/feishu/ && npm install --verbose
粘贴以下 JSON 代码,点击导入(核心权限,确保机器人能收发消息):
{"scopes":{"tenant":["contact:user.base:readonly","im:chat","im:message","im:message:send_as_bot","im:resource"],"user":[]}}
im.message.receive_v1(接收消息事件,必选);验证状态:
openclaw status
显示Gateway running即绑定成功。
重启网关服务,使配置生效:
openclaw gateway restart
在终端执行命令,添加飞书通信渠道:
openclaw channels add
在绑定的聊天软件中直接发送自然语言指令,机器人即可执行操作,例如:
| 功能 | 命令 |
|---|---|
| 查看版本 | openclaw --version |
| 查看运行状态 | openclaw status |
| 启动/停止/重启机器人 | openclaw start/stop/restart |
| 重新初始化配置 | openclaw onboard |
| 重启网关服务 | openclaw gateway restart |
| 查看已安装插件 | openclaw plugins list |
| 安装插件 | openclaw plugins install 插件名 |
| 卸载插件 | openclaw plugins uninstall 插件名 |
| 查看帮助 | openclaw --help |
node-gyp rebuild原因:缺少 Python 和 C++ 编译工具; 解决:
xcode-select --install 安装 Xcode 命令行工具;sudo apt install build-essential python3。原因:系统组件被精简、WSL 未启用或 Git 环境未配置; 解决:
wsl --install;清理 npm 缓存并重装:
npm cache clean --force
npm install -g openclaw@latest
解决:
openclaw gateway restart 重启网关,再重新配置。排查步骤:
openclaw status 确认网关服务正常运行;im.message.receive_v1;openclaw gateway --verbose,定位错误原因。解决:
npm config set registry https://registry.npmmirror.com;.env 文件中的 MODEL_PROVIDER 和 API_KEY,支持本地运行 Llama、Qwen 等模型,完全脱离外网。config.json 中设置 allowed_commands 和 denied_commands,禁止机器人执行危险 shell 命令,提升安全性。Docker 部署:适合需要 7×24 小时运行的用户,容器化部署更稳定:
git clone https://github.com/openclaw/openclaw.git
cd openclaw
docker compose up -d openclaw-gateway
汉化适配:国内用户建议安装社区汉化版,优化微信/企业微信支持:
npm install -g openclaw-cn@latest
pm2 等工具实现后台保活。
微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online
JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online
Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online