第3讲：Control UI详解，你的OpenClaw控制中心

2026-03-01

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

上一讲我们完成了OpenClaw的安装和启动。今天来详细讲解Control UI —— OpenClaw的Web管理界面。

这是你和AI助手交互的主要入口，也是管理整个Gateway的控制中心。

打开Control UI

确保Gateway正在运行：

1	openclaw gateway status

然后打开浏览器访问：

1	http://127.0.0.1:18789/

或使用命令自动打开：

1	openclaw dashboard

界面布局介绍

Control UI采用三栏式布局：

┌──────────┬─────────────────────┬──────────┐
│          │                     │          │
│  Sidebar │      Main Chat      │  Panel   │
│  侧边栏   │      主聊天区        │  信息面板 │
│          │                     │          │
├──────────┤                     ├──────────┤
│ Sessions │                     │ Tools    │
│ 会话列表  │                     │ 工具状态  │
│          │                     │          │
└──────────┴─────────────────────┴──────────┘

New Chat：新建对话
Sessions：历史会话列表
Settings：设置入口
Status：系统状态

中间主区域（Main Chat）

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

右侧面板（Panel）

Tools：可用工具列表
Context：当前上下文
Usage：用量统计

核心功能详解

1. 新建对话（New Chat）

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

参数设置：

Model：选择AI模型（如claude-3-opus、gpt-4等）
Thinking：推理级别（off/on/stream）
Temperature：创造性程度（0-2）
Max Tokens：最大输出长度

建议：日常使用保持默认即可，需要深度思考时开启Thinking。

2. 对话交互

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

支持的输入类型：

纯文本消息
Markdown格式
代码块（用```包裹）
文件上传（图片、文档等）

快捷操作：

Ctrl+Enter：换行
↑：编辑上一条消息
@：提及工具或引用内容

3. 工具调用展示

当AI使用工具时，界面会实时显示：

🤖 Assistant is thinking...

🔧 Using tool: exec
   Command: ls -la
   
📤 Result:
   total 128
   drwxr-xr-x  5 user group  160 Jan 15 10:30 .
   ...

你可以看到：

工具名称
传入参数
执行结果
耗时统计

4. 会话管理（Sessions）

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

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

操作：

点击切换会话
右键重命名/删除
拖拽排序

5. 工具面板（Tools）

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

内置工具：

✅ exec - 执行shell命令
✅ browser - 浏览器控制
✅ read - 读取文件
✅ write - 写入文件
✅ edit - 编辑文件
✅ web_search - 网络搜索
✅ web_fetch - 网页抓取

状态指示：

🟢 可用
🟡 受限（需要确认）
🔴 禁用

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

来做一个实际练习，让AI帮你分析一个本地文件。

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

创建一个示例文件：

cat > ~/test_data.txt << 'EOF'
销售数据报表 - 2024年1月
==================
产品A: 销售额 ¥150,000，销量 300件
产品B: 销售额 ¥230,000，销量 460件
产品C: 销售额 ¥89,000，销量 178件

总计: ¥469,000
平均客单价: ¥521
EOF

步骤2：在Control UI中提问

输入：

1	请读取~/test_data.txt文件，分析一下销售数据，告诉我哪个产品表现最好，并给出下个月的销售建议。

步骤3：观察工具调用

AI会自动调用read工具读取文件，然后分析并给出回答。

你会在界面上看到完整的工具调用过程。

配置调整

修改模型参数

点击右上角的设置图标：

{
  "model": "claude-3-opus",
  "temperature": 0.7,
  "maxTokens": 4096,
  "thinking": "on"
}

参数说明：

temperature：值越高回答越随机创意，越低越确定保守
maxTokens：限制回答长度，避免过长输出
thinking：是否显示推理过程

开关工具权限

在Tools面板中，可以临时启用/禁用特定工具：

☑️ exec       # 允许执行命令
☑️ browser    # 允许浏览器操作
☑️ read       # 允许读文件
☐ write      # 禁止写文件（防止误操作）

安全建议：生产环境谨慎开启write和exec工具。

高级技巧

1. 多轮对话保持上下文

OpenClaw会自动维护对话历史，你可以连续提问：

1
2
3

你：分析一下这份数据
AI：分析结果...
你：那下个月应该怎么优化？（AI知道"这份数据"指什么）

2. 使用@引用内容

在输入框输入@可以：

@某个文件
@之前的某条消息
@某个工具结果

3. 导出对话记录

点击会话右上角菜单：

Export as Markdown
Export as JSON
Copy to clipboard

4. 快捷键

快捷键	功能
`Ctrl+N`	新建对话
`Ctrl+F`	搜索历史
`Ctrl+/`	显示快捷键帮助
`Esc`	取消生成

常见问题

Q1: Control UI加载很慢

检查网络连接
清除浏览器缓存
尝试无痕模式

Q2: 无法发送消息

确认Gateway状态：openclaw gateway status
检查API密钥是否配置正确
查看日志：tail ~/.openclaw/state/logs/gateway.log

Q3: 工具调用失败

检查工具权限设置
确认沙盒配置
查看具体错误信息

下节预告

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

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

💬 加入学习交流群

Control UI使用有疑问？加群交流：

👉 点击加入交流群

推荐：AI Python编程实战营

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

👉 点击了解详情

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

课程导航

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

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

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

jsonContent: meta: false pages: false posts: title: true date: true path: true text: false raw: false content: false slug: false updated: false comments: false link: false permalink: false excerpt: false categories: false tags: true