OpenClaw完全教程：搭建你的私人AI助手网关

OpenClaw是一个开源的AI网关，可以让你通过WhatsApp、Telegram、Discord、飞书等聊天平台接入AI助手。本文将详细介绍如何部署和配置OpenClaw。

一、OpenClaw是什么？

OpenClaw是一个自托管的AI网关，核心功能：

• 多平台接入：一个网关同时支持WhatsApp、Telegram、Discord、飞书、iMessage等
• 完全控制：运行在自己的服务器上，数据完全由你掌控
• AI原生：支持工具调用、会话管理、记忆系统、多Agent路由
• 开源免费：MIT许可证，社区驱动

二、系统要求

硬件要求

• CPU：1核以上
• 内存：512MB以上
• 硬盘：1GB以上

软件要求

• 操作系统：Linux / macOS / Windows
• Node.js：22.0.0或更高版本
• npm：10.0.0或更高版本

支持的聊天平台

平台	支持方式	难度
WhatsApp	扫描二维码登录	⭐ 简单
Telegram	Bot Token	⭐ 简单
Discord	Bot Token	⭐⭐ 中等
飞书	企业自建应用	⭐⭐ 中等
iMessage	macOS专用	⭐⭐⭐ 复杂

三、安装OpenClaw

步骤1：安装Node.js

Ubuntu/Debian系统：

# 添加Node.js源
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

# 安装Node.js
sudo apt install -y nodejs

# 验证安装
node --version  # 应显示 v22.x.x
npm --version   # 应显示 10.x.x

CentOS/RHEL系统：

# 添加Node.js源
curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -

# 安装Node.js
sudo yum install -y nodejs

macOS系统：

# 使用Homebrew安装
brew install node@22

步骤2：安装OpenClaw

# 全局安装OpenClaw
npm install -g openclaw@latest

# 验证安装
openclaw --version

步骤3：初始化配置

# 运行配置向导
openclaw onboard --install-daemon

这个命令会：

• 创建配置目录 ~/.openclaw/
• 生成默认配置文件 openclaw.json
• 安装系统服务（可选）

四、接入聊天平台

4.1 接入Telegram

步骤1：创建Telegram Bot

1. 在Telegram中搜索 @BotFather
2. 发送 /newbot 命令
3. 按提示输入Bot名称和用户名
4. 复制获得的Bot Token（格式：123456789:ABCdefGHIjklMNOpqrsTUVwxyz）

步骤2：配置OpenClaw

# 登录Telegram
openclaw channels login telegram

# 按提示输入Bot Token

步骤3：启动网关

openclaw gateway --port 18789

现在你可以在Telegram中给你的Bot发消息，它会自动回复！

4.2 接入Discord

步骤1：创建Discord应用

1. 访问 Discord开发者门户
2. 点击”New Application”创建应用
3. 在”Bot”页面点击”Add Bot”
4. 复制Bot Token
5. 在”OAuth2 > URL Generator”中勾选”bot”权限，生成邀请链接
6. 用链接邀请Bot加入你的服务器

步骤2：配置OpenClaw

# 登录Discord
openclaw channels login discord

# 按提示输入Bot Token

重要权限设置：

• Send Messages – 发送消息
• Read Message History – 读取消息历史
• Mention Everyone – @所有人权限

4.3 接入飞书

步骤1：创建飞书企业自建应用

1. 访问 飞书开放平台
2. 创建企业自建应用
3. 配置应用权限：消息与通讯 > 获取与发送单聊、群聊消息
4. 发布应用版本

步骤2：获取凭证

• App ID
• App Secret

步骤3：配置事件订阅

1. 在应用管理中启用事件订阅
2. 请求网址设置为你的服务器地址：https://你的域名/webhook/feishu
3. 订阅事件：im.message.receive_v1（接收消息）

步骤4：配置OpenClaw

# 编辑配置文件
nano ~/.openclaw/openclaw.json

添加飞书配置：

{
  "plugins": {
    "entries": {
      "feishu": {
        "enabled": true,
        "appId": "your_app_id",
        "appSecret": "your_app_secret"
      }
    }
  }
}

4.4 接入WhatsApp

步骤1：登录WhatsApp

openclaw channels login whatsapp

步骤2：扫描二维码

• 打开手机WhatsApp
• 设置 > 已关联的设备 > 关联设备
• 扫描终端显示的二维码

注意：WhatsApp登录状态会保存在本地，重启网关后无需重新扫码。

五、启动网关

前台启动（测试用）

openclaw gateway --port 18789

后台运行（生产环境）

# 使用PM2管理
pm2 start 'openclaw gateway --port 18789' --name openclaw-gateway

# 保存PM2配置
pm2 save

# 设置开机自启
pm2 startup

访问控制面板

网关启动后，打开浏览器访问：

• 本地：http://127.0.0.1:18789
• 远程：需要配置域名和HTTPS

六、配置AI模型

支持的模型提供商

• 百度千帆（推荐国内用户）
• Anthropic Claude
• OpenAI GPT-4
• Google Gemini
• Azure OpenAI
• 本地模型（Ollama等）

配置示例（百度千帆）

{
  "provider": {
    "name": "baiduqianfancodingplan",
    "model": "qianfan-code-latest"
  }
}

配置示例（Claude）

{
  "provider": {
    "name": "anthropic",
    "model": "claude-sonnet-4-20250514",
    "apiKey": "your_api_key"
  }
}

七、高级配置

消息权限控制

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+8613800138000"],
      "groups": {
        "*": { "requireMention": true }
      }
    }
  }
}

群聊配置

{
  "messages": {
    "groupChat": {
      "mentionPatterns": ["@openclaw", "@assistant"]
    }
  }
}

多Agent路由

{
  "routing": {
    "rules": [
      {
        "match": { "channel": "telegram" },
        "agent": "coding-agent"
      },
      {
        "match": { "channel": "discord" },
        "agent": "general-agent"
      }
    ]
  }
}

八、常见问题

Q1: 网关启动失败？

A: 检查端口是否被占用：

lsof -i :18789
# 如果被占用，杀死进程或更换端口

Q2: Telegram Bot不回复？

A: 检查Bot Token是否正确，确认Bot未被封禁。

Q3: WhatsApp登录失效？

A: WhatsApp登录有效期约14天，需要重新扫码登录：

openclaw channels login whatsapp

Q4: 如何查看日志？

# PM2日志
pm2 logs openclaw-gateway

# 系统服务日志
journalctl -u openclaw-gateway -f

Q5: 如何更新OpenClaw？

npm update -g openclaw@latest

九、安全建议

1. 限制访问IP：只允许特定IP访问网关
2. 使用HTTPS：配置SSL证书加密通信
3. 设置认证Token：防止未授权访问
4. 定期更新：保持最新版本修复安全漏洞
5. 备份配置：定期备份 ~/.openclaw/ 目录

十、总结

OpenClaw是一个强大的AI网关，让你可以在任何聊天平台上使用AI助手。通过本文的教程，你应该能够：

• 成功安装OpenClaw
• 接入Telegram、Discord、飞书等平台
• 配置AI模型和权限
• 解决常见问题

更多详细文档请访问：https://docs.openclaw.ai

遇到问题？加入社区：Discord社区