Safe onboarding first
安全上手 OpenClaw，从第一次安装到第一次跑通
不先追“最全”或“最热”，先帮你在可控风险下把 OpenClaw 装起来、用起来， 避开常见坑，再持续跟进值得装的 Skill 和高手分享成果。
Start here
01 先按系统选安装路径
02 再看权限、联网和文件写入边界
03 做首次配置和第一个可验证任务
04 再进入更新、Skills 和 Showcase
信任基线
先把边界讲清楚
站点的主任务不是堆链接，而是让用户知道什么能照着做，什么必须先理解风险。
本周你能找到
新手路径 + 兼容提醒
首页先解决第一步，更新区再承接活跃用户的回访理由。
首页后半段
结果证明 + 投稿样板
借一点故事感，但不用高噪音叙事，把说服力落在真实结果和限制条件上。
按系统拆分教程
Windows、macOS、Linux 分开写，避免不同环境步骤混在一起。
风险前置提示
高权限、Shell、联网和账号依赖都会先说边界，再讲操作。
版本兼容说明
教程、Skill、Showcase 都会标适用版本、验证日期和已知限制。
人工精选收录
先做少而可信的目录，不追海量，不把目录做成无门槛插件市场。
Quick start
首页第一目标，是让新手在 30 秒内找到最适合自己的第一步。
这个区域不是文章列表，而是任务分发器。每张卡片都回答适合谁、预计耗时、要准备什么和主要风险。
Entry rule
首屏之后立刻给入口，不先塞内容流。
新手会先按任务进入路径，活跃用户和高端玩家的入口往后放，不抢走首页主线。
我是 Windows 用户，开始安装
第一次在 Windows 上安装 OpenClaw 的用户
预计耗时
15 到 30 分钟
需要准备
模型配置、基础命令行权限、可用网络
主要风险
路径配置错误、权限不清、版本不匹配
我担心安全问题，先看风险清单
担心误删文件、泄露 API Key、执行危险命令的用户
预计耗时
5 分钟
需要准备
无
主要风险
跳过这一步后，容易把教程当成无风险操作手册
我是 macOS 用户，开始安装
需要在 macOS 上快速跑通第一版环境的用户
预计耗时
10 到 25 分钟
需要准备
基础终端操作、模型接入信息
主要风险
权限提示被忽略、Homebrew 依赖不完整
我是 Linux 用户，开始安装
已经熟悉命令行，但需要一条可靠路径的用户
预计耗时
15 到 35 分钟
需要准备
Shell 权限、依赖安装能力、模型配置
主要风险
权限放得过宽、服务依赖版本不一致
我已经装好了，开始第一次配置
想把模型、工具和第一个任务真正跑起来的用户
预计耗时
12 分钟
需要准备
可用模型、最小权限环境、测试任务
主要风险
默认配置照抄后看不懂失败原因
我遇到报错，先查常见问题
已经装过一遍，但卡在权限、环境变量或额度限制的用户
预计耗时
8 分钟
需要准备
错误信息、当前版本、系统环境
主要风险
直接复制陌生命令修错，可能把问题放大
Safety picks
安全中心要在首页前半段出现，而不是等到用户已经踩坑才出现。
这部分的任务不是吓人，而是给用户一个稳定判断标准：什么时候能继续，什么时候该先停下来理解边界。
适合谁
第一次让 Agent 调用文件或命令的用户
最小权限不是保守，而是让错误可控
权限一旦放太宽，报错会直接变成风险。
适合谁
打算接第三方服务或 API 的用户
API Key 与账号隔离要先做，再谈自动化
账号混用会让权限边界和责任追踪同时失效。
适合谁
要让 Agent 读写本地文件的用户
文件读写边界要写清楚，别让成功假象掩盖危险
文件操作最容易把“会用”误判成“可放心长期开着”。
适合谁
会照教程复制命令的新手用户
Shell 风险不在命令本身，而在你没说明上下文
同一条命令在不同机器和不同目录里可能是两回事。
适合谁
正在找可装 Skill 的活跃玩家
第三方 Skill 值不值得装，要先问它要求了什么权限
来源可信、权限清晰、可复现，比功能描述更重要。
Updates and skills
活跃玩家需要的是筛选价值，不是又一个堆新闻和堆工具的页面。
首页中部承接回访理由。更新区先解释变化和影响，Skills 区再给出经过人工判断的精选条目。
官方更新 / 2026.3.12
Dashboard v2 已进入正式 release，首轮起步路径应该围绕它来写
这一版最直接影响的是新手入口：站内后续所有“第一次打开 OpenClaw 怎么开始”的内容，都应该优先围绕 Dashboard onboarding、gateway 状态和 doctor 排错来组织。
涉及范围
适用于新手路径、首页起步卡片
风险提醒
升级后先确认 `openclaw dashboard`、`openclaw gateway status` 与 `openclaw doctor` 这三步正常。
工作流影响
Fast Mode 与消息追踪更适合被写进“老用户先看什么”这条支线
如果你已经在跑自动化链路，这轮 release 更值得优先复核调试路径，而不是只看 UI 变化。站内更新页也应该先解释“旧工作流要不要改”。
涉及范围
适用于活跃玩家、排错与调试内容
风险提醒
先更新验证日期，再决定旧教程是继续保留、补说明，还是临时降权。
Skill 判断
插件来源和安全级别信息变得更重要，目录页可以开始写得更硬
官方 release 已经把插件来源、已发布版本与安全级别摆到了更前面。站内后续写 Skills，不该只写“能做什么”，还要写清来源、风险和验证日期。
涉及范围
适用于 Skills 目录、后续收录标准
风险提醒
没有来源说明、权限边界和验证日期的条目，不要进入首页推荐。
Editor picks
Featured showcase
首页里的 Showcase 只承担两件事：给新手终局想象，给高端玩家投稿样板。
这里不放纯概念宣传，也不放只有炫技视频的页面。每个案例都必须说清价值、证据、边界和安全标签。