开源免费 · 多渠道AI助手

OpenClaw
保姆级安装使用教程

部署你的开源AI私人助手,一次配置多渠道接入。支持 Telegram、Discord、微信、飞书等10+平台,多模型自由切换。

10+
消息渠道
7+
AI模型商
开源
完全免费
🧠
持久记忆
广告

什么是 OpenClaw?

OpenClaw 是一款开源的AI私人助手,可部署在你的服务器上,通过多种消息渠道与你交互。它拥有持久记忆、主动推送、技能系统等核心能力,是你真正的AI管家。

🧠

持久记忆

跨对话、跨平台的长期记忆能力,记住你的偏好和历史上下文

📱

多渠道接入

Telegram/Discord/微信/飞书/WhatsApp/Slack等10+平台

🔔

主动推送

定时提醒、晨报、告警通知,AI主动找你而非等你提问

技能系统

通过Markdown文件定义自定义能力,无限扩展AI功能

🌐

远程控制

可执行系统命令、读写文件、浏览网络,真正的AI助手

🤖

多模型支持

Claude/GPT/Gemini/Ollama等,一个助手切换所有模型

与同类工具对比

特性OpenClawClaude CodeChatGPT Bot
开源免费✅ 完全开源❌ 闭源付费❌ 闭源付费
自托管✅ 自有服务器❌ 云端服务❌ 云端服务
多渠道✅ 10+平台❌ 仅终端/IDE⚠️ 有限渠道
持久记忆✅ 跨平台记忆⚠️ 会话级⚠️ 有限
隐私控制✅ 数据完全自有❌ 数据上传❌ 数据上传
主动推送✅ 定时/告警❌ 被动响应❌ 被动响应
广告

OpenClaw 适合谁?

OpenClaw 的核心价值在于"拥有一个真正属于你的AI助手",特别适合对隐私、定制化有需求的用户。

🖥️ 技术爱好者 🔒 隐私敏感用户 🏢 小团队/创业公司 🤖 AI爱好者 📱 多平台用户 🏠 智能家居玩家 📊 效率工具控 🛠️ 运维/DevOps

设备与环境要求

OpenClaw 可部署在本地电脑或云服务器上,选择灵活。

系统要求

操作系统
macOS 12+ / Ubuntu 20.04+ / Win WSL2
推荐Linux服务器长期运行
Node.js
v22+(推荐v24)
必须安装,核心运行环境
内存
最低2GB / 推荐4GB+
AI计算在云端,本地占用少
磁盘空间
最低1GB
含依赖和缓存

部署方案对比

方案月成本优点缺点推荐度
本地电脑免费零成本、数据绝对安全需保持开机、断电断网即离线⭐⭐⭐
VPS云服务器¥30-80/月7×24在线、稳定可靠需基础Linux运维能力⭐⭐⭐⭐⭐
树莓派一次性¥300+低功耗常开、有趣好玩性能有限、SD卡易损⭐⭐⭐⭐
Docker部署同上环境隔离、一键部署需Docker基础⭐⭐⭐⭐
💡 新手推荐方案

如果你是新手,推荐从本地电脑开始体验(零成本),熟悉后再迁移到VPS服务器实现7×24在线。推荐服务商:腾讯云轻量服务器(¥34/月起)、Vultr($6/月起)。

保姆级安装流程

三种安装方式任选,推荐使用一键安装脚本,5分钟搞定。

0

前置准备:安装 Node.js

OpenClaw 需要 Node.js 22+ 环境,先确认是否已安装:

Bash # 检查 Node.js 版本 node -v # 如果未安装或版本低于22,按以下方式安装: # macOS (Homebrew) brew install node@22 # Ubuntu/Debian (NodeSource) curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt-get install -y nodejs # Windows (Winget) winget install OpenJS.NodeJS
1

方法一:一键安装(推荐)

最简单的方式,脚本自动完成所有步骤:

