跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptNode.jsWeChatAI

OpenClaw 自托管 AI 网关安装部署全流程

OpenClaw 是一款支持多平台的自托管 AI 网关工具,可将微信、Telegram 等聊天软件接入本地 AI 模型。详细记录了从环境准备、三种安装方式(macOS App、CLI、Docker)、渠道配置到启动验证的完整流程,重点说明了安全配置与常见问题排查,适合希望搭建私有化 AI 助手的开发者参考。

kaikai发布于 2026/3/28更新于 2026/10/25101 浏览
OpenClaw 自托管 AI 网关安装部署全流程

OpenClaw 是一个自托管的 AI 网关,核心功能是将你常用的聊天软件(微信、Telegram、Discord 等)与本地或云端的 AI 模型连接起来。通过它,你可以在微信上发消息获得 AI 回复,或在 Discord 群聊中让 AI 参与讨论。

环境准备

硬件要求
配置最低要求推荐配置
操作系统macOS 10.15+ / Linux / Windows WSL2macOS 12+
内存8GB16GB+
存储空间5GB20GB+
网络能访问国际互联网稳定带宽
软件依赖

OpenClaw 基于 Node.js 运行,建议版本为 22+。

# 检查当前 Node 版本
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

安装方式

根据使用场景,有三种主流安装方案。

1. macOS 原生应用

体验最丝滑,适合桌面端开发调试。

# 方法 A:下载 DMG 安装包
# 访问 https://github.com/openclaw/openclaw/releases 获取最新 .dmg 文件

# 方法 B:Homebrew 安装
brew install openclaw/tap/openclaw

安装完成后,菜单栏会出现 OpenClaw 图标,点击即可启动。

2. 命令行工具(跨平台)

适用于 Linux、WSL 或需要脚本化部署的场景。

# 全局安装 CLI
npm install -g openclaw

# 验证版本
openclaw --version

# 交互式初始化
openclaw setup

运行 setup 后会引导选择配置项,按提示操作即可。注意部分渠道(如 Telegram)需提前准备好 Bot Token。

3. 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..."
  }
}

安全建议:生产环境强烈建议使用环境变量存储敏感信息(如 API Key),避免明文写入配置文件。

渠道配置详解

Telegram 接入
  1. 创建 Bot:在 Telegram 搜索 @BotFather,发送 /newbot,按提示命名并获取 Token。
  2. 配置 OpenClaw:
    openclaw config set channels.telegram.botToken "你的 Token"
    
  3. 测试:启动网关后,在 Telegram 搜索 Bot 用户名并发送 /start。
Discord 接入
  1. 创建应用:访问 Discord Developer Portal,新建 Application。
  2. 启用 Bot:在 Bot 页面添加机器人,复制 Token(记得开启 Message Content Intent)。
  3. 邀请到服务器:进入 OAuth2 -> URL Generator,勾选 bot 权限,生成链接并在浏览器打开授权。

启动与验证

启动网关服务:

# 前台运行(查看实时日志)
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 无响应 检查 Token 是否正确,确保已私聊 Bot 发送过 /start,并通过 --verbose 查看详细日志。

Q3:Discord 权限不足 确认 Bot 已在服务器内,且 Developer Portal 中的 Intents 设置已开启消息内容读取权限。

注意事项

  1. 网络安全:公网部署务必配置访问密码或限制 IP。
  2. Token 成本:AI 对话消耗 API Token,请留意费用预算。
  3. 隐私保护:避免在对话中输入个人敏感信息。
  4. 及时更新:关注官方 Releases 以获取安全补丁。

参考资料

  • 官方文档:https://docs.openclaw.ai
  • GitHub 仓库:https://github.com/openclaw/openclaw

目录

  1. 环境准备
  2. 硬件要求
  3. 软件依赖
  4. 检查当前 Node 版本
  5. 安装方式
  6. 1. macOS 原生应用
  7. 方法 A:下载 DMG 安装包
  8. 访问 https://github.com/openclaw/openclaw/releases 获取最新 .dmg 文件
  9. 方法 B:Homebrew 安装
  10. 2. 命令行工具(跨平台)
  11. 全局安装 CLI
  12. 验证版本
  13. 交互式初始化
  14. 3. Docker 容器部署
  15. 拉取镜像
  16. 创建配置目录
  17. 启动容器
  18. 详细配置
  19. 渠道配置详解
  20. Telegram 接入
  21. Discord 接入
  22. 启动与验证
  23. 前台运行(查看实时日志)
  24. 后台运行
  25. 常见问题排查
  26. 注意事项
  27. 参考资料

更多推荐文章

查看全部
  • C++容器:stack、queue、deque 基本用法详解
  • MySQL 数据类型详解:选型要点与避坑指南
  • 使用 OpenClaw 与飞书搭建 AI 机器人
  • VS Code Copilot 在 Win10 WSL2 环境下连接失败问题排查
  • 前端视角:从零搭建并启动若依后端环境
  • Coze 智能体开发:插件、知识库与数据库全解析
  • VS Code 运行前端代码教程
  • MIT 电机模式控制详解:参数配置与调试实战
  • MCP 数据加密方法解析:5 大主流算法对比及选型指南
  • Python 应用打包为 Android APK 指南
  • Cursor 中集成 MCP 服务实战指南
  • Replay AI 翻唱工具教程:音轨分离与音色替换
  • 基于 Trae 构建本地 AI 对话机器人
  • JavaAI 插件安装与自动化开发实战指南
  • 家居家电行业的大模型落地路径
  • Spring AI MCP Server 集成与源码解析
  • 文心一言开源模型部署及多维度测评
  • 企业级 AI 视频管理平台功能详解:算法商城与集群管理
  • WSL2 + Linux + VS Code 远程开发入门教程
  • 非科班转码者的 AI 学习路径:从 0 到 1

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online