OpenClaw Docs CN

基础使用 / 最小验证

第一次发消息测试

第一次测试的目标不是“让它说一句你好”这么简单,而是确认 Dashboard 能发消息、Gateway 能路由、模型能响应、日志能看到完整过程。只有这 4 件事连起来,才算真正跨过“装好了”到“能用了”的那条线。

先记住这一条顺序

很多人一装好就急着去飞书、Telegram 或 QQ 里试,结果一旦没回复,就不知道到底是平台没接好、Gateway 没跑好,还是模型本身没通。最稳的顺序一定是:先本地,再渠道。

开始前先做这 4 个检查

openclaw gateway status
openclaw status --deep
openclaw logs --follow
openclaw doctor

不一定四条都要每天跑,但第一次测试前至少看一下前两条,心里会稳很多。

第一步:先在 Dashboard 里发第一条本地消息

  1. 打开 Dashboard。
  2. 新建一个空会话,别直接用之前乱试过的会话。
  3. 发送一句最简单的测试话术,比如:你好,请先用一句话确认你已经正常工作。

这条消息的目的不是测智能,而是测最小闭环。你要看的不是回复漂不漂亮,而是下面这 3 件事有没有同时发生:

  • 会话列表里出现了这次新会话。
  • 聊天窗口里开始有流式回复或明确报错。
  • 日志里看得到消息进入、模型调用和返回过程。

第二步:确认什么才算真的成功

  • 你发出的消息真的进了会话。
  • 模型返回了可读文本,而不是空白挂住。
  • 日志没有明显报鉴权、网络、模型 provider 错误。
  • 如果你换一个新会话再发一次,仍然正常。

只要这 4 条满足,后面接渠道和装 Skill 都会顺很多。

第三步:再做一个稍微像真实任务的测试

第一轮只是验证“能说话”,第二轮才验证“是不是接到了你预期的模型”。你可以再发这样一条:

请用 3 条要点总结:OpenClaw 的 Gateway、Workspace 和 Dashboard 分别是什么。

这条测试更有价值,因为它能帮你看出:

  • 模型是不是在正常理解中文。
  • 输出是不是结构化的。
  • 回复速度是不是异常慢。

如果中途卡住,先用这几个斜杠命令

/status
/new
/reset
/stop

如果第一次测试卡住,不一定要立刻重启服务。很多时候先用 /stop 停掉当前回合,或者 /new 开一个新会话,会比反复重装有效得多。

第四步:本地测试过了,再做平台测试

等本地测试通过以后,再去你已经接好的渠道里发最简单的消息,比如:

  • 飞书 / 钉钉:@机器人 你好,渠道测试
  • Telegram:/start 后再发 hello
  • Discord:直接私聊 Bot 或在有权限的频道里 @ 它

这时你要重点比对两处:

  1. 平台里有没有收到回复。
  2. Dashboard / Logs 里有没有看到对应入站消息。

不要把下面这些东西当成“成功标准”

  • 页面能打开。
  • 模型配置页看起来像是填好了。
  • 曾经回复过一次,但第二次就没反应。
  • 渠道里有入站,但日志里一片空白。

这些都只能算“部分正常”,不能算真正稳定可用。

如果第一次测试失败,按这个顺序排

  1. 先看 openclaw gateway status
  2. 再看 openclaw status --deep
  3. 同时开着 openclaw logs --follow 再试一次。
  4. 如果是平台消息不回,再补 openclaw channels status --probe
  5. 如果明显是环境或凭证问题,再跑 openclaw doctor

这个顺序的好处是:先排运行态,再排消息路由,再排模型和环境,不会一上来就走最重的动作。

一个可复制的新手最小检查流程

openclaw dashboard
openclaw gateway status
openclaw logs --follow

然后在 Dashboard 里发一句:你好,请确认你已正常工作。

如果这一步没问题,再继续做更复杂的测试和渠道接入。

建议搭配阅读

官方参考