按实际使用顺序排的。每步说清做什么、为什么、怎么算过关。
为什么先配钳子助手？因为后面不管哪个环节出问题，你都可以直接问它。相当于还没上战场就先把军医找好了。
装好打开后会进"初始设置"页面，别跳过，把每项检查过一遍。这些是后面所有功能的地基。
Mac / Windows 用户，下载安装后首次启动自动进初始设置。
Linux / 服务器场景。默认 :1420 面板，:18789 Gateway。
钳子助手跟你后面要养的 OpenClaw Agent 不是一回事。它是内置的独立 AI 助手，专门用来排障、问答、看日志。
常见操作不用从零描述，点卡片就行。不知道点哪张？从"检查系统环境"和"一键排障"开始。
读取 openclaw.json，帮你看服务商、Gateway 和常见配置写错的地方。
检查进程、端口和日志，看看 Gateway 是没启动、没监听，还是状态不对。
看 Node.js、npm、OpenClaw CLI 和端口状态，确认底层环境完整。
配置、模型、Gateway、WebSocket、Node.js 全部串起来跑一遍体检。
从日志里捞 ERROR、WARN、fail 这些关键词，帮你缩小问题范围。
看看哪些 Skills 能用、哪些缺依赖，引导你把缺的补上。
"模型配置"管的是 OpenClaw 用哪个 AI 模型，"服务管理"管的是 Gateway 跑没跑。两个都搞定了，系统主体才算亮起来。
当前版本已经默认纳入更稳的 Gateway 守护策略：刷新节流、连接断线自动重试、重启前缓冲等待，日常使用里更不容易出现频繁闪断。
去"Agent 管理"建你的第一只 Agent。名字取清楚、职责写明白、模型选好，先跑起来再说。
Skills 页面多了个"商店"标签页，在线搜技能、点一下就装好，不用再敲命令行了。不同 Agent 还能分配不同的 Skills 目录。
"页面里能看到 Skill 所以应该能用了吧？"——不一定，要看它是不是显示"可用"状态。
先确保 1-2 个核心能力真的能跑，再慢慢加。
去"实时聊天"发一条消息。前面配的那些东西，在各自页面上可能"看着像好了"，但只有这里回得出来，才说明整条链路真的通了。
回得出来意味着：Gateway 在跑、模型能调、Agent 加载成功、权限没拦。
现在能看到 Agent 在干嘛了——思考中、在规划、等审批这些状态都会显示出来。发消息后底部会有个计时器，超过 3 分钟没回会自动提醒，不会再出现发了消息石沉大海的情况。
"消息渠道"页面统一管外部接入。不管接什么平台，两个前提都一样：Gateway 先跑起来，保存后去平台那边做发布或审批。
需要 App ID 和 App Secret，支持内置/官方插件两种模式。发布后机器人才对他人可见。
需要 Bot Token 和用户 ID。最轻量的选择，适合最快跑通第一个外部渠道。
每做完一步，不确定算不算搞定了，直接问钳子助手："我刚配好了模型，下一步该干嘛？" 比自己在页面里来回找快多了。
用熟了之后，真正省时间的不是"会配"，是"知道该看哪"。
Agent 突然不理人，十有八九是模型掉了。先去检查 API Key、Base URL、主模型连通性。配了备选模型的话，看备选能不能顶上。
自己用就选"仅本机"，要共享就配好 Token 或密码。安全设置没事别乱改。
名字和职责写清楚，改大的之前先备份，一只 Agent 就干一类活。出问题的时候你能马上知道该去改谁。
出问题了别急着重装。先看看实时聊天的表现，再看日志，然后跑一遍系统诊断，最后实在搞不定了再甩给钳子助手。
钳子助手：问问题、排障。服务管理：启停 Gateway、备份配置。日志查看：看 Gateway 和错误日志。记忆文件：看 Agent 的工作记忆。关于：看当前版本。
最常踩的坑，按症状来查。
看完这些就不会被术语绕晕了。
Privix 是你看到的这个软件界面（驾驶舱），OpenClaw 是在后台干活的引擎。没有 OpenClaw，Privix 就是个空壳。
你可以理解为系统的总调度。聊天消息、模型调用、Agent 行为全走它。Gateway 不跑，什么都用不了。
Agent 是一个"角色"。它有自己的名字、模型、规则、记忆和技能范围。新建 Agent 就是造一个新角色出来。
决定 Agent 除了聊天还能干什么的插件。有些 Skill 还需要额外装命令行工具或配环境变量。
Privix 当前版本内置的技能商店。现在装 Skill 可以直接在界面里搜索和安装，不需要再手敲命令。
钳子助手是软件内置的帮你排障的工具，Agent 是你要创建和训练的 AI 角色。一个是客服，一个是你的员工。
只配一个也能跑，但 AI 服务偶尔会抽风。有个备选的话，主的挂了还能自动切过去，Agent 不会跟着一起挂。
Agent 的"工位"。身份定义、行为规则、记忆文件、任务资料都放在这。相当于这个员工的文件夹。
不建议。推荐用"稳定版"就行。升太快可能碰到兼容问题，到时候排障比省的时间还多。