OpenClaw 自托管 AI 网关安装与配置指南

OpenClaw 自托管 AI 网关安装与配置指南

经过实测，OpenClaw 作为自托管 AI 网关，能有效连接常用通讯软件与大模型服务。以下整理其在不同环境下的部署方案及配置细节。

什么是 OpenClaw？

简单来说，OpenClaw 是一个自托管的 AI 网关，它将微信、Telegram、Discord、iMessage 等聊天软件与 AI 助手连接起来。

• 📱 在微信上发消息，AI 自动回复
• 💬 在 Discord 群里 @它，参与讨论
• 📲 人在外面用 WhatsApp 随时召唤私人 AI

环境准备

硬件要求

配置	最低要求	推荐配置
操作系统	macOS 10.15+ / Linux / Windows WSL2	macOS 12+
内存	8GB	16GB+
存储空间	5GB	20GB+
网络	能访问国际互联网	稳定带宽

软件要求

确保 Node.js 版本在 22 以上：

node --version

如果没有安装 Node.js，推荐使用 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，体验最丝滑：

1. 访问 GitHub Releases 下载 .dmg 文件
2. 或使用 Homebrew 安装：

brew install openclaw/tap/openclaw

安装完成后，打开 OpenClaw.app，它会出现在菜单栏。

方式二：命令行安装（跨平台）

这是最通用的安装方式，Linux/Windows WSL/Mac 通用：

# 全局安装 CLI
npm install -g openclaw

# 验证安装
openclaw --version

# 初始化设置
openclaw setup

运行 openclaw setup 后会出现交互式引导，按提示选择即可。

⚠️ 注意：部分渠道需要额外配置，例如 Telegram 需先找 @BotFather 申请 Bot Token，Discord 需创建开发者应用。

方式三：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。基础配置示例如下：

{
  "gateway": {
    "port": 18789,
    "verbose": true
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "YOUR_BOT_TOKEN_HERE"
    },
    "discord": {
      "enabled": true,
      "botToken": "YOUR_DISCORD_BOT_TOKEN"
    }
  },
  "model": {
    "provider": "anthropic",
    "model": "claude-sonnet-4-20250514",
    "apiKey": "sk-ant-xxx..."
  }
}

🔐 安全提醒：建议使用环境变量而非直接在配置文件写敏感信息。

渠道配置详解

Telegram 配置步骤

Step 1：创建 Bot

1. 打开 Telegram，搜索 @BotFather
2. 发送 /newbot 命令
3. 给 Bot 起个名字（如'我的 AI 助手'）
4. 设置用户名（必须以 _bot 结尾）
5. 复制 Bot Father 返回的 Token

Step 2：配置 OpenClaw

openclaw config set channels.telegram.botToken "你的 Token"

Step 3：启动并测试

openclaw gateway

在 Telegram 中搜索 Bot 用户名，发送 /start 进行配对。

Discord 配置步骤

Step 1：创建 Discord 应用

1. 访问 https://discord.com/developers/applications
2. 点击'New Application'

Step 2：创建 Bot

1. 进入'Bot'页面
2. 点击'Add Bot'
3. 复制 Bot Token（记得开启 Message Content Intent）

Step 3：邀请 Bot 到服务器

1. 进入'OAuth2' -> 'URL Generator'
2. 勾选 bot 权限
3. 复制生成的 URL，在浏览器中打开并选择服务器

启动与验证

启动 Gateway：

# 前台运行（查看日志）
openclaw gateway --verbose

# 后台运行
openclaw gateway &

验证状态：

openclaw health

打开控制台，浏览器访问 http://127.0.0.1:18789。

常见问题汇总

Q1：启动报错'Port 18789 already in use'

lsof -i :18789
# 或者换端口
openclaw gateway --port 18790

Q2：Telegram Bot 发消息没反应

1. 检查 Bot Token 是否正确
2. 确保已经和 Bot 发起对话（需要先私聊 /start）
3. 查看日志：openclaw gateway --verbose

Q3：Discord 提示'Missing Access'

1. 检查 Bot 权限是否足够
2. 确保 Bot 已在服务器中
3. 在 Discord Developer Portal 检查 Intents 设置

注意事项

1. 网络安全：部署在公网时务必配置访问密码
2. Token 消耗：AI 对话需要消耗 API Token，注意费用
3. 隐私安全：不要在对话中输入敏感个人信息
4. 及时更新：关注官方 releases 更新安全补丁

参考资料

• 官方文档：https://docs.openclaw.ai
• GitHub 仓库：https://github.com/openclaw/openclaw
• 问题交流：https://discord.com/invite/clawd