OpenClaw 安装教程：从零搭建你的本地 AI 助手（2026 最新版）

Mathe 2026-10-08 20 0

OpenClaw 是什么？

OpenClaw 是一个运行在本地的 AI 助手网关（Gateway）。它把各种聊天渠道（飞书、Telegram、Discord、Slack、WhatsApp、微信等）和大模型（OpenAI、DeepSeek、Claude、Gemini 等）连接起来，让你的 AI 不只是聊天，而是能真正帮你做事——操作浏览器、读写文件、发消息、查数据、跑定时任务。

一、环境要求

Node.js：24.16+ 或 26.1+（推荐 Node 26；安装脚本会在缺失时自动帮你装）
系统：macOS、Linux（含 WSL2）或 Windows
只有从源码编译时才需要 pnpm

二、安装方式

方式 1：一键安装脚本（推荐）

macOS / Linux / WSL2：

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

Windows（PowerShell）：

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

脚本会自动检测系统、按需安装 Node、安装 OpenClaw 并进入引导。暂时不想引导可加 --no-onboard：

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

方式 2：桌面应用（新手友好）

Windows：下载 Windows Hub 安装包，双击安装
macOS：从 GitHub Releases 下载 OpenClaw 的 .dmg，安装并启动 OpenClaw.app

桌面应用会在首次运行时帮你本地起一个 Gateway，也能连接已有的远程 Gateway。

方式 3：npm / pnpm / bun（已有 Node 环境）

npm（npm 12 或 11.16+）：

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

pnpm：

pnpm add -g --allow-build=openclaw openclaw@latest
openclaw onboard --install-daemon

三、验证安装

openclaw --version      # 确认 CLI 可用
openclaw doctor         # 检查配置问题
openclaw gateway status # 查看 Gateway 是否在运行

四、初始化与配置

运行引导：

openclaw onboard

配置模型 Provider：在引导或 Control UI 中填入大模型 API Key（OpenAI、DeepSeek、Claude 等）。
接入聊天渠道：

openclaw channels login

按提示选择飞书、Telegram、Discord 等常用渠道完成绑定。

健康检查：

openclaw health

五、常见问题排查

Q1：装完提示 openclaw 找不到？

基本都是 PATH 问题——npm 全局 bin 目录没加进 shell 的 PATH：

node -v           # Node 装了吗
npm prefix -g     # 全局包在哪
echo "$PATH"      # 全局 bin 目录在不在 PATH 里

Q2：npm 12 提示脚本被 block？

npm 12 默认拦截未批准的包生命周期脚本，安装时加 --allow-scripts=openclaw 即可。

Q3：Windows 提示 openclaw is not recognized？

运行 npm config get prefix，把该目录加进用户 PATH，重开 PowerShell。

六、下一步

接一个聊天渠道，用手机给 AI 发消息试试
给 Agent 配置工作区、记忆与技能
装几个插件：浏览器自动化、联网搜索、Notion 等

本文基于 OpenClaw 官方文档整理，版本截至 2026 年 10 月。

Hello World