什么是 OpenClaw
OpenClaw 是一个自托管的 AI 网关,能够将常用的聊天软件(如 Telegram、Discord 等)与 AI 助手连接起来。通过它,你可以在微信、Telegram 或 Discord 上直接调用 AI 能力,实现自动回复或群聊互动。
环境准备
硬件要求
| 配置 | 最低要求 | 推荐配置 |
|---|---|---|
| 操作系统 | macOS 10.15+ / Linux / Windows WSL2 | macOS 12+ |
| 内存 | 8GB | 16GB+ |
| 存储空间 | 5GB | 20GB+ |
| 网络 | 能访问国际互联网 | 稳定带宽 |
软件要求
需要 Node.js 22+ 版本。检查当前版本:
node --version
如果未安装,推荐使用 nvm 管理:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 22
nvm use 22
macOS 用户也可通过 Homebrew 安装:
brew install node@22
安装步骤
macOS 原生应用安装
Mac 用户可直接使用官方 App,体验较为流畅。访问 GitHub Releases 页面下载 .dmg 文件,或通过 Homebrew 安装:
brew install openclaw/tap/openclaw
安装完成后,OpenClaw.app 会出现在菜单栏中。
命令行安装(跨平台)
这是最通用的方式,适用于 Linux、Windows WSL 和 Mac:
# 全局安装 CLI
npm install -g openclaw
# 验证安装
openclaw --version
# 初始化设置
openclaw setup
运行 openclaw setup 后会进入交互式引导,按提示选择即可。注意部分渠道(如 Telegram)需要提前获取 Bot Token。
Docker 部署(适合服务器)
若部署在服务器上,Docker 方案更为省心:
# 拉取镜像
docker pull openclaw/openclaw:latest
# 创建配置目录
mkdir -p ~/.openclaw
# 运行容器
docker run -d \
--name openclaw \
-p 18789:18789 \
-v ~/.openclaw:/root/.openclaw \
openclaw/openclaw:latest
详细配置
配置文件位于 ~/.openclaw/openclaw.json。基础示例如下:


