OpenClaw 使用 npm部署教程

目录

• OpenClaw 部署教程（使用 npm）
• 环境准备
• 系统要求
• 检查环境
• 安装 OpenClaw
• 方式一：全局安装（推荐）
• 方式二：本地安装
• 初始化配置
• 1. 创建配置文件
• 2. 编辑配置文件
• 3. 设置环境变量（可选）
• 启动服务
• 启动 Gateway 服务
• 检查服务状态
• 停止服务
• 连接到客户端
• Web 界面
• 命令行交互
• 常见问题
• Q1: 安装时出现权限错误
• Q2: 端口被占用
• Q3: 无法连接到模型 API
• Q4: 如何更新 OpenClaw
• 📝 进阶配置
• 配置多个模型提供商
• 启用插件
• 🔗 相关链接
• ✅ 快速检查清单

本教程介绍如何通过 npm 在 Windows 系统上安装和配置 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 版本。

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

# 创建项目目录
mkdir my-openclaw
cd my-openclaw
# 初始化 npm 项目
npm init -y
# 本地安装 OpenClaw
npm install openclaw

# 创建配置目录
mkdir -p ~/.openclaw
# 创建基础配置文件
touch ~/.openclaw/config.yaml

打开 ~/.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

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

# 启动 OpenClaw 网关
openclaw gateway start
# 或者后台运行
openclaw gateway start --daemon

# 查看网关状态
openclaw gateway status
# 查看详细状态
openclaw status

# 停止网关
openclaw gateway stop
# 重启网关
openclaw gateway restart

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

http://localhost:8080

# 进入交互模式
openclaw chat
# 或者发送单条消息
openclaw chat "你好，OpenClaw"

解决方法：

# Windows: 以管理员身份运行 PowerShell
# 然后执行
npm install -g openclaw
# 或者更改 npm 全局目录
npm config set prefix "$env:USERPROFILEnpm-global"

解决方法：

# 查看端口占用情况
netstat -ano | findstr :8080
# 修改配置文件中的端口
# 编辑 ~/.openclaw/config.yaml
gateway:
  port: 8081  # 改为其他端口

解决方法：

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

openclaw logs

# 全局更新
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"

• OpenClaw 官方文档
• GitHub 仓库
• 社区 Discord
• Skill 市场

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

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

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

到此这篇关于OpenClaw 使用 npm部署教程的文章就介绍到这了,更多相关OpenClaw 部署教程内容请搜索风君子博客以前的文章或继续浏览下面的相关文章，希望大家以后多多支持风君子博客！