openclaw安装、部署和使用
插件化设计:通过 skills 扩展能力可接入多种大模型:如 OpenAI、Claude、DeepSeek 等可接入消息平台:例如飞书、微信、Slack 等支持自动化任务执行简单理解:OpenClaw = AI大脑 + Skills工具箱AI 负责理解任务,Skills 负责执行任务。
随着 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 --online
wsl --install -d Ubuntu-24.04
启用 systemd(Gateway 网关安装所需)
sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF
修改完成后,重启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 curl
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
nvm -v
nvm install --lts # 安装 Node 的 LTS 版本
nvm ls # 查看当前已经安装的 Node.js 版本
nvm use node # 切换到最新稳定版本的 Node
安装完成后,检查版本,验证安装是否成功:
node -v
npm -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 list
npx 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 中运行。
参考资料
更多推荐


所有评论(0)