OpenClaw Docs CN

基础使用 / 栏目总览

基础使用总览

Basic Usage

装好了以后,先学会看、会查、会验证。

这一栏不再解决“怎么安装”,而是解决更实际的下一步:装好了以后,怎么确认它真的在工作;平时去哪儿看状态;命令到底要记哪些;什么时候该看 Dashboard,什么时候该看日志,什么时候该看 Workspace。

装好后先看这一栏 先验证,再接更多渠道 面向日常使用
For Who

这几类用户最适合先看这一栏

如果你已经完成安装,但还不确定系统是不是“真的能用”,大概率就该从这里开始。

能打开 Dashboard,但不会判断状态 页面能打开不代表系统一切正常,你需要先学会看会话、看日志和看健康状态。
已经想接飞书、钉钉、Telegram 在接平台之前,先完成本地最小可用验证,会帮你少踩很多“其实不是渠道问题”的坑。
会输命令,但不知道哪些最值得记 你不需要背完整个 CLI,只要先掌握最常用的几条命令就够了。
一出问题就想重装 这一栏会先帮你建立正确的排查顺序,让你知道什么时候看 Gateway,什么时候看 Workspace。
Reading Path

最推荐的学习顺序

这一栏最适合按“先看界面,再理解概念,再记命令,再做验证”的顺序往下走。

Quick Choice

如果你现在只想解决一个问题

不用整栏从头读完,直接按你当前最关心的问题跳转就行。

Why This Matters

为什么这里建议先用浏览器,再接更多渠道

很多“机器人不回复”的问题,其实根本不是飞书、Telegram 或 QQ 配错了,而是 OpenClaw 自己还没有进入稳定可用状态。

模型可能还没真跑通

  • Key 虽然填了,但实际上连不上
  • 页面能开,不等于模型能回
  • 第一次本地消息测试最能暴露问题

很多问题先看日志就能定位

  • Gateway 在跑不跑
  • 有没有真实入站消息
  • 模型请求和会话有没有报错

Workspace 很容易被理解错

  • 它不是全部状态目录
  • 它会影响上下文和本地 Skill
  • 一旦搞混,排障会越查越乱
Outcome

学完这一栏以后,你应该达到什么状态

目标不是“背会所有命令”,而是建立一套稳定的日常使用和自查习惯。

你知道平时主要看哪里 会话、状态、日志和渠道这几个区域,不会再一进 Dashboard 就发懵。
你能用几条高频命令自查 至少会用 `gateway status`、`status --deep`、`logs --follow`、`doctor` 这些入口。
你分得清服务和目录 知道 Gateway、Workspace 和真正状态目录分别是什么,不会把问题查到错地方。
你完成过一次最小可用验证 模型、会话和日志都确认正常,后面接渠道和装 Skill 才更稳。

读完这一栏以后,下一步看什么

如果你已经会看状态、会发第一条测试消息,也知道 Gateway 和 Workspace 的区别,下一步最适合二选一: