github star gitee star atomgit star PyPI Downloads AI 编程 AI 交流群

大家好,我是正在实战各种AI项目的程序员晚枫。

上一讲我们完成了OpenClaw的安装和启动。今天来详细讲解Control UI —— OpenClaw的Web管理界面,这是你和AI助手交互的主要入口。


🚀 开篇:Control UI是什么?

很多同学问过我:OpenClaw装好了,怎么用?

答案就是Control UI。

你可以把它理解为OpenClaw的"遥控器"——一个网页界面,让你不需要敲命令,就能:

  • 和AI聊天
  • 管理会话
  • 配置参数
  • 查看工具状态

打开方式超简单:

1
2
openclaw dashboard
# 或者直接在浏览器访问 http://127.0.0.1:18789/

界面布局详解

Control UI采用三栏式布局:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
┌──────────┬─────────────────────┬──────────┐
│ │ │ │
│ Sidebar │ Main Chat │ Panel │
│ 侧边栏 │ 主聊天区 │ 信息面板 │
│ │ │ │
├──────────┤ ├──────────┤
│ Sessions │ │ Tools │
│ 会话列表 │ │ 工具状态 │
│ │ │ │
│ Settings │ │ Context │
│ 设置入口 │ │ 上下文 │
│ │ │ │
│ Status │ │ Usage │
│ 系统状态 │ │ 用量统计 │
└──────────┴─────────────────────┴──────────┘

左侧边栏(Sidebar)

功能说明
New Chat新建对话按钮
Sessions历史会话列表
Settings设置入口
Status系统运行状态

中间主区域(Main Chat)

  • 💬 消息展示区域
  • ⌨️ 输入框和发送按钮
  • 🔧 工具调用结果展示

右侧面板(Panel)

功能说明
Tools可用工具列表
Context当前上下文
Usage用量统计

核心功能详解

1. 新建对话(New Chat)

点击左上角「New Chat」按钮开始新对话。

参数设置面板

参数说明推荐值
Model选择AI模型claude-3-sonnet
Thinking推理级别off/on/stream
Temperature创造性程度0.0-2.0
Max Tokens最大输出长度4096

参数大白话解释

  • Temperature:值越高回答越"天马行空",越低越"一本正经"。日常聊天用0.7,代码任务用0.3
  • Max Tokens:限制单次回复长度。设太大会浪费钱,设太小AI话没说完就被截断了
  • Thinking:开启后AI会显示推理过程,适合复杂问题,不适合简单问题

2. 对话交互

在底部输入框输入消息,按Enter发送。

