search

3.1 控制台与 WebChat 快速上手

本节以官方 Web 端为准建立最小闭环：先用 CLI 确认网关健康，再用 Dashboard 打开 WebChat 做一次最小交互验证，并把“新设备访问需要批准”这类常见拦截纳入排障路径。目标是让渠道接入之前就具备一条稳定、可复验的本地基准线。

hashtag
3.1.1 为什么先从 Dashboard 与 WebChat 开始

外部渠道接入会引入大量外部变量：平台限流、回调重试、网络抖动、群聊噪声等。先用本地 Dashboard 与 WebChat 验证主链路，有两个直接收益。

  • 把问题分层：如果本地 WebChat 能跑通，外部渠道失败更可能是渠道配置或平台侧问题。

  • 建立证据链：本地交互更容易复现，日志与 trace 更完整。

官方建议的桌面端入口是 Dashboard，通常运行在 http://127.0.0.1:18789/ 等本地地址。

hashtag
3.1.2 打开 Dashboard：端口、入口与常见拦截

操作步骤建议如下。

hashtag
3.1.2a Dashboard 功能分区概览

Dashboard（Control UI）作为 OpenClaw 的 Web 管理中心，其界面由顶部栏、导航栏和主内容区三部分组成。

顶部栏 左侧为汉堡菜单（≡，可折叠/展开导航栏）和 OpenClaw 标志，右侧为版本号（如 Version 2026.3.8）、健康状态指示灯（Health OK）和主题切换按钮（系统/浅色/深色三选一）。

导航栏 包含以下菜单项，分为两组。第一组（默认可见）共 10 项：

菜单项
路由
功能说明

Chat

/chat

WebChat 对话窗口，支持会话选择、新建会话、流式输出。右上角提供 Thinking 开关（显示模型推理过程）、Focus Mode（隐藏导航栏专注对话）和 Cron Sessions 查看器

Overview

/overview

网关总览页。上方为 Gateway Access 连接信息（WebSocket URL、Token、Session Key、语言设置），下方为 Snapshot 快照卡片（Status、Uptime、Tick Interval、Last Channels Refresh、Sessions、Cron 状态）和 Notes 运维提示

Channels

/channels

渠道管理。展示各渠道（如 Telegram）的运行状态（Configured、Running、Mode、Last start、Last probe）、Accounts 配置、Actions、Allow From 白名单、Block Streaming 开关及 Bot Token 等凭证设置

Instances

/instances

实例列表。显示所有已连接的 gateway 和 webchat 客户端的 presence beacon，包括主机名、IP、操作系统、架构、版本号、角色与权限范围等

Sessions

/sessions

会话管理。列出活跃会话的 Key、Label、Kind、Updated 时间、Token 用量（已用/上限）以及 Thinking、Verbose、Reasoning 三个推理参数的逐会话覆盖设置

Usage

/usage

用量统计与成本分析。支持按日期范围（Today/7d/30d/自定义）和会话过滤，提供 Tokens/Cost 双视图、Activity by Time 时间线图表、Daily Usage 汇总和 Sessions 明细列表，可 Export 导出

Cron Jobs

/cron

定时任务管理。顶部为全局状态（Enabled/Jobs 数量/Next Wake），中部为新建表单（Name、Agent、Enabled、Schedule 间隔与单位、Execution 模式——Main 或 Isolated Session、Wake mode），底部为已有 Jobs 列表

Agents

/agents

智能体配置中心。左侧为智能体列表，右侧为选中智能体的详情面板，包含六个子标签页：Overview（Workspace 路径、Primary Model、Identity Name、Default 状态、Skills Filter、Fallbacks）、Files（核心文件在线编辑：AGENTS.md / SOUL.md / TOOLS.md 等）、Tools（工具权限管理：Profile 预设——Minimal/Coding/Messaging/Full/Inherit，以及逐工具开关）、Skills（技能绑定）、Channels（渠道绑定）、Cron Jobs（该智能体的定时任务）

