OpenClaw 安装指南：30 分钟搭建你的 AI 军团

零基础也能搭建个人 AI 助手军团，从安装到发布公众号文章一站式搞定

项目地址：https://github.com/openclaw/openclaw^[1]

前言

为什么写这篇？

我在 2026 年 3 月开始使用 OpenClaw，从一脸懵逼到能同时管理 10+ 个 AI Agent，中间踩了不少坑。这篇文章就是把你从"这玩意儿怎么装？"带到"没它我不会工作了"。

谁应该读？

• 第一次接触 OpenClaw 的开发者
• 想搭建个人 AI 助手但不知道从哪开始
• 对自动化工作流、技能扩展感兴趣的技术人

读完你能得到什么？

• ✅ 完整安装流程（含网络问题解决方案）
• ✅ 7 个必装技能推荐
• ✅ 5 个常见坑的避坑指南
• ✅ 从 0 到发布公众号文章的完整工作流

第一阶段：环境准备

系统要求

• macOS / Linux / Windows（本文以 macOS 为例）
• Node.js v18+（推荐 v20+）
• 稳定的网络连接（部分技能需要访问 GitHub）

检查 Node.js 版本

node -v# 输出示例：v25.4.0

如果版本低于 v18，建议升级：

# 使用 Homebrew（macOS）brew install node@20# 或使用 nvmnvm install 20nvm use 20

第二阶段：安装 OpenClaw

一步安装

npm install -g openclaw

验证安装

openclaw --versionopenclaw status

如果看到版本号和状态正常，说明安装成功。

第三阶段：核心配置

模型配置

OpenClaw 支持多种模型提供商：

# 查看支持的模型openclaw models list# 配置默认模型openclaw models auth login --provider <provider-name>

推荐配置：

工作空间初始化

# 创建工作空间（如果首次运行会自动创建）cd ~/.openclaw/workspace# 查看工作空间结构ls -la

核心目录说明：

~/.openclaw/workspace/├── skills/          # 技能目录├── posts/           # 文章输出目录├── memory/          # 长期记忆文件├── SOUL.md          # 人格设定├── USER.md          # 用户信息└── TOOLS.md         # 本地工具配置

第四阶段：必装技能推荐

技能 1：wechat-tech-article（技术文章写作）

# 已内置，无需安装# 使用方法：/wechat-tech-article 写一篇关于 XXX 的文章

用途：结构化撰写微信公众号技术文章

技能 2：image-upload-skill（图片上传）

# 安装（如果未安装）openclaw skills install image-upload-skill

用途：自动上传图片到图床，获取分享链接

技能 3：nano-banana-pro（AI 生图）

# 内置技能，用于生成封面图# 使用方法：/nano-banana-pro 生成一张赛博朋克风格的城市图片

技能 4：multi-search-engine（多搜索引擎）

openclaw skills install multi-search-engine

用途：聚合 17 个搜索引擎（8 个国内 +9 个全球）

技能 5：github（GitHub 操作）

openclaw skills install github

用途：通过 gh CLI 管理 Issues、PRs、CI

技能 6：coding-agent（代码任务代理）

openclaw skills install coding-agent

用途：委托 Codex/Claude Code/Pi 完成编码任务

技能 7：self-improvement（自我改进）

openclaw skills install self-improvement

用途：记录错误和修正，持续改进

第五阶段：实战演练 —— 发布一篇公众号文章

完整工作流

1. 选题 → 2. 大纲 → 3. 写作 → 4. 生成封面 → 5. 格式化 → 6. 发布

步骤 1：用 wechat-tech-article 写作

/wechat-tech-article 写一篇关于 OpenClaw 零基础安装攻略的文章

输出结构：

posts/2026/2026-03-22-openclaw-beginner-install-and-tips/├── 2026-03-22-openclaw-beginner-install-and-tips.md├── outline.md├── research.md└── assets/cover.png

步骤 2：生成封面图

/nano-banana-pro 生成一张"AI 助手军团"主题的封面图，16:9 比例

步骤 3：格式化并发布

手动方案（当前推荐）：

1. 复制 Markdown 内容
2. 粘贴到公众号编辑器
3. 手动上传封面图
4. 预览 → 发布

自动化方案（需安装额外技能）：

# 安装发布技能openclaw skills install wechat-article-publisher-skill# 发布到草稿箱/wechat-article-publisher posts/2026/2026-03-22-openclaw-beginner-install-and-tips/2026-03-22-openclaw-beginner-install-and-tips.md

第六阶段：避坑指南

坑 1：OAuth 令牌过期

症状：OAuth token refresh failed

解决：

openclaw models auth login --provider <provider-name>

坑 2：技能安装失败（网络问题）

症状：npm ERR! network timeout

解决：

# 使用国内镜像npm config set registry https://registry.npmmirror.com# 重试安装openclaw skills install <skill-name>

坑 3：图片上传服务不可用

症状：Catbox/ImgBB 无法访问

解决：

• 临时方案：手动上传图片
• 长期方案：配置备用图床（Imgur/Freeimage）

坑 4：技能冲突

症状：多个技能功能重叠

解决：

• 优先使用内置技能（更稳定）
• 卸载重复的第三方技能

坑 5：记忆文件混乱

症状：AI 回复与上下文不符

解决：

# 清理过期的 memory 文件rm ~/.openclaw/workspace/memory/*.md# 保留 MEMORY.md（长期记忆）

结语

关键结论

下一步行动

1. 今天：完成 OpenClaw 安装 + 配置默认模型
2. 明天：安装 3-5 个核心技能
3. 本周：用 wechat-tech-article 写第一篇文章
4. 下周：搭建完整的发布工作流

写在最后

OpenClaw 最强大的地方不是某个技能，而是可组合的工作流。你今天装的每个技能，都是未来 AI 军团的一个士兵。

欢迎反馈：遇到问题可以在 GitHub 提 Issue，或者在评论区留言。

求 Star：如果这篇文章帮到你，欢迎给 OpenClaw 点个 Star ⭐

相关文章：

• 我开源了一个能发公众号的 AI 助手^[2]
• Multi-Search-Engine：17 个搜索引擎聚合工具^[3]

引用链接