🦞 OpenClaw 小白使用教程
预计时长：5 分钟 | 难度：入门
📋 目录
第一部分：部署安装
步骤 1️⃣：安装 OpenClaw
打开终端，运行以下命令安装 OpenClaw：
npm install -g openclaw@latest
💡 提示：需要 Node.js 24（推荐）或 Node.js 22 LTS（22.16+）
步骤 2️⃣：初始化配置
运行引导命令完成初始设置：
openclaw onboard --install-daemon
这个命令会：
- ✅ 创建配置文件
- ✅ 安装 Gateway 守护进程
- ✅ 配置基础通道
步骤 3️⃣：启动 Gateway
# 查看状态
openclaw gateway status
# 启动服务
openclaw gateway start
# 重启服务（如需要）
openclaw gateway restart
步骤 4️⃣：打开控制面板
在浏览器中访问控制界面：
openclaw web
或者直接访问：http://localhost:8080
✅ 部署完成检查清单
- OpenClaw 已安装（
openclaw --version显示版本号） - Gateway 服务正在运行
- 可以访问 Web 控制面板
- 已配置 AI 模型 API Key
第二部分：安装技能
什么是技能？
技能是 OpenClaw 的扩展功能模块，可以让助手完成特定任务，比如：
- 🌤️ 查询天气
- 📅 管理日历
- 📷 处理图片
- 🔍 搜索网络
- 📝 管理 GitHub Issues
方法一：使用内置技能
OpenClaw 自带多个常用技能，位于：
~/.nvm/versions/node/v24.11.1/lib/node_modules/openclaw/skills/
查看可用技能：
ls ~/.nvm/versions/node/v24.11.1/lib/node_modules/openclaw/skills/
常见内置技能：
| 技能名称 | 功能描述 |
|---|---|
weather | 天气查询 |
github | GitHub 操作 |
gh-issues | GitHub Issues 管理 |
healthcheck | 系统健康检查 |
node-connect | 节点连接诊断 |
skill-creator | 技能创作工具 |
方法二：从 ClawHub 下载技能
访问技能市场：clawhub.com
下载技能后放入技能目录：
# 示例：下载并安装天气技能
cd ~/.nvm/versions/node/v24.11.1/lib/node_modules/openclaw/skills/
git clone <技能仓库地址>
方法三：自定义技能
使用技能创作工具：
# 创建新技能
openclaw skill-create my-skill
✅ 技能配置检查
编辑配置文件添加工具依赖：
# 编辑 TOOLS.md 添加你的特定配置
nano ~/.openclaw/workspace/TOOLS.md
第三部分：实战演示
场景 1：查询天气 🌤️
对话示例：
你：今天天气怎么样？
助手：今天上海的天气：
- 天气状况：⛅️ 多云
- 温度：16°C（体感温度 16°C）
- 风速：西南风 12km/h
- 湿度：39%
天气比较舒适，适合外出活动！
背后原理： 自动调用 weather 技能，使用 wttr.in API 获取实时天气数据。
场景 2：处理文档 📄
对话示例：
你：帮我处理桌面的文档，转成 Markdown 格式
助手：好的，我正在处理...
✅ 已完成：
1. 读取了 Word 文档
2. 提取并润色了内容
3. 保存为 Markdown 格式到 ~/Desktop/aa/文档.md
背后原理： 使用 Python 脚本 + python-docx 库处理文档。
场景 3：设置定时任务 ⏰
对话示例：
你：每 10 分钟提醒我喝水
助手：✅ 定时任务创建成功！
- 名称：喝水提醒
- 频率：每 10 分钟
- 提醒内容：💧 喝水时间到！记得喝一杯水
- 任务 ID：b80ddfad-a019-4d12-86ff-e41314881cf9
背后原理： 使用 cron 工具创建周期性任务。
场景 4：多通道消息 📱
支持的通道：
- ✈️ Telegram
- 💬 Discord
- 🍎 iMessage
- 🔌 Mattermost（插件）
配置示例：
# 配置 WhatsApp
openclaw configure --channel whatsapp
# 配置 Telegram
openclaw configure --channel telegram
# 配置 Discord
openclaw configure --channel discord
🎯 快速上手练习
完成以下练习巩固学习：
练习 1：基础对话
1. 打开 Web 控制面板
2. 发送消息："你好"
3. 观察助手回复
练习 2：使用天气技能
1. 发送："今天天气怎么样"
2. 查看返回的天气信息
3. 尝试查询其他城市："北京天气"
练习 3：创建定时任务
1. 发送："每 30 分钟提醒我休息眼睛"
2. 确认定时任务已创建
3. 等待第一次提醒
练习 4：文件处理
1. 准备一个文档文件
2. 发送："帮我处理这个文档"
3. 检查输出结果
📚 常用命令速查
| 命令 | 功能 |
|---|---|
openclaw --help | 查看所有命令 |
openclaw gateway status | 查看 Gateway 状态 |
openclaw gateway start/stop/restart | 控制 Gateway 服务 |
openclaw web | 打开 Web 控制面板 |
openclaw onboard | 运行引导向导 |
openclaw configure | 配置各项设置 |
openclaw status | 查看系统状态 |
🔗 更多资源
- 📖 官方文档：docs.openclaw.ai
- 💬 社区 Discord：discord.com/invite/claw…
- 🛠️ 技能市场：clawhub.com
- 📦 GitHub 仓库：github.com/openclaw/op…
❓ 常见问题
Q: Gateway 启动失败怎么办？
# 查看详细日志
openclaw gateway status
# 重启服务
openclaw gateway restart
Q: 如何查看技能列表？
ls ~/.nvm/versions/node/v24.11.1/lib/node_modules/openclaw/skills/
Q: 配置文件在哪里？
~/.openclaw/workspace/
Q: 如何更新 OpenClaw？
npm update -g openclaw
教程完成时间：2026 年 3 月 25 日 祝你使用愉快！🦞
