🎯 什么是 OpenClaw？

一句话定义：OpenClaw 是一个基于 Node.js 的 AI 驱动自动化平台，可以快速搭建智能聊天机器人、自动化任务执行工具，支持多种消息渠道和自定义扩展。

主要功能

• 🤖 AI 对话能力 - 集成多个 AI 模型（Qwen、Claude、GPT 等），提供智能对话和内容生成
• 💬 多渠道接入 - 支持 Telegram、Discord、WhatsApp、飞书等多种消息平台
• 🔧 自定义 Skills - 通过 Skills 扩展功能，实现自动化发布、数据爬取等任务
• 🌐 Web UI 控制 - 提供友好的网页界面，无需命令行即可操作
• 📝 本地部署 - 数据存储在本地，隐私安全，完全可控
• 🔌 灵活配置 - 支持多账号管理、自定义工作流、Hooks 自动化

适用人群

人群	使用场景
🧑‍💻 开发者	快速搭建 AI 应用、集成第三方服务、开发自动化工具
🤖 自动化爱好者	实现内容自动发布、数据自动处理、定时任务执行
🔬 AI 实验者	测试不同 AI 模型、探索 AI 应用、学习 AI 技术
📱 内容创作者	自动化发布内容到多个平台、管理多个账号
🏢 企业用户	搭建内部 AI 助手、自动化业务流程、提高工作效率

为什么选择 OpenClaw？

✅ 完全免费 - 开源项目，无需付费
✅ 易于上手 - 提供详细的配置向导，新手友好
✅ 功能强大 - 支持复杂的自动化场景和自定义扩展
✅ 社区活跃 - 有活跃的开发者社区和丰富的 Skills 库
✅ 隐私安全 - 本地部署，数据完全掌握在自己手中

快速导航

• 方法一：Node.js + npm 全局安装（适合长期使用，推荐）
• 方法二：一键脚本快速安装（最快体验，但可能缺乏灵活性）
• 方法三：Docker + WSL2（适合熟悉容器技术的用户）
• 常见问题排查
• 常用命令速查表
• Skills 配置方法
• 总结

方法一：Node.js + npm 全局安装（适合长期使用，推荐）

第一步：环境准备与检查

1.1 系统要求检查

# 打开 PowerShell（以管理员身份）
# 按 Win + X，选择 "Windows PowerShell (管理员)" 或 "终端 (管理员)"

# 检查 Windows 版本
systeminfo | findstr /C:"OS Name" /C:"OS Version"

# 检查系统位数（应显示 64 位）
systeminfo | findstr "System Type"

# 检查可用内存（需要至少 4G）
systeminfo | findstr "Total Physical Memory"

# 检查 C 盘可用空间（需要至少 20GB）
dir C:\ | find "bytes free"

1.2 配置 PowerShell 执行策略

# 以管理员身份运行 PowerShell，执行以下命令
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

# 系统会提示是否确认，输入 Y 并按回车
# 输出应为：执行策略已更改

# 验证设置是否成功
Get-ExecutionPolicy
# 应输出：RemoteSigned

第二步：安装 Node.js

2.1 下载 Node.js

1. 访问官方网站：https://nodejs.org/
2. 选择 LTS（长期支持）版本，推荐 v22.x 或更高
3. 点击下载 Windows Installer (.msi) 64-bit 版本
4. 保存到 C:\Users\你的用户名\Downloads 目录

2.2 安装 Node.js

1. 双击下载的 .msi 文件
2. 点击 Next 接受许可协议
3. 选择安装路径（默认 C:\Program Files\nodejs）
4. 重要：在"Tools for Native Modules"步骤，勾选以下选项：
   • ☑ Automatically install the necessary tools for native modules
5. 点击 Install 开始安装
6. 安装完成后点击 Finish
7. 重启电脑（确保环境变量生效）

2.3 验证 Node.js 安装

重启后，打开新的 PowerShell 窗口，执行：

# 检查 Node.js 版本
node -v
# 应输出：v22.x.x 或更高

