OpenClaw 安装教程：从零开始搭建你的 AI 助手网关

# OpenClaw 安装教程：从零开始搭建你的 AI 助手网关

**OpenClaw** 是一个自托管的 AI 助手网关，让你能够从 WhatsApp、Telegram、Discord、iMessage 等聊天应用直接与 AI 助手对话。本教程将带你完成完整的安装和配置过程。

—

## 什么是 OpenClaw？

OpenClaw 是一个**开源、自托管**的网关服务，它的核心功能是：

– 🔗 连接多个聊天平台（WhatsApp、Telegram、Discord、iMessage 等）
– 🤖 对接 AI 助手（Claude、GPT 等）
– 🏠 数据完全由你掌控，无需依赖第三方云服务
– 🔌 支持插件扩展，可自定义功能

### 适用场景

– 开发者需要一个随时可用的 AI 编程助手
– 团队内部知识库问答机器人
– 个人隐私优先的 AI 对话方案

—

## 系统要求

### 硬件要求

| 配置 | 最低要求 | 推荐配置 |
|——|———|———|
| CPU | 2 核 | 4 核及以上 |
| 内存 | 4 GB | 8 GB 及以上 |
| 存储 | 10 GB 可用空间 | 20 GB 及以上 |
| 网络 | 可访问互联网 | 固定公网 IP（可选） |

### 操作系统支持

– ✅ **macOS** 12+ (Intel/Apple Silicon)
– ✅ **Linux** (Ubuntu 20.04+, Debian 11+, CentOS 8+)
– ✅ **Windows** 10/11 (通过 WSL2)
– ✅ **Docker** 容器化部署

—

## 安装步骤

### 方法一：一键安装脚本（推荐）

适用于 macOS 和 Linux：

“`bash
# 使用官方安装脚本
curl -fsSL https://openclaw.ai/install.sh | bash

# 或者使用 npm（需要 Node.js 18+）
npm install -g openclaw
“`

### 方法二：Docker 部署

“`bash
# 拉取镜像
docker pull openclaw/openclaw:latest

# 运行容器
docker run -d \
–name openclaw \
-p 18789:18789 \
-v openclaw-data:/root/.openclaw \
openclaw/openclaw:latest
“`

### 方法三：手动安装

#### macOS 安装

“`bash
# 使用 Homebrew
brew install openclaw

# 或者下载安装包
wget https://github.com/openclaw/openclaw/releases/latest/download/openclaw-macos-arm64.tar.gz
tar -xzf openclaw-macos-arm64.tar.gz
sudo mv openclaw /usr/local/bin/
“`

#### Linux 安装

“`bash
# Ubuntu/Debian
wget https://github.com/openclaw/openclaw/releases/latest/download/openclaw-linux-amd64.deb
sudo dpkg -i openclaw-linux-amd64.deb

# 或者使用 snap
sudo snap install openclaw
“`

#### Windows 安装（WSL2）

“`powershell
# 在 WSL2 Ubuntu 中执行
wsl -d Ubuntu

# 然后按照 Linux 安装步骤
“`

—

## 初始配置

### 1. 运行配置向导

“`bash
openclaw onboard
“`

向导会引导你完成：
– 选择 AI 服务提供商（OpenAI、Claude、本地模型等）
– 配置 API 密钥
– 选择要启用的聊天平台

### 2. 配置环境变量

创建配置文件：

“`bash
mkdir -p ~/.openclaw
“`

编辑 `~/.openclaw/.env`：

“`bash
# AI 服务配置
OPENAI_API_KEY=your_api_key_here
# 或
CLAUDE_API_KEY=your_api_key_here

# 可选：自定义模型
DEFAULT_MODEL=gpt-4
“`

### 3. 启动 Gateway

“`bash
# 启动服务
openclaw gateway start

# 查看状态
openclaw status
“`

—

## 聊天平台配置

### WhatsApp 配置

“`bash
# 启用 WhatsApp 插件
openclaw plugins enable whatsapp

# 扫码登录
openclaw whatsapp login
“`

详细步骤：
1. 运行 `openclaw whatsapp login`
2. 使用手机 WhatsApp 扫描二维码
3. 确认连接成功

### Telegram 配置

“`bash
# 创建 Telegram Bot
# 1. 在 Telegram 中找到 @BotFather
# 2. 发送 /newbot 创建新机器人
# 3. 获取 Bot Token

# 配置 OpenClaw
openclaw config set channels.telegram.bot_token=YOUR_BOT_TOKEN
“`

### Discord 配置

“`bash
# 1. 访问 Discord Developer Portal
# 2. 创建 Application 并添加 Bot
# 3. 获取 Bot Token

openclaw config set channels.discord.bot_token=YOUR_BOT_TOKEN
“`

### iMessage 配置（macOS 仅限）

“`bash
# macOS 专用
openclaw plugins enable imessage

# 授权权限
openclaw imessage authorize
“`

—

## 验证安装

### 1. 检查服务状态

“`bash
openclaw status
“`

正常输出应包含：
– Gateway: running
– Web UI: accessible at http://localhost:18789
– Connected channels

### 2. 发送测试消息

在任意已配置的聊天平台发送：
“`
Hello OpenClaw
“`

你应该会收到 AI 助手的回复。

### 3. 打开控制面板

浏览器访问：
“`
http://localhost:18789
“`

—

## 常见问题

### Q: 安装失败，提示权限不足

**A:** 尝试使用 sudo 或检查目录权限：
“`bash
sudo chown -R $(whoami) ~/.openclaw
“`

### Q: Gateway 启动失败，端口被占用

**A:** 修改端口配置：
“`bash
openclaw config set gateway.port=18888
openclaw gateway restart
“`

### Q: WhatsApp 登录二维码不显示

**A:** 检查终端是否支持图像显示，或使用：
“`bash
openclaw whatsapp login –text
“`

### Q: AI 助手无响应

**A:** 检查 API 密钥配置：
“`bash
openclaw config get ai.api_key
openclaw doctor
“`

—

## 进阶配置

### 启用内存功能

“`bash
# 启用长期记忆
openclaw config set memory.enabled=true
openclaw config set memory.provider=sqlite
“`

### 配置多用户

“`bash
# 添加授权用户
openclaw users add username
openclaw users set-role username admin
“`

### 设置定时任务

“`bash
# 编辑 crontab
crontab -e

# 添加自动重启（每天凌晨 3 点）
0 3 * * * /usr/local/bin/openclaw gateway restart
“`

—

## 安全建议

1. **API 密钥管理**
– 使用环境变量或密钥管理服务
– 定期轮换密钥
– 不要在代码中硬编码

2. **网络安全**
– 使用反向代理（Nginx/Caddy）添加 HTTPS
– 配置防火墙规则
– 限制 Gateway 访问 IP

3. **数据备份**
“`bash
# 备份配置和数据
tar -czf openclaw-backup-$(date +%Y%m%d).tar.gz ~/.openclaw
“`

—

## 下一步

– 📚 阅读 [完整文档](https://docs.openclaw.ai)
– 🔌 探索 [插件市场](https://clawhub.ai)
– 💬 加入 [社区讨论](https://discord.com/invite/clawd)

—

## 参考资源

– **官方文档**: https://docs.openclaw.ai
– **GitHub**: https://github.com/openclaw/openclaw
– **插件中心**: https://clawhub.ai
– **社区 Discord**: https://discord.com/invite/clawd

—

*最后更新: 2026-04-03*