OpenClaw 完整安装指南：打造你的个人 AI 助理
OpenClaw 完整安装指南：打造你的个人 AI 助理
OpenClaw 是一款开源的个人 AI 网关，让你可以把 Claude、GPT、Kimi 等大模型接到 WhatsApp、Telegram、Discord 等聊天工具上。今天手把手教你从零开始部署。
为什么选择 OpenClaw？
- 私有化部署 - 数据完全掌控在自己手里
- 多模型支持 - 本地 Ollama + 云端 API 自由切换
- 多平台消息 - Telegram/WhatsApp/Discord 统一管理
- 自动化工作流 - Cron 定时任务、子代理、记忆系统
- 技能扩展 - ClawHub 生态，随时安装新功能
系统要求
| 项目 | 最低配置 | 推荐配置 |
|---|---|---|
| 操作系统 | Ubuntu 22.04+ | Ubuntu 24.04 LTS |
| CPU | x86_64 双核 | Intel N100 / 4核+ |
| 内存 | 4GB | 8GB+ |
| 存储 | 20GB SSD | 50GB SSD |
| Node.js | v18+ | v22 LTS |
第一步：安装 Node.js
# 使用 nvm 管理 Node.js 版本（推荐）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.bashrc
# 安装 Node.js 22 LTS
nvm install 22
nvm use 22
node -v # 应显示 v22.x.x
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.bashrc
# 安装 Node.js 22 LTS
nvm install 22
nvm use 22
node -v # 应显示 v22.x.x
第二步：安装 OpenClaw CLI
# 全局安装 OpenClaw
npm install -g openclaw
# 验证安装
openclaw --version
npm install -g openclaw
# 验证安装
openclaw --version
第三步：初始化配置
# 创建工作目录
mkdir -p ~/.openclaw/workspace
cd ~/.openclaw/workspace
# 初始化基础配置
openclaw config init
mkdir -p ~/.openclaw/workspace
cd ~/.openclaw/workspace
# 初始化基础配置
openclaw config init
生成的配置文件在 ~/.openclaw/openclaw.json
第四步：配置 Telegram Bot
1. 创建 Bot：在 Telegram 中找 @BotFather，发送 /newbot
2. 编辑配置文件：
{
"plugins": {
"entries": [
{
"name": "telegram",
"enabled": true,
"config": {
"botToken": "YOUR_BOT_TOKEN_HERE",
"allowlist": ["YOUR_TELEGRAM_ID"]
}
}
]
}
}
"plugins": {
"entries": [
{
"name": "telegram",
"enabled": true,
"config": {
"botToken": "YOUR_BOT_TOKEN_HERE",
"allowlist": ["YOUR_TELEGRAM_ID"]
}
}
]
}
}
第五步：配置 AI 模型
支持多种 AI 提供商，这里以本地 Ollama 为例：
# 安装 Ollama
curl -fsSL https://ollama.com/install.sh | sh
# 拉取模型（以 kimi-k2.5 为例）
ollama pull kimi-k2.5
# 配置 Ollama 监听所有地址（供 OpenClaw 调用）
export OLLAMA_HOST=0.0.0.0
ollama serve
curl -fsSL https://ollama.com/install.sh | sh
# 拉取模型（以 kimi-k2.5 为例）
ollama pull kimi-k2.5
# 配置 Ollama 监听所有地址（供 OpenClaw 调用）
export OLLAMA_HOST=0.0.0.0
ollama serve
# 在 openclaw.json 中添加模型配置
"models": {
"providers": {
"ollama": {
"baseUrl": "http://localhost:11434",
"models": ["kimi-k2.5", "qwen3:8b"]
}
}
}
"models": {
"providers": {
"ollama": {
"baseUrl": "http://localhost:11434",
"models": ["kimi-k2.5", "qwen3:8b"]
}
}
}
第六步：启动服务
# 启动 Gateway（Linux 使用 systemd 用户服务）
openclaw gateway start
# 查看状态
openclaw status
# 查看日志
journalctl --user -u openclaw-gateway -f
openclaw gateway start
# 查看状态
openclaw status
# 查看日志
journalctl --user -u openclaw-gateway -f
第七步：安装技能扩展
OpenClaw 的 ClawHub 生态有丰富的技能：
# 搜索可用技能
clawhub search weather
# 安装天气技能
clawhub install weather
# 查看已安装技能
clawhub list
clawhub search weather
# 安装天气技能
clawhub install weather
# 查看已安装技能
clawhub list
常用命令速查
| 命令 | 功能 |
|---|---|
openclaw status | 查看网关状态 |
openclaw gateway restart | 重启网关服务 |
openclaw cron list | 查看定时任务 |
openclaw agent | 启动交互式会话 |
openclaw update | 升级到最新版 |
常见问题
Q: Gateway 启动失败？
检查 Node.js 版本：node -v 需要 v18+。检查端口占用：lsof -i :18789
Q: Telegram 收不到消息？
确认 Bot Token 正确，且已经向 Bot 发送了 /start 命令。
Q: 如何切换 AI 模型？
对话中发送 /model 模型名，如 /model openai/gpt-4o
写在最后
OpenClaw 让每个人都能拥有私人的 AI 助理。它不仅是一个工具，更是通往 AI 自动化工作流的入口。开始你的 OpenClaw 之旅吧！
相关链接：
- 官网：openclaw.ai
- 文档：docs.openclaw.ai
- GitHub：github.com/openclaw/openclaw
- ClawHub：clawhub.com
---
本文由 OpenClaw AI 助理辅助生成，部署于 Intel N100 迷你主机。
评论
发表评论