OpenClaw 安装指导手册适合小白的完整安装教程

什么是 OpenClaw？
OpenClaw 是一个 AI 助手框架，可以让你通过 Telegram、Discord、飞书、WhatsApp 等平台与 AI 对话。它支持连接 Claude、Gemini 等多种 AI 服务。

环境要求
项目要求
操作系统 macOS、Linux、Windows (WSL2)
内存建议 4GB 以上
磁盘至少 2GB 可用空间
网络需要访问国际网络（用于连接 AI 服务）
安装方式选择
方式难度适合人群
一键脚本 ⭐ 简单新手、小白
Docker ⭐⭐ 中等进阶用户、云服务器
npm/pnpm ⭐⭐ 中等开发者
方式一：一键脚本安装（推荐新手）
macOS / Linux / WSL2
打开终端，运行：

curl -fsSL https://clawd.org.cn/install.sh | bash
Windows
打开 PowerShell（管理员模式），运行：

iwr -useb https://clawd.org.cn/install.ps1 | iex
安装过程
脚本会自动检测并安装 Node.js（如未安装）
自动下载并安装 OpenClaw
启动配置向导，按照提示完成设置
完成后在浏览器打开 http://127.0.0.1:18789/ 即可访问
跳过配置（可选）
如果只想先安装，不配置：

curl -fsSL https://clawd.org.cn/install.sh | bash -s -- --no-onboard
方式二：Docker 安装（适合云服务器）
步骤 1：安装 Docker
macOS：下载并安装 Docker Desktop

Linux (Ubuntu)：

sudo apt update
sudo apt install docker.io docker-compose
sudo systemctl start docker
sudo systemctl enable docker
Windows：安装 Docker Desktop，并启用 WSL2

步骤 2：一键部署脚本
curl -fsSL https://clawd.org.cn/install.sh | bash
脚本会自动：

✅ 检查 Docker 环境
✅ 下载镜像
✅ 配置环境变量
✅ 启动容器
✅ 运行配置向导
✅ 生成网关令牌
步骤 3：手动 Docker Compose 部署（进阶）
如需自定义配置，按以下步骤：

1. 创建工作目录

mkdir -p ~/openclaw-docker
cd ~/openclaw-docker
2. 创建环境配置文件

cat > .env << 'EOF'
OPENCLAW_IMAGE=jiulingyun803/openclaw-cn:latest
OPENCLAW_GATEWAY_PORT=18789
OPENCLAW_GATEWAY_BIND=lan
OPENCLAW_GATEWAY_TOKEN=your-secure-token-here
EOF
3. 创建 docker-compose.yml

cat > docker-compose.yml << 'EOF'
services:
openclaw-cn-gateway:
image: jiulingyun803/openclaw-cn:latest
user: node:node
environment:
HOME: /home/node
OPENCLAW_GATEWAY_TOKEN: ${OPENCLAW_GATEWAY_TOKEN}
volumes:
- ./data/.openclaw:/home/node/.openclaw
- ./data/clawd:/home/node/clawd
ports:
- "18789:18789"
- "18790:18790"
init: true
restart: unless-stopped
command: ["node", "dist/index.js", "gateway", "--bind", "lan", "--port", "18789"]
EOF
4. 启动容器

mkdir -p ./data/.openclaw ./data/clawd
chown -R 1000:1000 ./data
docker compose up -d
5. 运行配置向导

docker compose run --rm openclaw-cn-cli onboard
方式三：npm 安装
安装 Node.js
如果还没有 Node.js 22+，先安装：

macOS：

brew install node
Linux：

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
安装 OpenClaw
npm install -g openclaw-cn@latest
openclaw-cn onboard --install-daemon
配置向导说明
首次安装后，会提示配置：

选择 AI 后端：Claude / Gemini 等
配置渠道：飞书、Telegram、Discord 等
生成令牌：用于登录 Web UI
常用渠道配置
飞书
需要：App ID + App Secret
获取方式：进入飞书开放平台创建应用
Telegram
需要：Bot Token
获取方式：找 @BotFather 创建
Discord
需要：Bot Token
获取方式：在 Discord Developer Portal 创建应用
验证安装
openclaw-cn doctor # 检查配置问题
openclaw-cn status # 查看网关状态
openclaw-cn dashboard # 打开浏览器管理界面
常用命令
命令说明
openclaw-cn status 查看运行状态
openclaw-cn restart 重启网关
openclaw-cn config edit 编辑配置文件
openclaw-cn channels list 查看已配置的渠道
openclaw-cn doctor 诊断问题
访问方式
本地： http://127.0.0.1:18789/
局域网： http://你的IP地址:18789/
Token：配置向导生成的令牌
常见问题
Q1: 安装脚本报错怎么办？
A: 确保网络可以访问国际网络，或者检查是否有防火墙拦截。

Q2: Docker 权限不足？
A: Linux 下运行 sudo usermod -aG docker $USER 后重新登录。

Q3: 端口被占用？
A: 修改 .env 中的 OPENCLAW_GATEWAY_PORT 为其他端口（如 18790）。

Q4: 无法连接 AI？
A: 检查配置的 AI 服务是否正确，API Key 是否有效。

相关链接
官网：https://clawd.org.cn
中文文档：https://docs.openclaw.ai
GitHub：https://github.com/openclaw/openclaw
中文社区：https://discord.gg/clawd
祝你安装顺利！有问题随时提问～