安装教程 - OpenClaw官网中文版

环境准备

安装前的准备工作

安装 OpenClaw 之前，请确认以下环境已就绪。

Node.js 18+

OpenClaw 基于 Node.js 运行，需要 v18 或以上版本。

必须

→ 下载 Node.js

AI 模型 API Key

需要至少一个 AI 模型的 API Key，推荐使用 DeepSeek（国内访问稳定）。

必须

→ 获取 DeepSeek Key

Git（可选）

如需从源码安装或参与开发，需要安装 Git。npm 安装方式无需此项。

可选

验证环境

# 验证 Node.js 版本（需要 ≥ 18）
$ node -v
v20.11.0

# 验证 npm 已安装
$ npm -v
10.2.4

# 如果版本过低，请先升级 Node.js
$ npm install -g n && n stable

安装步骤

选择你的操作系统

🪟 Windows

🍎 macOS

🐧 Linux

1

安装 Node.js（如未安装）

访问 nodejs.org/zh-cn 下载 LTS 版本安装包（.msi），双击安装，全程默认选项即可。安装完成后打开「命令提示符」或「PowerShell」验证版本。

PowerShell
node -v  # 应输出 v18.x 或更高

2

安装 OpenClaw 中文版

使用 npm 全局安装 OpenClaw 中文社区版（openclaw-cn）。该版本已内置国内平台支持和网络优化。

PowerShell（管理员）

# 安装中文版（推荐）
npm install -g openclaw-cn

# 或安装官方原版
npm install -g openclaw

# 验证安装
openclaw --version
OpenClaw v0.1.8-cn

💡 如果提示权限错误，请以管理员身份运行 PowerShell，或参考「常见报错」部分。

3

初始化配置

运行初始化命令，OpenClaw 会引导你完成基础配置：选择 AI 模型、填写 API Key、选择接入平台。

PowerShell

openclaw init

? 选择 AI 模型: DeepSeek V3 (推荐)
? DeepSeek API Key: sk-xxxxxxxxxxxxxxxx
? 选择接入平台: 钉钉, 飞书, CLI
✓ 配置文件已保存到 config.yml

4

启动 OpenClaw

配置完成后，运行启动命令。OpenClaw 将在后台运行，并在你指定的平台上等待指令。

PowerShell

openclaw start

🦞 OpenClaw v0.1.8-cn 启动中...
✓ 连接 DeepSeek API
✓ 钉钉机器人已激活
✓ Dashboard: http://localhost:3000
🚀 OpenClaw 已就绪！

🎉 打开浏览器访问 http://localhost:3000 查看 Dashboard，或直接在钉钉中 @机器人开始对话！

1

使用 Homebrew 安装 Node.js（推荐）

macOS 推荐通过 Homebrew 安装 Node.js，方便后续版本管理。如未安装 Homebrew，请先访问 brew.sh。

Terminal

# 安装 Homebrew（如未安装）
/bin/bash -c "$(curl -fsSL https://brew.sh/install.sh)"

# 通过 Homebrew 安装 Node.js
brew install node

# 验证版本
node -v && npm -v

2

安装 OpenClaw 中文版

Terminal

npm install -g openclaw-cn
# 如提示权限问题
sudo npm install -g openclaw-cn

3

初始化并启动

Terminal

openclaw init  # 按提示完成配置
openclaw start # 启动服务

1

安装 Node.js 18+

Bash（Ubuntu/Debian）

# 添加 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
node -v

2

安装并配置 OpenClaw

Bash

sudo npm install -g openclaw-cn
openclaw init
# 使用 pm2 后台运行（推荐服务器部署）
npm install -g pm2
pm2 start openclaw -- start
pm2 save && pm2 startup

模型配置

配置 AI 模型

OpenClaw 支持多种 AI 模型，以下是国内用户最推荐的配置方案。

🌙

DeepSeek V3（最推荐）

国内访问稳定

# config.yml
model:
  provider: deepseek
  api_key: sk-xxxxxxxx
  model: deepseek-chat

🔵

Claude 3.5（性能最强）

需要 API 中转

# config.yml
model:
  provider: anthropic
  api_key: sk-ant-xxxx
  base_url: https://your-proxy.com

平台接入

接入钉钉 / 飞书

以下以钉钉为例，飞书配置流程类似。

1

创建钉钉自定义机器人

进入钉钉群设置 → 机器人 → 添加机器人 → 自定义。记录 Webhook 地址和安全密钥。

2

填写配置文件

platforms:
  dingtalk:
    webhook: https://oapi.dingtalk.com/...
    secret: SECxxxxxxxxxxxxxxxxx

3

重启并测试

运行 openclaw restart，在钉钉群中发送「你好」，机器人应回复确认消息。

config.yml 完整示例

model:
  provider: deepseek
  api_key: sk-xxxxxxxxxx
  model: deepseek-chat

platforms:
  dingtalk:
    webhook: https://oapi.dingtalk.com/...
    secret: SECxxxxxxxxxx
  feishu:
    app_id: cli_xxxxxxxxx
    app_secret: xxxxxxxxx
  cli: true

skills:
  - web-search
  - file-manager
  - code-runner

server:
  port: 3000
  dashboard: true

常见报错

安装遇到问题？

以下是最常见的安装报错及解决方法。

EACCES: permission denied（权限拒绝）

Windows 用管理员身份运行 PowerShell；macOS/Linux 在命令前加 sudo，或参考 npm 官方文档配置全局包目录避免使用 sudo。

npm ERR! network timeout（网络超时）

国内网络访问 npm 可能超时，切换到淘宝镜像：npm config set registry https://registry.npmmirror.com，然后重试安装。

openclaw: command not found

npm 全局包路径未加入系统 PATH。运行 npm bin -g 查看全局安装路径，将其添加到系统环境变量中。

API Key 验证失败

检查 config.yml 中 api_key 格式是否正确，国内访问 Claude API 需要配置 base_url 指向中转服务；DeepSeek API 国内可直连。

钉钉机器人无响应

确认 Webhook 地址复制完整，检查安全设置是否选择「加签」并在 config.yml 填写了 secret；确保 OpenClaw 服务正在运行（openclaw status）。

还是解决不了？查看完整常见问题文档

查看常见问题 →