OpenClaw 安装部署完全指南:打造你的AI私人助理

随着 AI Agent 技术的发展，越来越多的开发者开始尝试构建属于自己的自动化助手。OpenClaw 就是这样一个开源工具：它可以通过安装不同的 skills（技能插件），让 AI 自动完成写文章、发送消息、调用 API 等各种任务。

本文将带大家一步一步完成OpenClaw的安装、部署以及基础使用，并演示如何将其接入飞书，构建一个简单的自动化工作流。

一、OpenClaw 简介

OpenClaw 是一个开源的 AI Agent 框架，其核心特点是：

插件化设计：通过 skills 扩展能力
可接入多种大模型：如 OpenAI、Claude、DeepSeek 等
可接入消息平台：例如飞书、微信、Slack 等
支持自动化任务执行

简单理解：

OpenClaw = AI大脑 + Skills工具箱

AI 负责理解任务，Skills 负责执行任务。

二、OpenClaw 安装

为了避免直接在主系统运行 AI Agent 带来的安全风险，建议在 WSL2 子系统中进行安装。

整体安装流程如下：

Windows   ↓安装 WSL2   ↓安装 Node.js + npm   ↓使用 npm 安装 OpenClaw

1 安装 WSL2

WSL（Windows Subsystem for Linux）可以在 Windows 中运行 Linux 环境。

注意：WSL 需要 Windows 10 1709 专业版或者 Windows 10 1803 及以上的家庭版，WSL 2 需要 Windows 10 1903 （内部版本 18362）或更高版本（x64）。如果版本较低，请先更新系统。
同时，需要确定BIOS 已经开启了虚拟化，并且已经启动了虚拟机平台功能，详见文档：https://docs.eesast.com/docs/tools/wsl

在 PowerShell（管理员权限） 中执行：

wsl --install

安装完成后重启电脑。

然后查看已安装的 Linux 发行版：

wsl -l -v

如果没有发行版，可以安装 Ubuntu：

wsl --list --onlinewsl --install -d Ubuntu-24.04

启用 systemd（Gateway 网关安装所需）

sudo tee /etc/wsl.conf >/dev/null <<'EOF'[boot]systemd=trueEOF

修改完成后，重启wsl，随后可在Ubuntu中验证安装状态：

systemctl --user status

2 安装 Node.js 与 npm

OpenClaw基于Node.js开发，因此需要安装Node.js运行时。建议使用nvm（Node Version Manager）来管理Node.js版本，这样可以轻松切换不同版本。

这里通过curl命令安装nvm，进入 WSL 终端后执行：

sudo apt-get install curlcurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bashnvm -v

nvm install --lts # 安装 Node 的 LTS 版本nvm ls  # 查看当前已经安装的 Node.js 版本nvm use node # 切换到最新稳定版本的 Node

安装完成后，检查版本，验证安装是否成功：

node -vnpm -v

如果看到版本号说明安装成功。

3 安装 OpenClaw

有以下两种方式安装openclaw：

curl -sSL https://openclaw.ai/install.sh | bash # 通过官方安装脚本安装（推荐）npm install -g openclaw # 使用npm全局安装

安装完成后，初始化OpenClaw：

openclaw init

初始化过程会引导你完成基本配置，包括选择默认的LLM provider、配置API密钥等。完成后，启动Gateway服务：

openclaw gateway start

你可以通过以下命令检查服务状态：

openclaw gateway status

三、OpenClaw 部署

部署的核心步骤：

安装 OpenClaw   ↓安装 Skills   ↓配置模型   ↓运行 Agent

1 安装 Skills

OpenClaw提供了多种官方Skills，涵盖了AI生图、微信公众号发布、天气查询等功能。OpenClaw 本身提供了 Skill 的安装命令：

openclaw skill install <skill-name> # 安装官方收录的skill

还可以使用npx命令安装，该命令除了可安装官方的skill之外，还能安装github库中的skill：

npx clawhub search "postgres backups"# 搜索相关技能npx clawhub install <skill-name> # 安装指定名称的技能npx skills add <repo> -y # 安装GitHub中的skill，repo是仓库链接

安装完成后可以查看已安装技能：

openclaw skills listnpx skills list

推荐安装的 Skills
find-skills：安装后openclaw可以自助查找和安装其他的skills
superpowers：包含代码审查、测试等软件开发必备技能
baoyu-post-to-wechat：微信公众号推文发布
baoyu-image-gen：图片生成
feishu系列

更多skill相关信息访问：https://github.com/libukai/awesome-agent-skills

2 如何开发自己的 Skill

OpenClaw 的 Skill 本质是一个 Node.js 插件，可以看成是教 AI 按固定流程做事的操作说明书，一旦写好，就能像函数一样反复调用。

基本结构如下：

my-skill/├── SKILL.md      # 必需：指令 + 元数据├── scripts/      # 可选：可执行代码├── references/   # 可选：文档资料└── assets/       # 可选：模板、资源

要开发自己的skill，参阅：https://www.runoob.com/ai-agent/skills-agent.html

四、OpenClaw 接入飞书

进入飞书开发平台：https://open.feishu.cn
创建 企业自建应用版本并发布。
获取App ID、App Secre
通过 API 调试台创建飞书群，获取 chat_id
订阅事件：im.chat.member.bot.added_v1、im.message.receive_v1 等

这块步骤比较繁琐，极客时间的这篇文章整理得比较详细，这里不再赘述，详见：https://time.geekbang.org/column/article/946733

五、实战案例

我自己是配置了minimax的模型，然后安装了baoyu-post-to-wechat和baoyu-image-gen这俩skill，全部部署完成后，我想让openclaw帮我生成并发布一篇以“具身智能”为主题的微信公众号文章，直接在对话框输入如下的提示词：

收集关于具身智能技术和应用的所有最新核心信息，包括具身智能技术栈、落地应用场景、标杆企业优势对比、发展趋势等。根据这些素材，写一篇排版精美，适合具身智能技术研究者阅读的微信公众号文章。标题要求吸引人，且带有深度，最后将其保存为草稿到微信公众号后台。

openclaw向我索要了微信开发者平台的AppID、AppSecret以及白名单之后，直接在我的公众号平台生成了一篇文章：“万字深度丨具身智能爆发前夜：技术栈全景与落地图景”，一字未改，大家可以看看效果。

不会的可以看一下YouTube视频教程：https://www.youtube.com/watch?v=2ZZCyHzo9as&t=2231s

六、OpenClaw 使用建议

在实际使用中，建议遵循以下原则：

优先使用稳定 Skill。很多社区 Skill 质量参差不齐，建议优先选择官方 Skill或者Star 数较高的 Skill。
注意 API Key 安全。OpenClaw 需要配置，大模型API Key和平台密钥，建议：使用 .env 文件，千万不要提交到 Git 仓库。
控制权限范围。AI Agent 的能力很强，但也存在风险，建议：限制文件操作目录、控制网络访问权限、在 WSL 或 Docker 中运行。

参考资料

wsl安装：https://docs.openclaw.ai/zh-CN/platforms/windows
skill安装：https://github.com/libukai/awesome-agent-skills
skill开发：https://www.runoob.com/ai-agent/skills-agent.html
openclaw接入飞书：https://time.geekbang.org/column/article/946733
YouTube视频教程：https://www.youtube.com/watch?v=2ZZCyHzo9as&t=2231s