# 检查 npm 版本
npm -v
# 应输出：10.x.x 或更高

# 检查 npm 全局安装路径
npm config get prefix
# 应输出：C:\Users\你的用户名\AppData\Roaming\npm

第三步：安装 Git（可选但推荐）

3.1 下载 Git

1. 访问：https://git-scm.com/download/win
2. 选择 64-bit Git for Windows Setup
3. 保存到 Downloads 目录

3.2 安装 Git

1. 双击安装程序
2. 一路点击 Next 使用默认设置
3. 在"Choosing the default editor used by Git"步骤，选择你喜欢的编辑器（推荐 Vim）
4. 点击 Install 完成安装

3.3 验证 Git 安装

git --version
# 应输出：git version 2.x.x

第四步：全局安装 OpenClaw

4.1 安装 OpenClaw

打开 PowerShell（管理员），执行：

# 清理 npm 缓存（可选，但推荐）
npm cache clean --force

# 全局安装 OpenClaw（最新版本）
npm install -g openclaw@latest
这个过程会持续3-6分钟
中途可能会报错：大概率就是没有配置梯子（本人就是）

# 安装过程会输出类似信息：
# added 668 packages in 4m
# 128 packages are looking for funding

4.2 验证安装

# 检查 OpenClaw 版本
openclaw --version
# 应输出：OpenClaw 2026.3.8 (3caab92)

# 检查 OpenClaw 安装位置
where openclaw
# 应输出：C:\Users\你的用户名\AppData\Roaming\npm\openclaw

第五步：初始化配置（Onboard）

5.1 启动配置向导

openclaw onboard --install-daemon

5.2 配置向导详细步骤

步骤 1：确认个人使用

I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
我理解这是个人默认配置，共享/多用户使用需要锁定。继续吗？
|    Yes / > No

选择：Yes（按回车）

步骤 2：选择 Gateway 模式

Where will the Gateway run?  Gateway 将在哪里运行？
|  > Local (this machine)  本地（这台机器）
|    Remote gateway 远程 Gateway

选择：Local (this machine)（按回车）

步骤 3：选择 AI 提供商

Model/auth provider  模型/认证提供商
|  > OpenAI (Codex OAuth + API key)
|    Anthropic
|    Qwen
|    Google
|    ... 其他选项

选择：Qwen（使用方向键移动，按回车）

步骤 4：选择 Qwen 认证方式

Qwen auth method  Qwen 认证方法
|  > Qwen Gemini API key
|    Qwen Gemini CLI OAuth
|    Back

选择：Qwen Gemini API key（按回车）

如果你想长期免费使用，看过来：

• 先用通义千问的 500 万 tokens
• 用完后换智谱 AI 的 1000 万 tokens
• 再用完后换 Moonshot AI的 15 元体验金
• Google账号每天也有免费额度

步骤 5：选择 API 密钥提供方式

How do you want to provide this API key?  你想如何提供 API 密钥？
|  > Paste API key now (Stores the key directly in OpenClaw config) 现在粘贴 API 密钥（将密钥直接存储在 OpenClaw 配置中）
|    Use external secret provider  使用外部密钥提供商

选择：Paste API key now（按回车）

步骤 6：输入 API 密钥

API Key (leave blank if not required)  API 密钥（如果不需要可留空）
|  [输入框]

操作：
1. 粘贴你的 Qwen API 密钥（从 https://dashscope.aliyun.com/ 获取）
2. 按回车确认

步骤 7：选择默认模型

Default model
|  > Keep current (qwen-portal/coder-model) 保持当前
|    Enter model manually 手动输入模型
|    qwen-portal/vision-model  （Qwen 视觉模型）
|    ... 其他模型

选择：Keep current（按回车）

步骤 8：选择消息平台

Select channel (QuickStart)  选择消息渠道（快速开始）
|  > Telegram (Bot API) (recommended · newcomer-friendly)  （推荐·新手友好）
|    WhatsApp (QR link)  （二维码链接）
|    Discord (Bot API) 
|    ... 其他平台
|    Skip for now  暂时跳过

