OpenClaw 一键部署工具使用教程

📖 项目简介

OpenClawInstaller 是 OpenClaw 私人 AI 助手的一键部署工具。只需一行命令，即可在你的服务器上部署一个功能强大的 AI 管家，支持多种大模型接入和多平台消息渠道。

OpenClaw 不仅仅是一个聊天机器人，它具备持久记忆、主动推送、技能系统和远程控制能力，可以真正成为你的全天候 AI 助手。

💡

GitHub 地址： https://github.com/miaoxworld/OpenClawInstaller

✨ 核心亮点

🚀

一键部署

一行命令完成环境检测、依赖安装、AI 配置、服务启动全流程

🤖

多模型支持

Claude、GPT、Gemini、Groq、Mistral、Ollama 等主流模型一键切换

📱

7大渠道接入

Telegram、Discord、WhatsApp、微信、飞书、Slack、iMessage

🧠

持久记忆

跨对话、跨平台的长期记忆能力，AI 助手越用越懂你

🔔

主动推送

定时提醒、晨报、告警通知，不用等你提问就能主动服务

🛠️

技能系统

Markdown 定义自定义技能，轻松扩展 AI 能力边界

💻 系统要求

项目	要求
操作系统	macOS 12+ / Ubuntu 20.04+ / Debian 11+ / CentOS 8+
Node.js	v22 或更高版本
内存	最低 2GB，推荐 4GB+
磁盘空间	最低 1GB

⚠️

建议使用专用服务器或虚拟机部署，不要在主工作电脑上运行。AWS/GCP/Azure 免费实例是不错的选择。

🚀 快速开始

方式一：一键安装（推荐）

运行安装命令

在终端执行以下命令即可开始安装：

                        bash
                        curl -fsSL https://raw.githubusercontent.com/miaoxworld/OpenClawInstaller/main/install.sh | bash
                    

按向导完成配置

安装脚本会自动完成以下步骤：

检测系统环境并安装依赖
安装 OpenClaw 核心程序
引导配置 AI 模型（选择模型 + 输入 API Key）
测试 API 连接
自动启动 OpenClaw 服务

配置消息渠道

启动后可选择打开配置菜单，接入 Telegram、Discord、微信等渠道：

                        bash
                        bash ~/.openclaw/config-menu.sh
                    

方式二：手动安装

                bash
                # 克隆仓库
git clone https://github.com/miaoxworld/OpenClawInstaller.git
cd OpenClawInstaller

# 添加执行权限并运行
chmod +x install.sh config-menu.sh
./install.sh
            

桌面版（图形界面）

如果更喜欢图形界面，可以使用 OpenClaw Manager 桌面应用：

基于 Tauri 2.0 + React + TypeScript + Rust 构建
仪表盘实时监控服务状态
可视化配置 AI 模型和消息渠道
支持 macOS、Windows、Linux 跨平台

📥

下载地址： github.com/miaoxworld/openclaw-manager

🤖 支持的 AI 模型

类别	服务商	推荐模型
主流服务商	Anthropic Claude	claude-sonnet-4-5（支持自定义 API 地址）
主流服务商	OpenAI GPT	gpt-4o / gpt-4o-mini
主流服务商	Google Gemini	gemini-2.0-flash
多模型网关	OpenRouter	一个 Key 用遍所有模型
快速推理	Groq	llama-3.3-70b-versatile
快速推理	Mistral AI	mistral-large-latest
本地部署	Ollama	llama3 / mistral（无需 API Key）

💡

Claude 和 GPT 都支持自定义 API 地址，可接入 OneAPI/NewAPI 等中转服务。

📱 消息渠道接入

✈️

通过 BotFather 创建 Bot，输入 Token 即可

💬

Discord

Developer Portal 创建 Bot 应用并邀请到服务器

📲

扫码登录即可，无需 Business API

💚

微信

接入微信，随时随地使用 AI 助手

🐦

飞书

WebSocket 长连接，无需公网服务器

💼

Slack

团队协作场景的 AI 助手接入

📝 常用命令

服务管理

                bash
                # 启动服务（后台守护进程）
openclaw gateway start

# 停止 / 重启 / 查看状态
openclaw gateway stop
openclaw gateway restart
openclaw gateway status

# 查看实时日志
openclaw logs --follow
            

配置管理

                bash
                # 打开配置
openclaw config

# 运行诊断
openclaw doctor

# 健康检查
openclaw health
            

❓ 常见问题

Q: Node.js 版本过低怎么办？

                bash
                # macOS
brew install node@22

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
            

Q: Telegram 机器人没有响应？

检查以下几点：① 确认 Bot Token 正确；② 确认 User ID 在 allowed_users 列表中；③ 检查网络连接（可能需要代理）。

Q: 如何更新到最新版本？

                bash
                # npm 更新
npm update -g openclaw

# 或通过配置菜单更新
bash ~/.openclaw/config-menu.sh
# 选择 [7] 高级设置 → [7] 更新 OpenClaw
            

Q: 如何完全卸载？

                bash
                openclaw gateway stop
npm uninstall -g openclaw
rm -rf ~/.openclaw
            

💬 加入交流群

和志同道合的朋友一起交流学习

抖音扫码加入