2026年OpenClaw安装使用指南

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

OpenClaw 安装指南及常见问题解决

OpenClaw 是一款开源的 AI 助手平台，支持通过 Web UI 和飞书等应用进行交互。其安装核心是配置 Node.js 环境并执行 CLI 安装命令。为了帮助您清晰、高效地完成部署，以下将安装流程分解为四个主要阶段，并针对每个阶段可能遇到的典型问题提供解决方案[ref_1]。

1. 前置环境准备

在安装 OpenClaw 之前，必须确保您的系统已安装必要的运行环境。不同操作系统的具体命令略有差异[ref_4]。

核心依赖：

Node.js: OpenClaw 基于 Node.js 开发，推荐安装 18.x 或更高版本，特别是 22.x 版本[ref_3]。
包管理器: npm 或 yarn，通常随 Node.js 一同安装。
Git: 用于代码管理和部分技能安装[ref_3]。

Windows 系统：推荐使用官方安装器或版本管理工具 nvm-windows 安装 Node.js。若使用 PowerShell，可能需要调整执行策略以允许脚本运行[ref_3]。

# 以管理员身份打开 PowerShell，设置执行策略 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

macOS 系统：推荐使用 Homebrew 安装 Node.js，或使用版本管理工具 nvm。对于较新的 Mac，可能需先安装 Xcode 命令行工具[ref_6]。

# 安装 Homebrew（如果未安装） /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" # 使用 Homebrew 安装 Node.js brew install node

验证安装：安装完成后，在终端或命令行中执行以下命令验证版本。

node --version npm --version

2. OpenClaw 核心安装与初始化

环境准备就绪后，即可通过 npm 进行 OpenClaw 的安装和初始化配置。

步骤 1：全局安装 OpenClaw CLI 工具 通过 npm 将 OpenClaw 命令行工具安装到全局环境[ref_3][ref_5]。

npm install -g openclaw

注意：在某些系统上可能需要 sudo 权限（macOS/Linux）或以管理员身份运行（Windows）。

步骤 2：执行初始化配置 安装完成后，使用 openclaw init 命令开始交互式配置向导[ref_3][ref_5]。

openclaw init

初始化过程会引导您配置以下核心选项：

配置项	说明	示例/选项
AI 模型供应商	选择您要接入的大模型服务	OpenAI, DeepSeek, Moonshot (Kimi), Qwen (通义千问), Claude 等[ref_3]
API Key	输入对应模型供应商的密钥	需提前在相应平台申请
Web 服务端口	本地 Web UI 的访问端口	默认 `18789`[ref_3]
飞书集成 (可选)	如需接入飞书机器人，需配置 App ID 和 App Secret	需在飞书开放平台创建应用获取[ref_4][ref_6]

步骤 3：启动网关服务 配置完成后，启动 OpenClaw 的网关服务。

openclaw start

成功启动后，终端会显示服务运行状态。此时，您可以通过浏览器访问 http://localhost:18789（或您自定义的端口）来使用 Web 界面[ref_3][ref_5]。

3. 技能 (Skills) 安装与管理

OpenClaw 的强大之处在于其技能系统。您可以通过多种方式为您的 AI 助手添加新功能[ref_2]。

安装方法	适用场景	核心步骤/命令
CLI 命令行安装	最常用、支持自动更新	`openclaw skill install`
Web UI 图形化安装	新手友好，可视化操作	访问 Web UI 的 “技能市场” 或 “Settings” 页面点击安装
飞书聊天触发安装	移动端便捷操作	在飞书群聊中 `@机器人` 并发送安装指令
手动下载安装	离线环境或自定义技能	将技能包下载至 `~/.openclaw/skills/` 目录[ref_2]

技能安装后，其配置信息会同步到 ~/.openclaw/openclaw.json 配置文件中。技能文件通常位于 ~/.openclaw/skills/ 目录下[ref_2]。

4. 常见安装问题与解决方案

在安装和配置过程中，可能会遇到一些障碍。下表汇总了高频问题及其解决方法：

问题现象	可能原因	解决方案
`openclaw` 命令未找到	1. 全局安装失败。 2. 系统 PATH 环境变量未包含 npm 全局安装路径。	1. 重新执行 `npm install -g openclaw`，确保无报错。 2. 手动将 npm 全局路径（如 `~/.npm-global/bin` 或 `%AppData%
pm`）添加到系统的 PATH 环境变量中[ref_1]。
网关启动失败，端口被占用	默认端口 `18789` 已被其他程序占用。	1. 终止占用端口的进程。 2. 或在 `openclaw init` 时指定一个不同的端口。
服务启动后，Web 页面无法访问	1. 防火墙或安全软件阻止。 2. 服务未正确启动。	1. 检查防火墙设置，允许对应端口的入站连接。 2. 检查终端日志，确认服务是否显示成功启动。
模型 API 调用失败	1. API Key 错误或过期。 2. 网络问题（如无法访问境外 API）。	1. 在配置文件 `~/.openclaw/openclaw.json` 中检查并更新正确的 API Key。 2. 检查网络连通性，或考虑使用支持国内访问的模型（如通义千问、智谱 AI）[ref_4]。
飞书机器人无响应	1. 飞书应用权限配置不全。 2. 事件订阅 URL 或验证令牌错误。 3. 服务器域名未通过飞书校验。	1. 在飞书开放平台为应用启用“机器人”能力，并添加“接收消息”、“发送消息”等必要权限[ref_4][ref_6]。 2. 确保回调 URL（`https://你的域名或IP:端口/webhook/feishu`）可公网访问，且与配置完全一致。 3. 如果使用本地 IP，飞书可能无法回调，建议使用内网穿透工具（如 ngrok）或部署在具有公网 IP 的服务器上。
Windows 下因中文路径安装失败	OpenClaw 的某些依赖对包含非 ASCII 字符（如中文）的用户目录路径支持不佳。	将 OpenClaw 的配置目录移动到纯英文路径下，或者为 Windows 用户创建一个新的、使用英文名称的用户账户进行安装[ref_4]。
macOS 安装时出现权限错误	全局安装需要写入系统目录。	在安装命令前加上 `sudo`，即 `sudo npm install -g openclaw`，并输入用户密码。或者，将 npm 的全局安装目录配置到当前用户有写入权限的路径[ref_5]。

2026年OpenClaw安装使用指南

1. 前置环境准备

2. OpenClaw 核心安装与初始化

3. 技能 (Skills) 安装与管理

4. 常见安装问题与解决方案

相关推荐