OpenClaw 部署教程（使用 npm）

本教程介绍如何通过 npm 在 Windows 系统上安装和配置 OpenClaw。

📋 目录

环境准备
[安装 OpenClaw](#安装 OpenClaw)
初始化配置
启动服务
常见问题

环境准备

系统要求

操作系统: Windows 10/11, macOS, 或 Linux
Node.js: v18.0.0 或更高版本
npm: v8.0.0 或更高版本

检查环境

复制代码

# 检查 Node.js 版本
node --version

# 检查 npm 版本
npm --version

如果未安装 Node.js，请前往 nodejs.org 下载并安装 LTS 版本。

安装 OpenClaw

方式一：全局安装（推荐）

复制代码

# 使用 npm 全局安装
npm install -g openclaw

# 验证安装
openclaw --version

方式二：本地安装

复制代码

# 创建项目目录
mkdir my-openclaw
cd my-openclaw

# 初始化 npm 项目
npm init -y

# 本地安装 OpenClaw
npm install openclaw

初始化配置

1. 创建配置文件

复制代码

# 创建配置目录
mkdir -p ~/.openclaw

# 创建基础配置文件
touch ~/.openclaw/config.yaml

2. 编辑配置文件

打开 ~/.openclaw/config.yaml，添加基础配置：

复制代码

# OpenClaw 基础配置
app:
  name: "My OpenClaw"
  debug: false

# 网关配置
gateway:
  host: "localhost"
  port: 8080

# 模型配置（示例：使用 OpenAI）
models:
  default: "gpt-4"
  providers:
    openai:
      api_key: "your-api-key-here"
      base_url: "https://api.openai.com/v1"

# 可选：其他配置
plugins:
  - name: "web_search"
    enabled: true
  - name: "file_manager"
    enabled: true

3. 设置环境变量（可选）

复制代码

# Windows PowerShell
$env:OPENCLAW_CONFIG_PATH = "$env:USERPROFILE\.openclaw\config.yaml"

# 或者添加到系统环境变量
[Environment]::SetEnvironmentVariable("OPENCLAW_CONFIG_PATH", "$env:USERPROFILE\.openclaw\config.yaml", "User")

启动服务

启动 Gateway 服务

复制代码

# 启动 OpenClaw 网关
openclaw gateway start

# 或者后台运行
openclaw gateway start --daemon

检查服务状态

复制代码

# 查看网关状态
openclaw gateway status

# 查看详细状态
openclaw status

停止服务

复制代码

# 停止网关
openclaw gateway stop

# 重启网关
openclaw gateway restart

连接到客户端

Web 界面

启动服务后，打开浏览器访问：

复制代码

http://localhost:8080

命令行交互

复制代码

# 进入交互模式
openclaw chat

# 或者发送单条消息
openclaw chat "你好，OpenClaw"

常见问题

Q1: 安装时出现权限错误

解决方法：

复制代码

# Windows: 以管理员身份运行 PowerShell
# 然后执行
npm install -g openclaw

# 或者更改 npm 全局目录
npm config set prefix "$env:USERPROFILE\npm-global"

Q2: 端口被占用

解决方法：

复制代码

# 查看端口占用情况
netstat -ano | findstr :8080

# 修改配置文件中的端口
# 编辑 ~/.openclaw/config.yaml
gateway:
  port: 8081  # 改为其他端口

Q3: 无法连接到模型 API

解决方法：

检查 API Key 是否正确
确认网络连接正常
查看日志获取详细信息：

复制代码

openclaw logs

Q4: 如何更新 OpenClaw

复制代码

# 全局更新
npm update -g openclaw

# 查看版本
openclaw --version

📝 进阶配置

配置多个模型提供商

复制代码

models:
  default: "gpt-4"
  providers:
    openai:
      api_key: "${OPENAI_API_KEY}"
      base_url: "https://api.openai.com/v1"
    
    anthropic:
      api_key: "${ANTHROPIC_API_KEY}"
      base_url: "https://api.anthropic.com"
    
    local:
      base_url: "http://localhost:11434"  # Ollama 本地模型

启用插件

复制代码

plugins:
  - name: "web_search"
    enabled: true
    config:
      engine: "duckduckgo"
  
  - name: "file_manager"
    enabled: true
    config:
      allowed_paths:
        - "~/Documents"
        - "~/Projects"

🔗 相关链接

✅ 快速检查清单

部署完成后，确认以下事项：

Node.js 和 npm 已正确安装
OpenClaw 已成功安装
配置文件已创建并正确填写
Gateway 服务已成功启动
可以通过浏览器或 CLI 访问 OpenClaw
模型 API 连接正常

💡 提示 : 如果遇到问题，可以运行 openclaw doctor 进行诊断检查。

最后更新: 2026-03-16