OpenClaw 运维手册 | 第 2 期:快速上手篇

从 0 到 1 搭建你的 AI 助手

30 分钟完成部署 · 约 5200 字 · 阅读需 12 分钟

这是「OpenClaw 运维手册」连载的第 2 期，共 8 期。

上期我们了解了 OpenClaw 的架构和核心概念，今天进入实战环节——手把手教你从零开始部署一个能用的 AI 助手。

无论你是技术小白还是运维老手，按照本文步骤操作，保证 30 分钟内让你的 AI 助手跑起来。

✅ 本期你将学会：

• 环境准备与一键安装

• 配置文件详解与个性化设置

• 启动服务与状态检查

• 第一个技能测试

• 常见问题快速排查

📋 第一步：环境准备（5 分钟）

1.1 系统要求

OpenClaw 支持主流操作系统，对硬件要求极低：

Linux: Ubuntu 20.04+ (推荐 22.04+)

macOS: 10.15+ (推荐 12.0+)

Windows: 10/11 (WSL2 推荐)

内存: 2GB (推荐 4GB+)

磁盘: 1GB (推荐 5GB+)

💡 提示：推荐使用 Linux 服务器长期部署，稳定性最佳。

📦 第二步：安装 OpenClaw（5 分钟）

2.1 一键安装

使用 npm 全局安装 OpenClaw：

预期输出：2026.3.13 或更高版本

⚙️ 第三步：初始化配置（10 分钟）

配置文件位于：~/.openclaw/openclaw.json

最小可用配置：

🚀 第四步：启动服务（5 分钟）

预期输出：✅ Gateway Status: Active (running)

🧪 第五步：测试第一个技能（5 分钟）

在飞书中发送消息：你好

预期回复：你好！我是 OpenClaw 助手，有什么可以帮你的？

🔧 常见问题排查

问题 1：端口被占用
解决：修改 openclaw.json 中的 gateway.port 或关闭占用进程

问题 2：飞书消息无响应
解决：检查 AppID/AppSecret 配置和事件订阅

问题 3：API 调用失败
解决：验证 API Key 是否有效

🎯 下一步行动

✅ 测试更多技能（天气、搜索、文件管理）

✅ 邀请同事体验

✅ 查看技能列表：openclaw skills list

✅ 阅读下期预告：消息通道篇

📖 系列导航

👇 互动话题

你在安装过程中遇到了什么问题？或者有什么想问的？

在评论区留言，我会逐一解答！