Safe onboarding first
安全上手 OpenClaw，从第一次安装到第一次跑通
不先追“最全”或“最热”，先帮你在可控风险下把 OpenClaw 装起来、用起来， 避开常见坑，再持续跟进值得装的 Skill 和高手分享成果。
Start here
01 先按系统选安装路径
02 再看权限、联网和文件写入边界
03 做首次配置和第一个可验证任务
04 再进入更新、Skills 和 Showcase
信任基线
先把边界讲清楚
站点的主任务不是堆链接，而是让用户知道什么能照着做，什么必须先理解风险。
本周你能找到
新手路径 + 兼容提醒
首页先解决第一步，更新区再承接活跃用户的回访理由。
首页后半段
结果证明 + 投稿样板
借一点故事感，但不用高噪音叙事，把说服力落在真实结果和限制条件上。
按系统拆分教程
Windows、macOS、Linux 分开写，避免不同环境步骤混在一起。
风险前置提示
高权限、Shell、联网和账号依赖都会先说边界，再讲操作。
版本兼容说明
教程、Skill、Showcase 都会标适用版本、验证日期和已知限制。
人工精选收录
先做少而可信的目录，不追海量，不把目录做成无门槛插件市场。
Decision start
先做判断，再决定往下点哪一条。
首页不只是分发链接，而是先帮你判断：你现在是该安装、该避坑、该追更新，还是该看编辑精选。
首页升级目标
把它做成判断入口，而不是资料堆。
真正值钱的不是“这里有很多内容”，而是“你能更快知道现在最该看什么、先别碰什么”。
Quick start
第一次来到这里，你应该很快知道下一步该点哪里。
每张卡片都会直接告诉你适合谁、预计耗时、要准备什么，以及最容易踩的坑。
快速开始
先选最适合你的入口，再往下看。
如果你是第一次接触 OpenClaw，优先从安装和安全开始；已经在用的人再看更新和 Skills。
我是 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 值不值得装，要先问它要求了什么权限
来源可信、权限清晰、可复现，比功能描述更重要。
适合谁
准备提交 Showcase、分享包或公开整理工作流的人
公开分享前先排除敏感内容，不要让展示素材变成泄漏入口
很多最有说服力的材料也最容易夹带凭证、私密记忆和未授权数据。
Updates and skills
如果你已经在用 OpenClaw，这里帮你更快判断什么值得看、什么值得装。
更新区先说变化会影响什么，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
Latest worth your time
最近新增与最近值得看的内容，应该能一眼被看见。
如果首页想变成会被反复回来的判断入口，就不能只讲长期定位，还要持续告诉用户最近什么值得花时间。
现在的首页信号
新内容不只用来补库存，也要用来制造复访理由。
安全深读、编辑精选 Skill 和更新解读，是当前最适合反复回看的三类内容。
新 Skill
Deploy Proof Checklist
把 build、部署、线上抽查和发布证据绑成一个闭环，避免“本地好了”就误以为已经上线。
新 Skill
Update Impact Mapper
把一次 OpenClaw 更新拆成“影响谁、先改哪里、旧内容要不要降权”的编辑判断图。
新 Showcase
Release Proof Runbook
把 build、发布、线上抽查和证据留存压成一套可回看的发布闭环，而不是停在“本地看起来没问题”。
新 Showcase
Update Impact Desk
把一次 OpenClaw 更新转成站内可执行的影响图：先回答影响谁、先改哪页、哪些旧内容该降权。
本周升级
Skills 判断分层
先把“新手先看 / 低风险优先 / 仅适合进阶用户”分清，再决定装什么。
安全深读
浏览器接管与联网访问
明确哪些网页动作适合做，哪些必须保留人工监督。
Featured showcase
这里的 Showcase，重点是让你看到 OpenClaw 真正能帮你做成什么。
每个案例都会尽量把结果、适用场景、限制和风险说清楚，方便你判断值不值得继续了解。
Morning Brief Desk
适合内容运营、研究助理和团队负责人
能力证明
能把散乱素材整理成可直接转发的晨报初稿，并标出待人工确认段落。
边界提示
不保证事实绝对完整，不替代最终发布前的人工审核。
Inbox Triage Operator
适合每天邮件量高、需要快速归类和回复草稿的用户
能力证明
先分层级，再给出建议动作，不直接替用户外发。
边界提示
不保证分类永远正确，也不保证草稿可以直接外发。
Weekly Ops Digest
适合需要横向追踪项目状态的运营与项目负责人
能力证明
能把多来源状态整理成一页周报，并清楚标出信息缺口。
边界提示
不保证周报内容天然准确，缺口标注后的人工追问仍然必要。
Approval Watchtower
适合经常处理文件写入、Shell 和外部提交动作的个人维护者与小团队
能力证明
能把高风险动作拆成待批清单、影响说明和失败停点，而不是把整段执行链路打包成黑箱。
边界提示
不保证批准后动作一定安全，只保证风险表达更完整、更可判断。