Bash # macOS / Linux 一键安装 curl -fsSL https://openclaw.ai/install.sh | bash # Windows PowerShell 一键安装 irm https://openclaw.ai/install.ps1 | iex
💡 安装脚本自动完成

① 检测系统环境并安装依赖 → ② 安装 OpenClaw → ③ 引导完成核心配置(AI模型、身份信息)→ ④ 测试API连接 → ⑤ 自动启动Gateway服务

2

方法二:npm 手动安装

更喜欢手动控制每一步?使用 npm 安装:

Bash # 全局安装 OpenClaw npm install -g openclaw@latest # 或使用 pnpm pnpm add -g openclaw@latest # 运行初始化引导向导 openclaw onboard --install-daemon
3

方法三:从源码构建

Bash # 克隆仓库 git clone https://github.com/openclaw/openclaw.git cd openclaw # 安装依赖并构建 pnpm install pnpm ui:build pnpm build # 全局链接并初始化 pnpm link --global openclaw onboard --install-daemon
4

验证安装

Bash # 检查版本 openclaw --version # 运行健康检查 openclaw doctor # 检查Gateway状态 openclaw gateway status # 打开控制面板 openclaw dashboard
🦞
OpenClaw Dashboard 控制面板 - 查看服务状态和聊天

常用管理命令

Bash # 启动Gateway服务 openclaw gateway start # 后台启动 openclaw gateway # 前台运行(可看日志) # 重启 / 停止 openclaw gateway restart openclaw gateway stop # 打开配置菜单 openclaw config # 或使用安装脚本的配置菜单 bash ~/.openclaw/config-menu.sh # 查看运行状态 openclaw status

AI 模型配置详解

OpenClaw 支持多种AI模型提供商,按需配置,随时切换。

Anthropic
Claude Sonnet 4.5 / Opus 4.5
推理能力强,适合复杂任务。支持自定义API地址,可接入中转服务。
OpenAI
GPT-4o / GPT-4o-mini
通用性强,响应快速。自定义地址需支持 v1/responses 接口。
Google
Gemini 2.0 Flash / 1.5 Pro
多模态能力,免费额度较多,适合日常使用。
OpenRouter
多模型网关
一个Key用遍所有模型,Claude/GPT/Gemini随便切换。
Groq
Llama 3.3 70B / Mixtral
超快推理速度,适合实时对话场景。
Ollama
本地部署模型
无需API Key,数据完全本地,隐私首选。需本地GPU。

配置步骤示例(Claude)

Config # 运行配置菜单 openclaw config # 选择 [2] AI 模型配置 # 选择 Anthropic Claude # 步骤: 1. 输入自定义API地址(留空使用官方API) 2. 输入API Key(从 console.anthropic.com 获取) 3. 选择模型(推荐 claude-sonnet-4-5-20250929) # 💡 支持OneAPI/NewAPI等第三方代理服务 # 只需填入对应的API地址和Key即可
⚠️ OpenAI 中转注意事项

使用自定义 OpenAI API 地址时,中转服务必须支持 OpenAI 的 Responses API(v1/responses 路径),而非仅支持传统的 Chat Completions API。请提前确认你的中转服务是否支持。

消息渠道接入指南

OpenClaw 支持10+消息渠道,以下是最常用的几个渠道配置教程。

💬
Telegram
难度:⭐ 最简单
🎮
Discord
难度:⭐⭐
📱
WhatsApp
难度:⭐⭐
💼
Slack
难度:⭐⭐
🇨🇳
微信
难度:⭐⭐⭐
🐦
飞书
难度:⭐⭐
1

Telegram 机器人接入(最简单)

Step by Step # 第一步:创建 Telegram 机器人 1. 在 Telegram 中搜索 @BotFather 2. 发送 /newbot 创建新机器人 3. 设置机器人名称和用户名 4. 复制获得的 Bot Token # 第二步:获取你的 User ID 1. 搜索 @userinfobot 2. 发送任意消息获取你的 User ID # 第三步:在 OpenClaw 中配置 openclaw config # 选择渠道 → Telegram → 输入 Bot Token 和 User ID # 第四步:重启 Gateway openclaw gateway restart
💡 推荐首选 Telegram