Skills

/skills

技能管理。展示所有 built-in skills 列表（名称、描述、来源标签如 openclaw-bundled、状态标签如 blocked），支持搜索过滤、逐技能 Disable/Enable 及依赖安装（如 Install 1Password CLI）

Nodes

/nodes

设备与权限管理。上方为 Exec Approvals 策略配置（Target 选择 Gateway/Node、Scope 选择 Defaults/具体智能体、Security Mode、Ask Mode、Ask Fallback），下方为 Devices 列表（已配对设备 ID、角色与权限范围、Token 状态及 Rotate/Revoke 操作）

第二组（点击上方任意菜单项后在扩展区域出现，或直接访问对应路由）共 4 项：

菜单项
路由
功能说明

Config

/config

全局配置编辑器，对应 ~/.openclaw/openclaw.json。左侧为分类树（All Settings、Environment、Updates、Agents、Authentication、Channels、Diagnostics、Logging、Cli、Browser、Ui、Secrets），右侧为 Form/Raw 双模式编辑区，支持搜索、Tag 过滤、Reload/Save/Apply/Update 操作

Debug

/debug

调试快照。以原始 JSON 展示网关内部状态，包括 heartbeat（智能体列表与 cron 间隔）、channelSummary、queuedSystemEvents、sessions 等，用于深度排障

Logs

/logs

实时日志查看器。读取网关日志文件（JSONL 格式），支持按级别过滤（trace/debug/info/warn/error/fatal）、关键词搜索、Auto-follow 自动滚动和 Export visible 导出

Docs

外链

直接跳转至 OpenClaw 官方文档站（docs.openclaw.ai）

在排障流程中，建议先从 Overview 确认网关健康状态，再从 Channels 检查外部渠道连接，最后进入 Chat 做交互验证。如需深入诊断，可依次查看 Logs 和 Debug。

  1. 先确认服务健康。

  1. 打开 Dashboard。

默认情况下，Dashboard 运行在 http://127.0.0.1:18789/。

常见拦截：新浏览器或新设备首次访问需要批准。若 Dashboard 提示设备待批准，可按官方流程列出并批准设备（命令与字段以实际版本为准，参考 onboarding 指南）。

hashtag
3.1.3 WebChat 的交互与流式：看得见的过程更容易排障

WebChat 的关键价值在于把过程暴露出来：模型请求是否发出、工具是否被提议与执行、输出是否在流式返回。对排障而言，最重要的是把每次交互与日志里的 trace 对齐。

操作建议：开启结构化日志并在 Dashboard 的 Chat 界面对比流式输出。

图 3-1：WebChat 对话界面示意。Dashboard 的 Chat 页面提供了完整的交互视图：左侧为对话输入区，右侧或下方展示流式输出，包含用户输入、模型思考过程、工具调用请求与返回结果。部署 OpenClaw 后，可从 Dashboard → Chat 页面直接访问。

hashtag
3.1.4 最小闭环测试用例

建议用可复验的测试用例验证最小闭环，而不是随意发问。

测试用例 1：健康链路确认

  • 动作：先执行 health，再打开 Dashboard。

  • 预期正常输出：

  • Dashboard 访问成功，无设备待批准提示。

测试用例 2：最小交互

  • 动作：在 WebChat 输入 请只输出一个 JSON：{"pong": true}。

  • 预期正常输出：

  • 对应日志片段（结构化日志）：

测试用例 3：流式输出可验证

  • 动作：输入 请分 5 步输出一个排障计划，每步不超过 20 字。

  • 预期正常输出（流式返回）：

  • 预期日志表现：

    • 发现 5 条 chunk_sent 事件，每条对应一个步骤。

    • 若延迟 >5s，查看日志中是否有 tool_call_pending、model_waiting 等迹象。

    • 若完全卡住，查看是否有 error 或 timeout 事件。

上一页第三章 快速上手与首轮对话实战下一页3.2 常用诊断命令与日志排障

最后更新于