OpenClaw安装教程 - 5分钟搭建你的AI私人助手

📖 目录

OpenClaw是什么？
安装前准备
一键安装
运行配置向导
验证安装
连接聊天渠道
常见问题

1️⃣ OpenClaw是什么？

OpenClaw是一个开源的AI助手网关，让你通过微信、Telegram、Discord、Slack等聊天App与AI对话。它运行在你自己的电脑上，数据完全自己掌控。

核心特点：

🏠 自托管 - 运行在你自己的设备上，数据不经过第三方
💬 多渠道 - 一个网关同时连接微信、Telegram、Discord、Slack等20+聊天App
🤖 AI原生 - 支持Claude、GPT、Gemini等主流AI模型
🔧 工具调用 - AI可以执行代码、搜索网页、操作文件等
🧠 持久记忆 - AI记得你之前说过的话
📱 手机控制 - 随时随地通过聊天App指挥AI干活

💡 简单理解：OpenClaw就像一个"AI总管"，你在微信/Telegram发消息，它调用AI帮你处理，还能自动执行各种任务。

2️⃣ 安装前准备

1 Node.js（必须）

需要 Node 24（推荐）或 Node 22.16+。安装脚本会自动帮你装。

手动检查版本：

终端

node --version

2 AI模型的API Key（必须）

你需要一个AI模型的API密钥，任选其一：

Anthropic Claude - 推荐，中文能力强 👉 获取API Key
OpenAI GPT - 经典选择 👉 获取API Key
Google Gemini - 免费额度多 👉 获取API Key
其他兼容OpenAI接口的服务（DeepSeek、Kimi等也行）

3 操作系统

✅ macOS
✅ Linux
✅ Windows（原生 + WSL2均支持，推荐WSL2）

3️⃣ 一键安装

🪟 Windows用户

打开 PowerShell（右键开始菜单 → Windows PowerShell），粘贴运行：

PowerShell

iwr -useb https://openclaw.ai/install.ps1 | iex

💡 提示：如果PowerShell提示"无法运行脚本"，先执行以下命令解锁：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

🍎 Mac用户

打开终端（Terminal），粘贴运行：

终端

curl -fsSL https://openclaw.ai/install.sh | bash

🐧 Linux用户

打开终端，粘贴运行：

终端

curl -fsSL https://openclaw.ai/install.sh | bash

⚠️ 注意：安装过程需要联网下载，可能需要1-3分钟，请耐心等待。如果网络不好，可能需要科学上网。

🔄 其他安装方式

用npm安装（如果你已经有Node.js）：

终端

npm install -g openclaw@latest
openclaw onboard --install-daemon

用Docker安装：

终端

docker run -d --name openclaw \
  -v ~/.openclaw:/root/.openclaw \
  -p 18789:18789 \
  openclaw/openclaw:latest

4️⃣ 运行配置向导

安装完成后，运行配置向导（约2分钟）：

终端

openclaw onboard --install-daemon

向导会依次引导你完成以下设置：

1 选择AI模型

选择你的AI提供商（如Anthropic、OpenAI等），然后输入API Key。

2 设置工作目录

默认 ~/.openclaw/workspace，直接回车即可。

3 网关配置

端口默认 18789，认证模式选Token（自动生成），直接回车即可。

4 连接聊天渠道

选择你要连接的聊天App（可以先跳过，后面再配）。

5 安装后台服务

自动安装为系统服务，开机自启动。

💡 快速开始：配置向导中大部分选项直接回车用默认值就行！最关键的是输入你的API Key。

5️⃣ 验证安装

检查网关状态

终端

openclaw gateway status

看到网关在端口 18789 上监听就说明成功了！

打开控制面板

终端

openclaw dashboard

浏览器会自动打开控制面板，输入一条消息，AI就会回复你！🎉

健康检查

终端

openclaw doctor

如果有问题，这个命令会帮你诊断。

6️⃣ 连接聊天渠道

最酷的功能：把AI接入你的聊天App！以下是最热门的渠道：

📱 Telegram 💬 微信 🎮 Discord 💼 Slack 🔒 Signal 📱 WhatsApp

📱 Telegram（最快配置，推荐）

1 在Telegram搜索 @BotFather，发送 /newbot 创建机器人

2 按提示设置机器人名称，获取 Bot Token

3 运行配置命令：

终端

openclaw configure --section telegram

4 粘贴你的Bot Token，完成！

🎮 Discord

1 去 Discord开发者门户创建Bot

2 获取Bot Token

3 运行配置命令：

终端

openclaw configure --section discord

💡 更多渠道：运行 openclaw configure 查看所有可配置的聊天渠道。

7️⃣ 常见问题

❓ 安装后运行 openclaw 提示"命令未找到"？

Node.js的全局包路径没有加入PATH。运行以下命令修复：

Mac/Linux

export PATH="$(npm prefix -g)/bin:$PATH"

然后把这个命令加入 ~/.zshrc 或 ~/.bashrc，重新打开终端即可。

❓ Windows PowerShell提示"无法运行脚本"？

以管理员身份运行PowerShell，执行：

PowerShell（管理员）

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

❓ 网关启动失败怎么办？

运行诊断命令：

终端

openclaw doctor

❓ 如何更新OpenClaw？

一键更新：

终端

openclaw update

❓ 如何重新配置？

重新运行配置向导：

终端

openclaw configure

❓ 如何卸载OpenClaw？

完全卸载：

终端

openclaw gateway uninstall
npm uninstall -g openclaw

❓ 支持哪些AI模型？

Anthropic Claude、OpenAI GPT、Google Gemini、DeepSeek、Kimi、Ollama本地模型等，以及任何兼容OpenAI API的服务。

❓ 数据安全吗？

OpenClaw运行在你自己的设备上，聊天记录和配置都存在本地。AI对话会发送到你选择的模型提供商（如Anthropic、OpenAI），这是正常使用AI的必要条件。

🦞 OpenClaw 安装教程