OpenClaw完全教程:搭建你的私人AI助手网关(详细步骤)
OpenClaw是一个开源的AI网关,可以让你通过WhatsApp、Telegram、Discord、飞书等聊天平台接入AI助手。本文将详细介绍如何部署和配置OpenClaw。一、OpenClaw是什么?
OpenClaw是一个自托管的AI网关,核心功能:
-
多平台接入:一个网关同时支持WhatsApp、Telegram、Discord、飞书、iMessage等
-
完全控制:运行在自己的服务器上,数据完全由你掌控
-
AI原生:支持工具调用、会话管理、记忆系统、多Agent路由
-
开源免费:MIT许可证,社区驱动
二、系统要求
硬件要求:
-
CPU:1核以上
-
内存:512MB以上
-
硬盘:1GB以上
软件要求:
-
操作系统:Linux / macOS / Windows
-
Node.js:22.0.0或更高版本
-
npm:10.0.0或更高版本
支持的聊天平台:
|
平台 |
支持方式 |
难度 |
|---|---|---|
|
|
扫描二维码登录 |
⭐ 简单 |
|
Telegram |
Bot Token |
⭐ 简单 |
|
Discord |
Bot Token |
⭐⭐ 中等 |
|
飞书 |
企业自建应用 |
⭐⭐ 中等 |
|
iMessage |
macOS专用 |
⭐⭐⭐ 复杂 |
三、安装OpenClaw
步骤1:安装Node.js
Ubuntu/Debian系统:
# 添加Node.js源
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
# 安装Node.js
sudo apt install -y nodejs
# 验证安装
node --version
npm --version
步骤2:安装OpenClaw
# 全局安装OpenClaw
npm install -g openclaw@latest
# 验证安装
openclaw --version
步骤3:初始化配置
# 运行配置向导
openclaw onboard --install-daemon
四、接入聊天平台
4.1 接入Telegram
步骤1:创建Telegram Bot
-
在Telegram中搜索 @BotFather
-
发送 /newbot 命令
-
按提示输入Bot名称和用户名
-
复制获得的Bot Token
步骤2:配置OpenClaw
openclaw channels login telegram
步骤3:启动网关
openclaw gateway --port 18789
4.2 接入Discord
步骤1:创建Discord应用
- 访问 Discord开发者门户
-
点击"New Application"创建应用
-
在"Bot"页面点击"Add Bot"
-
复制Bot Token
-
用链接邀请Bot加入你的服务器
步骤2:配置OpenClaw
openclaw channels login discord
4.3 接入飞书
步骤1:创建飞书企业自建应用
- 访问飞书开放平台
-
创建企业自建应用
-
配置应用权限
-
发布应用版本
步骤2:配置OpenClaw
{
"plugins": {
"entries": {
"feishu": {
"enabled": true,
"appId": "your_app_id",
"appSecret": "your_app_secret"
}
}
}
}
五、启动网关
前台启动:
openclaw gateway --port 18789
后台运行:
pm2 start 'openclaw gateway --port 18789' --name openclaw-gateway
pm2 save
pm2 startup
六、配置AI模型
支持的模型提供商:
-
百度千帆(推荐国内用户)
-
Anthropic Claude
-
OpenAI GPT-4
-
Google Gemini
-
Azure OpenAI
-
本地模型(Ollama等)
配置示例(百度千帆):
{
"provider": {
"name": "baiduqianfancodingplan",
"model": "qianfan-code-latest"
}
}
七、常见问题
Q1: 网关启动失败?
A: 检查端口是否被占用:
lsof -i :18789
Q2: Telegram Bot不回复?
A: 检查Bot Token是否正确,确认Bot未被封禁。
Q3: 如何查看日志?
pm2 logs openclaw-gateway
八、安全建议
-
限制访问IP:只允许特定IP访问网关
-
使用HTTPS:配置SSL证书加密通信
-
设置认证Token:防止未授权访问
-
定期更新:保持最新版本
-
备份配置:定期备份 ~/.openclaw/ 目录
总结
OpenClaw是一个强大的AI网关,让你可以在任何聊天平台上使用AI助手。通过本文的教程,你应该能够:
-
成功安装OpenClaw
-
接入Telegram、Discord、飞书等平台
-
配置AI模型和权限
-
解决常见问题
更多文档:
社区:
https://discord.com/invite/clawd
💡 觉得有帮助的话,点个赞支持一下!我会持续分享AI工具教程,欢迎关注!
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。
更多推荐


所有评论(0)