OpenClaw 一键安装教程

🚀 什么是 OpenClaw

OpenClaw 是一个开源的 AI 助手部署框架，让您能够轻松将大语言模型接入各种聊天平台。无论是 Telegram、微信、Discord 还是其他平台，OpenClaw 都能帮助您快速构建智能对话机器人。

⚡ 快速部署

一键安装脚本，5 分钟完成全部配置

🔌 多平台支持

支持 Telegram、微信、Discord 等主流平台

🧠 模型灵活

兼容多种大语言模型，自由选择

🛡️ 安全可靠

本地部署，数据完全掌控

📋 系统要求

在开始安装之前，请确保您的服务器满足以下最低要求：

项目	最低要求	推荐配置
操作系统	Ubuntu 20.04 / Debian 11	Ubuntu 22.04 LTS
CPU	2 核心	4 核心或更高
内存	2 GB	4 GB 或更高
存储	10 GB	20 GB SSD
网络	可访问外网	固定公网 IP

                💡 提示：如果您计划运行本地大模型，建议使用更高配置的服务器（8GB+ 内存，GPU 加速更佳）。
            

📦 一键安装

OpenClaw 提供了一键安装脚本，自动完成所有依赖安装和配置。

下载安装脚本

curl -fsSL https://openclaw.dev/install.sh -o install.sh

赋予执行权限

chmod +x install.sh

运行安装脚本

sudo ./install.sh

安装脚本将自动完成以下操作：

安装 Docker 和 Docker Compose
下载 OpenClaw 最新镜像
创建配置文件和目录结构
配置 Nginx 反向代理
启动所有服务

✅ 安装完成！ 看到 "OpenClaw 已成功安装" 提示后，请继续下一步配置。

⚙️ 配置指南

安装完成后，需要配置环境变量和平台凭证。

编辑配置文件

nano /opt/openclaw/.env

配置必要参数

# OpenClaw 基础配置
OPENCLAW_PORT=8080
OPENCLAW_HOST=0.0.0.0

# 大模型配置（任选其一）
LLM_PROVIDER=openai
OPENAI_API_KEY=your-api-key-here
OPENAI_MODEL=gpt-4o

# 或配置其他模型
# LLM_PROVIDER=anthropic
# ANTHROPIC_API_KEY=your-key-here

# 或配置本地模型
# LLM_PROVIDER=ollama
# OLLAMA_HOST=http://localhost:11434

重启服务

cd /opt/openclaw
docker compose restart

                🔐 安全提示：请妥善保管您的 API 密钥，不要将其提交到版本控制系统或分享给他人。
            

🔌 接入聊天平台

OpenClaw 支持多种聊天平台，选择您要接入的平台并按照指引配置。

📱 Telegram

联系 @BotFather 创建新 Bot
获取 Bot Token
在 .env 文件中添加：
TELEGRAM_BOT_TOKEN=your-token
重启服务

💬 微信

使用微信个人号或企业微信
配置微信回调地址
在 .env 文件中添加：
WECHAT_TOKEN=your-token
WECHAT_ENCODING_AES_KEY=your-key
重启服务

🎮 Discord

在 Discord 开发者门户创建应用
获取 Bot Token 和 Application ID
在 .env 文件中添加：
DISCORD_BOT_TOKEN=your-token
DISCORD_CLIENT_ID=your-id
重启服务

🌐 Webhook

配置 Webhook 端点
设置认证密钥
在 .env 文件中添加：
WEBHOOK_SECRET=your-secret
重启服务

# 完整配置示例
TELEGRAM_BOT_TOKEN=1234567890:ABCdefGHIjklMNOpqrsTUVwxyz
WECHAT_TOKEN=your-wechat-token
WECHAT_ENCODING_AES_KEY=your-aes-key
DISCORD_BOT_TOKEN=MTIzNDU2Nzg5MDEyMzQ1Njc4OQ.GHIjKL.MNOpqrSTUvwxYZabcDEFghiJKLmno
DISCORD_CLIENT_ID=1234567890123456789

❓ 常见问题 FAQ

安装脚本报错 "Permission denied" 怎么办？

请确保使用 sudo 运行安装脚本，或先执行 chmod +x install.sh 赋予执行权限。

如何查看 OpenClaw 运行状态？

使用以下命令查看服务状态和日志：

cd /opt/openclaw
docker compose ps
docker compose logs -f

如何更新 OpenClaw 到最新版本？

运行以下命令更新：

cd /opt/openclaw
docker compose pull
docker compose up -d

支持哪些大语言模型？

OpenClaw 支持多种模型提供商：

OpenAI (GPT-4, GPT-3.5)
Anthropic (Claude 系列)
Google (Gemini)
本地模型 (Ollama, LM Studio)
以及其他兼容 OpenAI API 的服务

如何备份和恢复配置？

配置文件位于 /opt/openclaw/ 目录，备份该目录即可。恢复时复制回原位置并重启服务。

遇到问题如何获取帮助？

您可以通过以下方式获取帮助：

查看官方文档：openclaw.dev/docs
提交 GitHub Issue
加入社区讨论群