选择：Skip for now（使用方向键滚动到最下面，按回车）

步骤 9：选择搜索提供商

Search provider   搜索提供商
|  > Brave Search (Structured results · country/language/time filters)  （结构化结果·国家/语言/时间筛选）
|    Gemini (Google Search)
|    ... 其他选项
|    Skip for now  暂时跳过

选择：Skip for now（按回车）

步骤 10：配置 Skills

Configure skills now? (recommended)  现在配置 Skills 吗？（推荐）
|  > Yes / No

选择：No（按回车）

步骤 11：启用 Hooks

Enable hooks?   启用 Hooks 吗？
|  [•] Skip for now   暂时跳过
|  [ ] 🚀 boot-md
|  [ ] 📎 bootstrap-extra-files
|  ... 其他选项

选择：Skip for now（按回车）

步骤 12：安装 Gateway 服务

Gateway service already installed  Gateway 服务已安装
|  > Restart  重启
|    Reinstall  重新安装
|    Skip  跳过

选择：Restart（按回车）

步骤 13：配置完成

Dashboard ready  仪表板已就绪
|  Dashboard link (with token):
|  http://127.0.0.1:18789/#token=ff459e572eb79e2850583925a91cf292d4fe1a3f2a1efab3
|  Opened in your browser. Keep that tab to control OpenClaw.

浏览器会自动打开 OpenClaw 控制面板

第六步：启动和验证

6.1 启动 OpenClaw

# 启动 Gateway
openclaw gateway start

# 输出应显示：
# [gateway] listening on ws://127.0.0.1:18789

6.2 验证服务状态

# 检查 Gateway 状态
openclaw gateway status

# 应输出：
# ✓ Gateway is running
# ✓ Listening on http://127.0.0.1:18789

6.3 访问 Web UI

1. 打开浏览器
2. 访问：http://127.0.0.1:18789/
3. 你应该看到 OpenClaw 的聊天界面
4. 在聊天框中输入消息测试，例如：“你好，介绍一下你自己”

---

方法二：一键脚本快速安装(最快体验，但可能缺乏灵活性。)

第一步：准备环境

# 以管理员身份打开 PowerShell
# 按 Win + X，选择 "Windows PowerShell (管理员)"

# 配置执行策略
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
# 输入 Y 并按回车

第二步：执行安装脚本

# 运行官方安装脚本
iwr -useb https://openclaw.ai/install.ps1 | iex

# 脚本会自动：
# 1. 检查 Node.js 是否已安装
# 2. 如果未安装，自动下载并安装
# 3. 全局安装 OpenClaw
# 4. 启动初始化向导

第三步：按照向导完成配置

脚本执行完成后，会自动启动 openclaw onboard 向导，按照方法一第五步的配置步骤完成即可。

第四步：启动服务

# 脚本完成后，运行以下命令启动
openclaw gateway start

# 访问 Web UI
# http://127.0.0.1:18789/

---

方法三：Docker + WSL2（适合熟悉容器技术的用户）

第一步：启用 WSL2

1.1 以管理员身份打开 PowerShell

# 按 Win + X，选择 "Windows PowerShell (管理员)"

1.2 启用 WSL2

# 启用 WSL 功能
wsl --install

# 系统会提示重启，按照提示重启电脑

1.3 重启后验证 WSL2

# 检查 WSL 版本
wsl --version
# 应输出：WSL version: 2.x.x

# 列出已安装的 Linux 发行版
wsl --list --verbose

第二步：安装 Docker Desktop

2.1 下载 Docker Desktop

1. 访问：https://www.docker.com/products/docker-desktop
2. 点击 Download for Windows
3. 选择 Docker Desktop Installer.exe

2.2 安装 Docker Desktop

1. 双击安装程序
2. 勾选 Install required Windows components for WSL 2
3. 点击 OK 开始安装
4. 安装完成后重启电脑

2.3 验证 Docker 安装

# 检查 Docker 版本
docker --version
# 应输出：Docker version 24.x.x

