───
从零开始：搭建OpenClaw并配置Telegram详细教程
前言
在当今数字化时代，拥有一个属于自己的AI助手已经成为可能。OpenClaw作为一个开源的AI助手框架，让我们可以在自己的服务器上运行一个强大的AI助手，支持多种通讯工具，包括Telegram、微信等。
本文将详细介绍如何在服务器上搭建OpenClaw，并配置Telegram机器人，让你拥有自己的私人AI助手。
第一章：准备工作
1.1 什么是OpenClaw？
OpenClaw是一个开源的个人AI助手框架，具有以下特点：
| 特点 | 说明 |
| —— | ————– |
| 开源免费 | 完全免费使用 |
| 本地部署 | 数据保存在本地，隐私安全 |
| 多平台支持 | 支持Telegram、微信等 |
| 可自定义 | 可以训练自己的AI |
| 7×24运行 | 持续运行不用关机 |
1.2 需要的设备
方案一：自己的电脑
| 设备 | 要求 |
| — | ———————- |
| 电脑 | 能开机就行 |
| 系统 | Linux/Mac/Windows(WSL) |
| 网络 | 宽带上网 |
方案二：VPS服务器（推荐）
| 配置 | 最低要求 | 推荐配置 |
| — | —- | —- |
| CPU | 1核 | 2核 |
| 内存 | 2GB | 4GB |
| 硬盘 | 10GB | 20GB |
| 带宽 | 1M | 5M |
推荐的VPS服务商：
| 服务商 | 价格/月 | 特点 |
| ———— | —- | —– |
| 腾讯云 | 60元起 | 国内速度快 |
| 阿里云 | 60元起 | 稳定 |
| 搬瓦工 | 30元起 | 便宜 |
| DigitalOcean | 5美元起 | 国外 |
1.3 注册Telegram账号
如果没有Telegram账号，按照以下步骤注册：
1. 下载Telegram应用（手机/电脑）
2. 用手机号注册
3. 验证手机号
4. 设置用户名和头像
1.4 准备工具
| 工具 | 说明 |
| ————– | —————– |
| 电脑 | 用于远程连接服务器 |
| Xshell或Termius | SSH远程连接工具 |
| 文本编辑器 | Notepad++/VS Code |
───
第二章：服务器环境配置
2.1 连接服务器
Windows用户：
1. 下载Xshell：https://www.xshell.com/
2. 安装后打开
3. 新建连接：
• 主机：你的服务器IP
• 端口：22
• 用户名：root
• 密码：服务器密码
Mac/Linux用户：
直接打开终端，输入：
ssh root@你的服务器IP
2.2 安装Node.js
OpenClaw需要Node.js环境，按以下步骤安装：
方法一：使用fnm（推荐）
# 安装fnm
curl -fsSL https://fnm.vercel.app/install | bash
# 加载fnm
source ~/.bashrc
# 安装Node.js 18.x
fnm install 18
fnm use 18
# 验证安装
node –version
方法二：直接安装
# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash –
sudo apt-get install -y nodejs
# 验证
node –version
npm –version
2.3 安装Git
# Ubuntu/Debian
apt-get update
apt-get install -y git
# 验证
git –version
───
第三章：安装OpenClaw
3.1 安装OpenClaw
# 安装OpenClaw
npm install -g openclaw@latest
# 验证安装
openclaw –version
3.2 初始化OpenClaw
# 初始化
openclaw init
初始化过程中需要配置：
| 配置项 | 说明 | 示例 |
| —– | ——— | ———– |
| 数据目录 | 保存数据的位置 | ~/.openclaw |
| API密钥 | 大模型API | 你的API Key |
| 机器人配置 | Telegram等 | 后续配置 |
3.3 目录结构
安装完成后，OpenClaw的目录结构如下：
~/.openclaw/
├── agents/ # Agent配置
├── config.yaml # 主配置文件
├── cron/ # 定时任务
├── logs/ # 日志文件
├── scripts/ # 脚本文件
├── skills/ # 技能包
├── memory/ # 记忆存储
└── workspace/ # 工作目录
───
第四章：配置Telegram机器人
4.1 创建Telegram机器人
1. 打开Telegram
2. 搜索 @BotFather
3. 发送 /newbot
4. 按提示输入机器人名称（必须以bot结尾）
5. 例如：my_helper_bot
6. 获取Bot Token（类似：123456789:ABCdefGHIjklMNOpqrsTUVwxyz）
重要：保存好这个Token！
4.2 获取Chat ID
1. 搜索 @userinfobot
2. 发送 /start
3. 会显示你的ID（类似：123456789）
保存好这个ID！
4.3 配置OpenClaw
# 编辑配置文件
nano ~/.openclaw/config.yaml
添加Telegram配置：
telegram:
enabled: true
bot_token: “你的BotToken”
chat_id: “你的ChatID”
4.4 完整配置示例
# OpenClaw 主配置文件
# Telegram配置
telegram:
enabled: true
bot_token: “123456789:ABCdefGHIjklMNOpqrsTUVwxyz”
chat_id: “123456789”
# 模型配置
models:
default: minimax-portal/MiniMax-M2.1
# Agent配置
agents:
defaults:
thinking: false
model: minimax-portal/MiniMax-M2.1
4.5 重启OpenClaw
openclaw restart
4.6 测试Telegram
1. 打开Telegram
2. 搜索你创建的机器人
3. 发送 /start
4. 应该会收到回复
───
第五章：常见问题解决
5.1 无法连接服务器
| 问题 | 解决 |
| —- | ——– |
| 密码错误 | 检查密码是否正确 |
| 连接超时 | 检查防火墙 |
| 端口被拒 | 检查22端口 |
# 检查端口
netstat -tulpn | grep 22
5.2 Node.js安装失败
| 问题 | 解决 |
| —- | —– |
| 权限错误 | 加sudo |
| 版本不对 | 重新安装 |
# 清理后重装
rm -rf ~/.fnm
curl -fsSL https://fnm.vercel.app/install | bash
5.3 Telegram收不到消息
1. 检查Token是否正确
2. 检查Chat ID是否正确
3. 检查配置是否生效
# 查看日志
openclaw logs
5.4 Bot被限制
| 原因 | 解决 |
| —- | —— |
| 频繁发送 | 降低频率 |
| 敏感内容 | 检查消息内容 |
───
第六章：高级配置
6.1 配置定时任务
OpenClaw支持定时任务，可以在配置文件中添加：
cron:
enabled: true
jobs:
– name: “天气推送”