OpenClaw 安装部署全流程 - 搭建自托管 AI 助手
OpenClaw 是一款自托管 AI 网关工具,支持将微信、Telegram、Discord 等聊天软件与 AI 助手连接。环境准备(Node.js 22+)、三种安装方式(macOS 应用、CLI 命令行、Docker 容器)、基础配置文件结构及 Telegram 和 Discord 渠道的具体对接步骤。内容涵盖启动验证、常见报错处理及安全注意事项,适合希望搭建私人 AI 助手的开发者参考。

OpenClaw 是一款自托管 AI 网关工具,支持将微信、Telegram、Discord 等聊天软件与 AI 助手连接。环境准备(Node.js 22+)、三种安装方式(macOS 应用、CLI 命令行、Docker 容器)、基础配置文件结构及 Telegram 和 Discord 渠道的具体对接步骤。内容涵盖启动验证、常见报错处理及安全注意事项,适合希望搭建私人 AI 助手的开发者参考。

简单来说,OpenClaw 是一个自托管的 AI 网关,它可以把你常用的聊天软件(微信、Telegram、Discord、iMessage…)和一个 AI 助手连接起来。
举几个例子:
为什么叫'龙虾'?
| 配置 | 最低要求 | 推荐配置 |
|---|---|---|
| 操作系统 | macOS 10.15+ / Linux / Windows WSL2 | macOS 12+ |
| 内存 | 8GB | 16GB+ |
| 存储空间 | 5GB | 20GB+ |
| 网络 | 能访问国际互联网 | 稳定带宽 |
# 检查 Node.js 版本(需要 Node 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
如果你用的是 Mac,强烈推荐使用官方 App,体验最丝滑:
# 方法 1:直接下载安装包
# 访问 https://github.com/openclaw/openclaw/releases 下载 .dmg 文件
# 方法 2:使用 Homebrew
brew install openclaw/tap/openclaw
安装完成后,打开 OpenClaw.app,它会出现在菜单栏。
这是最通用的安装方式,Linux/Windows WSL/Mac 通用:
# 1. 全局安装 OpenClaw CLI
npm install -g openclaw
# 2. 验证安装
openclaw --version
# 3. 初始化设置
openclaw setup
运行 openclaw setup 后,会出现交互式引导,按提示选择即可。
⚠️ 注意:有些渠道需要额外配置,比如 Telegram 需要先找 @BotFather 申请 Bot Token,Discord 需要创建开发者应用。
如果你是部署在服务器上,Docker 是最省心的选择:
# 1. 拉取镜像
docker pull openclaw/openclaw:latest
# 2. 创建配置目录
mkdir -p ~/.openclaw
# 3. 运行容器
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..."
🔐 安全提醒:建议使用环境变量而非直接在配置文件写敏感信息
Step 1:创建 Bot
_bot 结尾)Step 2:配置 OpenClaw
openclaw config set channels.telegram.botToken "你的 Token"
Step 3:启动并测试
openclaw gateway # 在 Telegram 中搜索你的 Bot 用户名,发送 /start 进行配对
Step 1:创建 Discord 应用
Step 2:创建 Bot
Step 3:邀请 Bot 到服务器
启动 Gateway
# 前台运行(查看日志)
openclaw gateway --verbose
# 后台运行
openclaw gateway &
验证
openclaw health
打开控制台
浏览器访问 http://127.0.0.1:18789
用户发送消息 → 聊天渠道 → Gateway → AI Model → 返回消息
Q1:启动报错'Port 18789 already in use'
lsof -i :18789 # 或者换端口
openclaw gateway --port 18790
Q2:Telegram Bot 发消息没反应
openclaw gateway --verboseQ3:Discord 提示'Missing Access'

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online
JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online
Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online