前言
OpenClaw Dashboard 是内置的网页管理面板,让你可以通过浏览器直观地管理对话、切换模型、调整设置。本文将带你全面了解 Dashboard 的各项功能。
启动和访问 Dashboard
启动 Dashboard
确保 OpenClaw 网关服务已经运行:
openclaw up -d
然后通过以下命令在浏览器中打开 Dashboard:
openclaw dashboard
该命令会自动打开默认浏览器并访问 Dashboard 地址。
手动访问
你也可以直接在浏览器中输入地址来访问:
http://localhost:18789/dashboard
如果你修改了默认端口,替换为对应的端口号即可。
远程访问
如果 OpenClaw 部署在远程服务器上,需要确保端口已开放,然后通过服务器 IP 访问:
http://your-server-ip:18789/dashboard
出于安全考虑,建议通过 Nginx 反向代理并配置 HTTPS 来访问远程 Dashboard。
界面概览
Dashboard 主界面分为以下几个区域:
| 区域 | 位置 | 功能 |
|---|---|---|
| 侧边栏 | 左侧 | 对话列表、频道管理、设置入口 |
| 主面板 | 中央 | 对话内容显示和消息交互 |
| 顶部栏 | 顶部 | 模型选择、搜索、用户菜单 |
| 状态栏 | 底部 | 网关状态、连接频道数、消息统计 |
侧边栏导航
侧边栏包含以下主要菜单项:
- 对话 - 查看所有对话记录
- 频道 - 管理已连接的消息频道
- 技能 - 浏览和管理已安装的技能插件
- 模型 - 配置 AI 模型及参数
- 设置 - 系统级别设置
- 日志 - 实时查看运行日志
对话管理
查看对话列表
在侧边栏点击"对话",可以看到所有来自各个频道的对话记录。对话列表支持:
- 按频道筛选 - 点击频道图标,只显示来自该频道的对话
- 按时间排序 - 默认按最新消息时间排序
- 搜索对话 - 在顶部搜索栏输入关键词,全文检索对话内容
搜索语法示例:
- 普通文本:直接输入关键词
- 指定频道:channel:whatsapp 关键词
- 指定日期:date:2026-03-20 关键词
- 组合搜索:channel:telegram date:2026-03 部署教程
对话详情
点击某条对话,主面板会显示完整的对话内容。你可以在这里:
- 查看消息流 - 包括用户消息和 AI 回复
- 查看元数据 - 每条消息的时间戳、使用的模型、Token 消耗
- 继续对话 - 在底部输入框直接发送消息继续对话
- 导出对话 - 点击右上角导出按钮,支持 JSON 和 Markdown 格式
手动发起对话
你可以在 Dashboard 中直接发起新对话,不依赖任何消息频道:
- 点击侧边栏顶部的"新建对话"按钮
- 选择要使用的 AI 模型
- 在输入框中输入内容并发送
这对于测试模型配置和调试技能插件非常有用。
模型切换
在顶部栏切换模型
顶部栏有一个模型选择下拉框,显示当前正在使用的模型。点击可以切换到其他已配置的模型:
可选模型示例:
├── Claude 3.5 Sonnet (claude)
├── GPT-4o (openai)
├── Gemini 1.5 Pro (gemini)
├── Llama 3 70B (ollama)
└── Mixtral 8x7B (openrouter)
模型参数调整
在模型选择框旁边,点击齿轮图标可以调整当前模型的参数:
| 参数 | 说明 | 默认值 | 范围 |
|---|---|---|---|
| Temperature | 生成随机性 | 0.7 | 0.0 - 2.0 |
| Max Tokens | 最大输出长度 | 4096 | 1 - 模型上限 |
| Top P | 核采样参数 | 1.0 | 0.0 - 1.0 |
| System Prompt | 系统提示词 | 默认值 | 自由文本 |
修改参数后会立即生效,仅影响当前会话。如果要设置为全局默认值,需要去"设置"页面修改。
频道管理
查看频道状态
在"频道"页面,可以看到所有已配置频道的状态:
频道状态说明:
🟢 已连接 - 频道正常运行中
🟡 连接中 - 正在建立连接
🔴 已断开 - 连接已断开,需要检查配置
⚪ 未启用 - 频道已配置但未启用
频道操作
对每个频道,你可以执行以下操作:
- 启用/禁用 - 切换频道的运行状态
- 重新连接 - 断开后尝试重新建立连接
- 查看日志 - 查看该频道的专属日志
- 编辑配置 - 修改频道的配置参数
设置面板
通用设置
在"设置"页面的"通用"选项卡中,可以调整以下内容:
{
// 网关端口
port: 18789,
// 默认语言
language: "zh-CN",
// 默认模型
defaultModel: "claude",
// 消息历史保留天数
historyRetention: 30,
// 最大并发对话数
maxConcurrent: 10
}
安全设置
安全设置中可以配置:
- Dashboard 访问密码 - 设置登录密码保护面板
- API 密钥管理 - 查看和轮换各模型的 API 密钥(密钥以掩码显示)
- IP 白名单 - 限制可以访问 Dashboard 的 IP 地址
- 会话超时 - 设置自动登出时间
通过命令行也可以快速设置密码:
openclaw config set dashboard.password "your-secure-password"
openclaw restart
主题切换
Dashboard 内置了多套主题可供选择:
- 亮色主题 - 适合日间使用的白色主题
- 暗色主题 - 适合夜间使用的深色主题
- 跟随系统 - 自动跟随操作系统的深色/浅色模式
切换方式:点击右上角用户头像 → 主题设置 → 选择偏好主题。
你也可以通过配置文件设置默认主题:
{
dashboard: {
theme: "dark", // "light", "dark", "system"
}
}
键盘快捷键
Dashboard 提供了丰富的键盘快捷键,提高操作效率:
| 快捷键 | 功能 |
|---|---|
Ctrl + K |
打开搜索面板 |
Ctrl + N |
新建对话 |
Ctrl + / |
显示快捷键帮助 |
Ctrl + , |
打开设置页面 |
Ctrl + Enter |
发送消息 |
Escape |
关闭弹窗/返回上一级 |
Ctrl + Shift + L |
切换侧边栏 |
Ctrl + Shift + D |
切换暗色/亮色主题 |
↑ / ↓ |
在对话列表中导航 |
Ctrl + 1-9 |
快速切换到对应频道 |
在 macOS 上,将 Ctrl 替换为 Cmd 即可。
实时日志查看
在"日志"页面,你可以实时查看 OpenClaw 的运行日志,功能包括:
- 实时流式输出 - 日志以流式方式实时展示
- 日志级别筛选 - 可以按 DEBUG、INFO、WARN、ERROR 筛选
- 关键词过滤 - 输入关键词只显示匹配的日志条目
- 暂停/继续 - 暂停日志滚动以便仔细查看
- 下载日志 - 将当前筛选结果导出为文件
# 也可以通过命令行查看日志
openclaw logs
# 只查看错误日志
openclaw logs --level error
# 实时跟踪日志
openclaw logs -f
移动端适配
Dashboard 已针对移动端进行了响应式适配。在手机浏览器中访问时:
- 侧边栏自动收起,通过汉堡菜单打开
- 消息输入框固定在底部
- 模型切换放在顶部下拉菜单中
- 支持手势操作(左滑打开侧边栏、下拉刷新)
总结
OpenClaw Dashboard 提供了直观的网页界面来管理你的 AI 助手平台。关键操作回顾:
- 通过
openclaw dashboard快速启动并打开面板 - 利用顶部栏快速切换模型和调整参数
- 使用搜索功能和键盘快捷键提高效率
- 在设置面板中配置安全选项保护你的实例
- 善用日志页面进行实时监控和问题排查