OpenClaw 使用教程

Appearance

Control UI / Dashboard 使用指南（SOP） ​

Control UI（也常被叫 Dashboard）是新手最快验证 OpenClaw 是否“能跑、能聊、能调度任务”的入口。

打开方式 ​

bash
openclaw dashboard

或浏览器访问（按你的网关配置为准）：

  • http://127.0.0.1:18789/

最常用的 4 个页面（会用这几个就够了） ​

1) Sessions ​

  • 看你当前对话对应的 session
  • 查看工具调用历史（哪个工具、传了什么参数、返回了什么）

适用：

  • “为什么它没按我说的做？”（大概率能在这里看到工具报错）

2) Cron ​

  • 看定时任务有没有创建成功
  • 看下一次触发时间
  • 看 run history（成功/失败与错误原因）

适用：

  • “为什么没按时提醒？”

3) Tools / Logs ​

  • 查最近一次工具失败的原始报错
  • 定位是参数问题、权限问题、外部服务问题

4) Config（谨慎区） ​

  • 查看/编辑配置
  • 建议流程：先查 schema → 再 patch 最小改动（避免字段名猜错）

最常见问题：Unauthorized / 缺 token ​

现象：

  • 页面空白、提示 unauthorized、或提示 token missing

原因：

  • 你打开的 URL 没带 gateway token

解决（任选一个）：

  1. URL 带 token（最快）
  • http://127.0.0.1:18789/?token=<gateway.auth.token>
  1. 在 UI 的 Settings 里粘贴 token（如果 UI 支持）

token 从哪里来：OpenClaw 配置文件的 gateway.auth.token。

典型排障剧本（你可以直接照着做） ​

当你说“它没反应”时，优先做：

  1. openclaw status --deep
  2. openclaw logs --follow
  3. Control UI → Sessions / Cron / Tools-Logs 看最近一次错误

把错误原文贴给助理，通常 1-2 轮就能定位到：

  • 环境（Node 版本/依赖）
  • 配置（字段/鉴权/token）
  • 权限（设备/渠道授权）
  • 外部服务（模型/渠道 API）