Python
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