Telegram 是配置最简单的渠道,只需要一个 Bot Token 即可。且 Telegram Bot API 稳定、功能丰富,支持文件发送、内联按钮等高级功能。

2

Discord 机器人接入

Step by Step # 第一步:创建 Discord 应用 1. 访问 Discord Developer Portal 2. 点击 "New Application" 创建新应用 3. 在 Bot 页面点击 "Add Bot" 4. 复制 Bot Token # 第二步:邀请机器人到服务器 1. 在 OAuth2 页面生成邀请链接 2. 勾选 bot 权限范围 3. 用链接邀请机器人到你的服务器 # 第三步:在 OpenClaw 中配置 openclaw config # 选择渠道 → Discord → 输入 Bot Token

实战案例详解

案例1:搭建私人Telegram AI助手

目标

在VPS上部署OpenClaw,接入Telegram,拥有一个7×24在线的私人AI助手。

Full Guide # 1. SSH连接到VPS ssh user@your-vps-ip # 2. 安装 Node.js curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt-get install -y nodejs # 3. 一键安装 OpenClaw curl -fsSL https://openclaw.ai/install.sh | bash # 4. 配置AI模型(以 Claude 为例) openclaw config # 选择 Anthropic Claude → 输入API Key # 5. 配置 Telegram 渠道 # 选择渠道 → Telegram → 输入 Bot Token # 6. 启动服务 openclaw gateway start # 7. 在 Telegram 中找到你的机器人,发消息测试!

案例2:配置晨报推送技能

Skill # OpenClaw 技能系统使用 Markdown 文件定义 # 在 ~/.openclaw/skills/ 目录下创建晨报技能: # morning-briefing.md --- name: 晨报推送 trigger: cron(0 8 * * *) # 每天早上8点触发 channel: telegram --- ## 指令 请为我生成今日晨报,包含以下内容: 1. 今日天气(基于我的城市:上海) 2. 科技新闻摘要(3条) 3. 今日待办提醒 4. 一句正能量语录

案例3:使用 Ollama 实现完全本地化

Bash # 第一步:安装 Ollama curl -fsSL https://ollama.ai/install.sh | sh # 第二步:拉取模型 ollama pull llama3 ollama pull mistral # 第三步:在 OpenClaw 中配置 Ollama openclaw config # 选择 Ollama → 默认地址 http://localhost:11434 # 无需 API Key → 选择模型 llama3 # 💡 完全本地化,零API费用,数据不出本机!

常见问题与技巧

Q:npm install 失败,出现权限错误?

不要使用 sudo 运行 npm。修改 npm 全局目录权限:mkdir -p ~/.npm-global && npm config set prefix '~/.npm-global' && export PATH="$HOME/.npm-global/bin:$PATH"

Q:端口 3000 被占用怎么办?

修改 config.yaml 中的 server.port,或设置环境变量:export OPENCLAW_PORT=3001

Q:如何使用 OpenClaw Manager 桌面版?

从 GitHub 下载 OpenClaw Manager 桌面应用(基于 Tauri 2.0 + React),提供可视化配置界面、实时监控、一键配置等图形化功能。

Q:如何更新 OpenClaw?

npm install -g openclaw@latestpnpm add -g openclaw@latest,更新后重启 Gateway 即可。

Q:如何完全卸载?

rm -rf ~/.openclaw 并移除 shell profile 中的 PATH 条目。

Q:如何在 Raspberry Pi 上部署?

OpenClaw 官方提供 Raspberry Pi 部署指南,需要安装 64 位 Raspberry Pi OS 和 Node.js 22+,其余步骤与 Linux 相同。

部署你的AI私人助手

一行命令开始安装,5分钟拥有你的专属AI助手

广告