NPM安装OpenClaw

OpenClaw 是一个功能强大的多 Agent 框架，支持插件扩展和多种模型接入，能够快速搭建个人 AI 助手或企业级 AI 客服系统。本文将手把手教你如何通过 NPM 在本地快速部署 OpenClaw。

环境准备

在开始之前，请确认你的环境满足以下条件：

• Node.js ≥ 22.16（推荐 Node 24）
• 操作系统：macOS、Linux 或 Windows（推荐 WSL2）
• 网络：能够访问 npm 仓库

可以用下面命令检查版本：

node -v

如果显示版本号低于 22.16，需要升级 Node.js。推荐使用 nvm 或 fnm 来管理 Node 版本，或者直接去 官网 下载安装包。

安装 OpenClaw

OpenClaw 提供了 NPM 包，可以直接全局安装：

# 使用 npm
npm install -g openclaw@latest

# 或者使用 pnpm（推荐）
pnpm add -g openclaw@latest

验证是否安装成功：

openclaw --version

如果能输出版本号（如 openclaw@2026.3.13），说明安装成功。

初始化 OpenClaw

安装完成后，需要初始化 OpenClaw。运行下面命令：

openclaw onboard --install-daemon

根据命令行提示完成配置：

• 模型接入：可以先跳过，后续在配置文件中添加
• 通道配置：QQ、微信、Telegram 等，可以后续再配

初始化后会在用户目录下生成 .openclaw 目录，主要配置文件是 openclaw.json，所有模型、Agent、插件的配置都在这里进行。

访问控制面板

初始化完成后，会自动调用浏览器打开 http://localhost:18789。如果需要输入 token，可以在配置文件中找到：

{
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": "your-token-here"
    }
  }
}

token 也可以通过以下命令直接查看：

openclaw config get gateway.auth.token

常见问题

命令找不到？

如果提示 openclaw: command not found，需要将 npm 全局 bin 目录添加到 PATH：

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

# Windows
# 在系统环境变量中添加 npm prefix -g 的输出路径

安装失败？

如果遇到权限问题（Linux/macOS），可以尝试：

mkdir -p "$HOME/.npm-global"
npm config set prefix "$HOME/.npm-global"
export PATH="$HOME/.npm-global/bin:$PATH"

下一步

安装只是第一步，后续需要：

1. 接入模型：配置 OpenAI、Anthropic、Ollama 等
2. 配置通道：添加 QQ、微信、Telegram 等消息通道
3. 安装插件：根据需要安装各种功能插件

强烈建议阅读 官方文档，那里有更详细的配置指南。