支持的输入类型

  • ✅ 纯文本消息
  • ✅ Markdown格式(支持加粗、斜体、列表)
  • ✅ 代码块(用```包裹)
  • ✅ 文件上传(图片、文档等)

快捷操作

快捷键功能
Ctrl+Enter换行(输入多行)
编辑上一条消息
@提及工具或引用内容
Esc取消生成

3. 工具调用可视化 🔧

当AI需要执行操作时,界面会实时展示整个过程:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
🤖 Assistant is thinking...

🔧 Using tool: exec
Command: ls -la

📤 Result:
total 128
drwxr-xr-x 5 user group 160 Jan 15 10:30 .
drwxr-xr-x 4 user group 128 Jan 15 09:00 ..
drwxr-xr-x 3 user group 64 Jan 15 09:30 documents/
-rw-r--r-- 1 user group 8192 Jan 15 10:00 notes.md
drwxr-xr-x 2 user group 64 Jan 15 11:00 projects/
-rw-r--r-- 1 user group 4096 Jan 15 10:30 README.md

⏱ Execution time: 245ms

你可以在界面上看到

  • 🔧 工具名称
  • 📥 传入参数
  • 📤 执行结果
  • ⏱ 耗时统计

4. 会话管理(Sessions)

左侧列表展示所有历史会话:

图标含义
💬普通对话
🔧有工具调用的对话
👤特定用户会话
定时任务会话

操作方法

  • 💬 点击 → 切换到该会话
  • 💬 右键 → 重命名/删除/导出
  • 💬 拖拽 → 调整顺序

5. 工具面板(Tools)

右侧展示当前可用的工具:

内置工具一览

工具功能风险
exec执行shell命令🔴 高
browser控制浏览器🟡 中
read读取文件🟢 低
write写入文件🟡 中
edit编辑文件🟡 中
web_search网络搜索🟢 低
web_fetch网页抓取🟢 低

状态指示器

  • 🟢 可用 - 可以正常使用
  • 🟡 受限 - 需要确认才能执行
  • 🔴 禁用 - 被安全策略阻止

第一个实战:让AI分析本地文件 🎯

来做一个实际练习,让AI帮你分析一个本地文件。这个场景非常实用,比如:

  • 分析销售数据
  • 检查代码文件
  • 读取配置文件

步骤1:准备一个测试文件

在终端执行:

1
2
3
4
5
6
7
8
9
10
11
12
cat > ~/test_data.txt << 'EOF'
销售数据报表 - 2024年Q1
==================
产品A: 销售额 ¥150,000,销量 300件,退款率 2.1%
产品B: 销售额 ¥230,000,销量 460件,退款率 1.5%
产品C: 销售额 ¥89,000,销量 178件,退款率 3.8%

总计: ¥469,000
平均客单价: ¥521
最高单笔: ¥25,000
最低单笔: ¥89
EOF

步骤2:在Control UI中提问

输入以下问题:

1
2
3
4
请读取~/test_data.txt文件,分析一下销售数据:
1. 哪个产品表现最好?
2. 哪个产品的退款率需要关注?
3. 给出下个月的销售建议。

步骤3:观察AI的反应

你会在界面上看到:

  1. 🤖 AI正在思考...
  2. 🔧 AI调用了read工具读取文件
  3. 📤 返回文件内容
  4. 💬 AI开始分析并给出回答

步骤4:查看完整分析

AI的回复大概会是这样:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
📊 销售数据分析报告:

1. 表现最好的产品:产品B
- 销售额最高:¥230,000(占总额49%)
- 销量最大:460件
- 退款率最低:1.5%

2. 需要关注的产品:产品C
- 退款率高达3.8%,是产品B的2.5倍
- 建议排查原因:质量?物流?客服?

3. 销售建议:
- 主推产品B,增加库存
- 重点关注产品C的退款问题
- 考虑给产品A做促销,提升销量

配置调整 ⚙️

修改模型参数

点击右上角的⚙️设置图标,你会看到JSON配置:

1
2
3
4
5
6
{
"model": "claude-3-opus",
"temperature": 0.7,
"maxTokens": 4096,
"thinking": "on"
}

工具权限配置

在Tools面板中,可以临时调整工具状态:

1
2
3
4
5
☑️ exec       # 允许执行命令
☑️ browser # 允许浏览器操作
☑️ read # 允许读文件
☐ write # 禁止写文件(防止误操作)⚠️
☑️ web_search # 允许搜索

⚠️ 安全建议:生产环境建议禁用write工具,防止AI误删文件。


高级技巧 🚀

1. 多轮对话保持上下文

OpenClaw会自动维护对话历史,你可以:

1
2
3
4
5
你:分析一下这份数据
AI:分析结果...

你:那下个月应该怎么优化?
AI:(AI知道"这份数据"指什么,继续分析)

不需要重复说明上下文,AI会记住之前说的内容。

2. 使用@引用内容

在输入框输入@可以:

  • @某个文件 - 引用文件内容
  • @之前的消息 - 引用之前的对话
  • @某个工具 - 指定使用特定工具

3. 导出对话记录

点击会话右上角菜单:

选项说明
Export as Markdown导出为Markdown格式
Export as JSON导出为JSON格式
Copy to clipboard复制到剪贴板

4. 快捷键大全

快捷键功能
Ctrl+N新建对话
Ctrl+F搜索历史
Ctrl+/显示快捷键帮助
Esc取消正在生成的回答
编辑上一条消息

截图说明

📸 Control UI主界面截图
[此处应有截图:展示完整的Control UI界面,包括侧边栏、聊天区和工具面板]

📸 工具调用过程截图
[此处应有截图:展示AI调用exec工具时的界面,包括命令、输出和耗时]

📸 会话管理界面截图
[此处应有截图:展示左侧会话列表和右侧工具面板]


常见问题

Q1: Control UI加载很慢

可能原因

  • 网络连接不稳定
  • 浏览器缓存太多
  • Gateway资源不足

解决

1
2
3
4
# 清除浏览器缓存试试
# 或使用无痕模式打开
# 或重启Gateway
openclaw daemon restart

Q2: 无法发送消息

排查步骤

1
2
3
4
5
6
7
8
# 1. 确认Gateway状态
openclaw gateway status

# 2. 检查API密钥是否配置正确
openclaw config show | grep apiKey

# 3. 查看日志
tail -f ~/.openclaw/state/logs/gateway.log

Q3: 工具调用失败

可能原因

  • 工具权限被禁用
  • 命令不存在
  • 文件路径错误
  • 沙盒限制

解决

  1. 检查工具权限设置
  2. 确认工具参数正确
  3. 查看具体错误信息

下节预告

下一讲我们将深入配置文件详解,学习如何通过修改openclaw.json来自定义OpenClaw的行为。

👉 继续阅读:第4讲-配置文件详解与核心参数


💬 加入学习交流群

Control UI使用有疑问?加群交流:

👉 点击加入交流群


推荐:AI Python编程实战营

🎁 限时福利:送《利用Python进行数据分析》实体书

👉 点击了解详情


---## 📚 完整学习路线这是OpenClaw入门课程的第X讲。查看完整课程大纲:👉 **OpenClaw入门课程大纲**课程包含30讲,从安装部署到实战项目,带你全面掌握OpenClaw。

课程导航

上一篇: 第2讲-安装与初始化

下一篇: 第4讲-配置文件详解与核心参数


PS:Control UI是OpenClaw最常用的界面,花点时间熟悉它,后续操作会事半功倍。


💬 联系我

平台账号/链接
微信扫码加好友
微博@程序员晚枫
知乎@程序员晚枫
抖音@程序员晚枫
小红书@程序员晚枫
B 站Python 自动化办公社区

主营业务:AI 编程培训、企业内训、技术咨询

🎓 AI 编程实战课程

想系统学习 AI 编程?程序员晚枫的 AI 编程实战课 帮你从零上手!