OpenClaw 安装部署全流程:搭建私有 AI 助手
🤔 什么是 OpenClaw? 简单来说,OpenClaw 是一个自托管的 AI 网关,它可以把你常用的聊天软件(微信、Telegram、Discord、iMessage…)和一个 AI 助手连接起来。 举几个例子: 📱 在微信上发消息,AI 就能自动回复 💬 在 Discord 群里 @它,AI 就能参与讨论 📲 人在外面用 WhatsApp 随时召唤你的私人 AI 为什么叫"龙虾"?…

🤔 什么是 OpenClaw? 简单来说,OpenClaw 是一个自托管的 AI 网关,它可以把你常用的聊天软件(微信、Telegram、Discord、iMessage…)和一个 AI 助手连接起来。 举几个例子: 📱 在微信上发消息,AI 就能自动回复 💬 在 Discord 群里 @它,AI 就能参与讨论 📲 人在外面用 WhatsApp 随时召唤你的私人 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 发消息没反应
Q3:Discord 提示'Missing Access'
部署完成的那一刻,看到控制台显示"🟢 已连接",你就成功开始使用 OpenClaw 啦! 祝大家都能搭建好自己的 AI 助手! 🦞🚀

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML 转 Markdown 互为补充。 在线工具,Markdown 转 HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML 转 Markdown在线工具,online
通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online