随着 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 使用建议

在实际使用中,建议遵循以下原则:

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

参考资料

Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