# 检查 Docker 运行状态
docker ps
# 应输出：CONTAINER ID   IMAGE   COMMAND   CREATED   STATUS   PORTS   NAMES

第三步：拉取并运行 OpenClaw 容器

3.1 拉取 OpenClaw 镜像

# 拉取最新版本
docker pull openclaw/openclaw:latest

# 输出应显示：
# Pulling from openclaw/openclaw
# ... 下载进度 ...
# Digest: sha256:...
# Status: Downloaded newer image for openclaw/openclaw:latest

3.2 运行 OpenClaw 容器

# 运行容器（后台模式）
docker run -d `
  -p 18789:18789 `
  --name openclaw `
  openclaw/openclaw:latest

# 输出应显示容器 ID，例如：
# a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6

3.3 验证容器运行状态

# 查看运行中的容器
docker ps

# 应输出：
# CONTAINER ID   IMAGE                    COMMAND   CREATED   STATUS   PORTS                      NAMES
# a1b2c3d4e5f6   openclaw/openclaw:latest   ...       ...       Up ...   0.0.0.0:18789->18789/tcp   openclaw

# 查看容器日志
docker logs openclaw

# 应输出 OpenClaw 启动日志

3.4 访问 OpenClaw

1. 打开浏览器
2. 访问：http://127.0.0.1:18789/
3. 进行初始化配置

第四步：容器管理命令

# 停止容器
docker stop openclaw

# 启动容器
docker start openclaw

# 重启容器
docker restart openclaw

# 删除容器
docker rm openclaw

# 查看容器详细信息
docker inspect openclaw

# 进入容器内部（调试用）
docker exec -it openclaw /bin/bash

---

常见问题排查

问题 1：npm 安装卡住或超时

# 清理 npm 缓存
npm cache clean --force

# 设置更长的超时时间
npm config set fetch-timeout 120000

# 重新安装
npm install -g openclaw@latest

问题 2：PowerShell 执行策略错误

# 检查当前执行策略
Get-ExecutionPolicy

# 如果输出 Restricted，执行以下命令
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

问题 3：Node.js 命令找不到

# 重启 PowerShell（关闭后重新打开）
# 或者重启电脑

# 检查 Node.js 是否在 PATH 中
$env:Path -split ';' | Select-String 'nodejs'

问题 4：Gateway 无法启动

# 查看详细日志
openclaw gateway logs

# 检查端口 18789 是否被占用
netstat -ano | findstr :18789

# 如果被占用，可以更改端口
openclaw config set gateway.port 18790

问题 5：API 密钥错误

# 重新配置 API 密钥
openclaw configure --section model

# 或者直接编辑配置文件
notepad C:\Users\你的用户名\.openclaw\openclaw.json

---

常用命令速查表

# 查看版本
openclaw --version

# 启动配置向导
openclaw onboard

# 启动 Gateway
openclaw gateway start

# 停止 Gateway
openclaw gateway stop

# 重启 Gateway
openclaw gateway restart

# 查看 Gateway 状态
openclaw gateway status

# 查看日志
openclaw gateway logs

# 查看配置
openclaw config list

# 获取特定配置
openclaw config get google.apiKey

# 设置配置
openclaw config set provider qwen

# 健康检查
openclaw doctor

# 查看帮助
openclaw --help

---

Skills 配置方法

OpenClaw 的 Skills 是扩展功能模块，可以让 OpenClaw 执行特定的自动化任务。本章以小红书自动发布 Skill 为例，详细说明如何安装、配置和使用 Skills，选择自己需要的skills。

第一步：了解 Skills 概念

Skills 是什么？

Skills 是 OpenClaw 的功能扩展模块，允许你：

• 自动化执行特定任务（如发布内容到社交媒体）
• 集成第三方工具和服务
• 扩展 OpenClaw 的能力
• 支持多账号管理

小红书 Skill 的功能

小红书 Skill （GitHub上的项目就不展示了）一个开源项目，在这里只展示怎么使用skills

第二步：安装 Skills

2.1 在 OpenClaw 中安装 Skill

打开 PowerShell，执行以下命令：

# 方式一：通过 OpenClaw CLI 安装（推荐）
openclaw skill install https://github.com/white0dew/XiaohongshuSkills.git

# 如果上述命令不支持，使用方式二

2.2 手动克隆 Skill 项目（备选方案）

如果 CLI 安装不支持，可以手动克隆：

# 创建 Skills 目录（如果不存在）
mkdir C:\Users\Administrator\.openclaw\skills (这个是安装openclaw项目地址)

# 进入 Skills 目录
cd C:\Users\Administrator\.openclaw\skills

# 克隆小红书 Skill 项目
git clone github项目地址

# 克隆完成后重启Gateway：
openclaw gateway restart

# 输出应显示：
# Cloning into 'XXXX'...
# remote: Enumerating objects: ...
# Receiving objects: 100% (...)
# done.

2.3 验证 Skill 安装

# 检查 Skill 目录结构
dir C:\Users\administrator\.openclaw\skills\项目名称"

# 应输出：
# Mode                 LastWriteTime         Length Name
# ----                 -------------         ------ ----
# d-----         2026/3/10     14:47                config
# d-----         2026/3/10     14:47                docs
# d-----         2026/3/10     14:47                images
# d-----         2026/3/10     14:47                public
# d-----         2026/3/10     14:47                scripts
# -a----         2026/3/10     14:47            528 .gitignore
# -a----         2026/3/10     14:47          12630 README.md
# -a----         2026/3/10     14:47             36 requirements.txt
# -a----         2026/3/10     14:47          11107 SKILL.md

第三步：安装 Skill 依赖

3.1 检查 Python 环境

小红书 Skill 使用 Python 实现，需要先检查 Python 是否已安装：

# 检查 Python 版本
python --version

# 应输出：Python 3.x.x

# 如果未安装，访问 https://www.python.org/ 下载安装

3.2 安装 Python 依赖

# 进入 Skill 目录
dir C:\Users\administrator\.openclaw\skills\项目名称"

# 安装依赖
pip install -r requirements.txt

# 输出应显示：
# Collecting selenium
# Collecting webdriver-manager
# ... 其他依赖 ...
# Successfully installed ...

第四步：重启 OpenClaw Gateway

完成 Skill 安装和配置后，需要重启 Gateway 使其识别新的 Skill：

# 重启 Gateway
openclaw gateway restart

# 或者分别执行
openclaw gateway stop
openclaw gateway start

# 查看日志确认 Skill 已加载
openclaw gateway logs

# 应输出类似：
# [gateway] Loading skills...
# [gateway] Loaded skill: XiaohongshuSkills
# [gateway] Gateway ready

第五步：在 OpenClaw 中使用 Skill

5.1 访问 OpenClaw Web UI

1. 打开浏览器
2. 访问：http://127.0.0.1:18789/?token=‘你的token’
3. 进入聊天界面
4. 如果openclaw一直未找到skills,你就直接告诉他你的skills具体路径地址

5.2 发布图文内容到小红书

在聊天框中输入以下命令：

帮我发布一篇图文到小红书
标题：我的第一篇笔记
内容：这是一篇测试笔记
图片：C:\Users\Administrator\Desktop\img\456.jpg

5.3 查看发布结果

• OpenClaw 会自动调用小红书 Skill
• 浏览器会打开小红书页面
• 自动填充标题、内容和上传图片
• 自动点击发布按钮
• 发布完成后返回结果

安装其他 Skills 的步骤类似，只需将项目 URL 替换为对应的 GitHub 地址。

总结

方法	适用场景	难度	安装时间
方法一：npm 全局安装	大多数用户	⭐⭐	10-15 分钟
方法二：一键脚本	快速体验	⭐	5-10 分钟
方法三：Docker	容器化部署	⭐⭐⭐	15-20 分钟

推荐选择：

• 首次使用：方法二（最快）
• 长期使用：方法一（最灵活）
• 高级用户：方法三（最专业）