Skip to content
今天更新

Web 控制台

OpenClaw 内置了一个 Web 控制台,覆盖日常 90% 的管理操作——查状态、看日志、改配置、直接对话,全在浏览器里完成,无需命令行。

打开控制台

Gateway 启动后,访问:

http://127.0.0.1:18789/

也可以通过 CLI 直接在默认浏览器打开:

bash
openclaw dashboard

默认端口

默认端口 18789,可在 openclaw.json 中修改:

json
{ "web": { "port": 18789 } }

五大功能模块

1. WebChat — 直接对话

无需配置 Telegram、微信等外部平台,打开 WebChat 就能和 Agent 对话。非常适合:

  • 初次体验 OpenClaw,快速验证 Agent 配置是否正确
  • 调试系统提示词效果
  • 内部使用场景(不需要公开给外部用户)

WebChat 支持:

  • Markdown 实时渲染(代码高亮、表格、列表)
  • 文件上传(图片、文档)
  • 会话历史记录
  • 多 Agent 切换

2. 仪表盘 — 实时状态监控

仪表盘汇总网关的实时运行数据:

指标说明
频道状态每个平台的连接状态(在线/断开/认证失败)
活跃会话当前正在进行的对话数量
Token 消耗今日/本月的 API 调用量和费用估算
响应延迟最近 100 条消息的平均响应时间
系统资源CPU、内存占用曲线图

3. 频道管理

在 Web 界面中管理所有已配置的频道,无需手动编辑配置文件:

  • 查看状态:绿色表示正常连接,红色表示需要处理
  • 登录/登出:触发扫码或 Token 验证流程
  • 重连:一键重连断线的频道
  • 修改配置:调整频道参数(如消息过滤规则)

4. 配置编辑器

在线编辑 openclaw.json,带语法高亮和格式验证:

  • 保存时自动验证 JSON 格式
  • 支持注释提示(鼠标悬停显示字段说明)
  • 修改后提示是否需要重启 Gateway

常用于修改:

json
{
  "model": { "default": "deepseek-chat" },
  "agent": { "maxToolCalls": 10 },
  "web": { "auth": { "enabled": true, "password": "your-password" } }
}

5. 日志查看器

实时查看 Gateway 的运行日志:

  • 实时流:像 tail -f 一样自动滚动新日志
  • 级别过滤:只看 errorwarninfodebug
  • 关键词搜索:快速定位特定用户 ID 或错误信息
  • 时间范围:查看历史日志(需配置日志持久化)

开启远程访问

默认只监听本机(127.0.0.1)。如需局域网或公网访问:

bash
# 允许局域网访问
openclaw config set web.host 0.0.0.0

# 开启密码保护(强烈建议开启)
openclaw config set web.auth.enabled true
openclaw config set web.auth.password "你的密码"

# 重启生效
openclaw gateway restart

安全提醒

开放公网访问时务必设置密码。建议配合 Tailscale 使用,避免直接暴露端口。

HTTPS 配置

在 nginx 反向代理前配置 SSL,可以让控制台通过 https:// 访问:

nginx
server {
    listen 443 ssl;
    server_name your-domain.com;

    ssl_certificate     /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://127.0.0.1:18789;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
    }
}

详细配置见 远程访问指南

最后更新于:

觉得有帮助?