OpenClaw小白使用教程：新手小白秒上手

技术交流
,
1

第一部分：部署安装

步骤 :one:：安装 OpenClaw

打开终端，运行以下命令安装 OpenClaw：

npm install -g openclaw@latest

:light_bulb: 提示：需要 Node.js 24（推荐）或 Node.js 22 LTS（22.16+）

步骤 :two:：初始化配置

运行引导命令完成初始设置：

openclaw onboard --install-daemon

这个命令会：

  • :white_check_mark: 创建配置文件
  • :white_check_mark: 安装 Gateway 守护进程
  • :white_check_mark: 配置基础通道

步骤 :three:：启动 Gateway

# 查看状态
openclaw gateway status

# 启动服务
openclaw gateway start

# 重启服务（如需要）
openclaw gateway restart

步骤 :four:：打开控制面板

在浏览器中访问控制界面：

openclaw web

或者直接访问：http://localhost:8080

:white_check_mark: 部署完成检查清单

  • OpenClaw 已安装（openclaw --version 显示版本号）
  • Gateway 服务正在运行
  • 可以访问 Web 控制面板
  • 已配置 AI 模型 API Key

第二部分：安装技能

什么是技能？

技能是 OpenClaw 的扩展功能模块，可以让助手完成特定任务，比如：

  • :sun_behind_small_cloud: 查询天气
  • :date: 管理日历
  • :camera: 处理图片
  • :magnifying_glass_tilted_left: 搜索网络
  • :memo: 管理 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

:white_check_mark: 技能配置检查

编辑配置文件添加工具依赖：

# 编辑 TOOLS.md 添加你的特定配置
nano ~/.openclaw/workspace/TOOLS.md

第三部分：实战演示

场景 1：查询天气 :sun_behind_small_cloud:

对话示例：

你：今天天气怎么样？

助手：今天上海的天气：
- 天气状况：⛅️ 多云
- 温度：16°C（体感温度 16°C）
- 风速：西南风 12km/h
- 湿度：39%

天气比较舒适，适合外出活动！

背后原理： 自动调用 weather 技能，使用 wttr.in API 获取实时天气数据。

场景 2：处理文档 :page_facing_up:

对话示例：

你：帮我处理桌面的文档，转成 Markdown 格式

助手：好的，我正在处理...
✅ 已完成：
1. 读取了 Word 文档
2. 提取并润色了内容
3. 保存为 Markdown 格式到 ~/Desktop/aa/文档.md

背后原理： 使用 Python 脚本 + python-docx 库处理文档。

场景 3：设置定时任务 :alarm_clock:

对话示例：

你：每 10 分钟提醒我喝水

助手：✅ 定时任务创建成功！
- 名称：喝水提醒
- 频率：每 10 分钟
- 提醒内容：💧 喝水时间到！记得喝一杯水
- 任务 ID：b80ddfad-a019-4d12-86ff-e41314881cf9

背后原理： 使用 cron 工具创建周期性任务。

场景 4：多通道消息 :mobile_phone:

支持的通道：

  • :speech_balloon: WhatsApp
  • :airplane: Telegram
  • :speech_balloon: Discord
  • :red_apple: iMessage
  • :electric_plug: Mattermost（插件）

配置示例：

# 配置 WhatsApp
openclaw configure --channel whatsapp

# 配置 Telegram
openclaw configure --channel telegram

# 配置 Discord
openclaw configure --channel discord

:bullseye: 快速上手练习

完成以下练习巩固学习：

练习 1：基础对话

1. 打开 Web 控制面板
2. 发送消息："你好"
3. 观察助手回复

练习 2：使用天气技能

1. 发送："今天天气怎么样"
2. 查看返回的天气信息
3. 尝试查询其他城市："北京天气"

练习 3：创建定时任务

1. 发送："每 30 分钟提醒我休息眼睛"
2. 确认定时任务已创建
3. 等待第一次提醒

练习 4：文件处理

1. 准备一个文档文件
2. 发送："帮我处理这个文档"
3. 检查输出结果

:books: 常用命令速查

命令 功能
openclaw --help 查看所有命令
openclaw gateway status 查看 Gateway 状态
openclaw gateway start/stop/restart 控制 Gateway 服务
openclaw web 打开 Web 控制面板
openclaw onboard 运行引导向导
openclaw configure 配置各项设置
openclaw status 查看系统状态

:red_question_mark: 常见问题

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
2

感觉看到这攻略已经晚了