主题
访问方式
OpenClaw提供了多种访问方式,满足不同场景下的使用需求。这一章,我们来了解如何与你的AI助手交互。
Web控制台(Dashboard)
Web控制台是OpenClaw的主要交互界面,提供了完整的可视化管理功能。
访问地址:
http://localhost:18789如果是云端部署,将localhost替换为你的服务器IP:
http://你的服务器IP:18789控制台功能:
┌─────────────────────────────────────────────────────────────┐
│ OpenClaw Dashboard [用户] [设置] │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ │ │
│ │ 对话界面 │ │
│ │ ───────────────────────────────────────────────── │ │
│ │ 用户:帮我整理下载文件夹 │ │
│ │ │ │
│ │ OpenClaw:好的,我来帮你整理。首先扫描下载目录... │ │
│ │ ✓ 扫描完成,发现156个文件 │ │
│ │ ✓ 按类型分为5个类别 │ │
│ │ ✓ 整理完成 │ │
│ │ │ │
│ └─────────────────────────────────────────────────────┘ │
│ │
│ [输入消息...] [发送] │
│ │
├─────────────────────────────────────────────────────────────┤
│ 📊 概览 │ 💬 对话 │ 📁 文件 │ ⏰ 任务 │ ⚙️ 设置 │
└─────────────────────────────────────────────────────────────┘主要页面:
| 页面 | 功能 |
|---|---|
| 概览 | 系统状态、使用统计、快捷操作 |
| 对话 | 与AI助手对话的主要界面 |
| 文件 | 文件浏览器,管理上传和生成的文件 |
| 任务 | 定时任务管理,查看执行历史 |
| 设置 | 系统配置、模型设置、渠道管理 |
快捷操作:
bash
# 在控制台中可以使用的快捷键
Ctrl + Enter # 发送消息
Ctrl + L # 清空对话
Ctrl + / # 显示帮助
Esc # 取消当前操作移动端访问:
Web控制台采用响应式设计,在手机浏览器中也能正常使用。建议添加到主屏幕,获得类似原生应用的体验。
终端界面(TUI)
对于喜欢命令行的用户,OpenClaw提供了终端用户界面(TUI)。
启动TUI:
bash
openclaw tuiTUI界面:
┌─────────────────────────────────────────────────────────────┐
│ OpenClaw TUI v1.2.3 [Ctrl+C] 退出 │
├─────────────────────────────────────────────────────────────┤
│ │
│ [10:30:15] 用户: 帮我整理下载文件夹 │
│ [10:30:16] OpenClaw: 好的,我来帮你整理... │
│ [10:30:18] OpenClaw: ✓ 扫描完成,发现156个文件 │
│ [10:30:20] OpenClaw: ✓ 整理完成 │
│ │
├─────────────────────────────────────────────────────────────┤
│ 状态: 🟢 运行中 │ 模型: qwen-plus │ 今日: 45条消息 │
├─────────────────────────────────────────────────────────────┤
│ > _ │
└─────────────────────────────────────────────────────────────┘TUI快捷键:
| 快捷键 | 功能 |
|---|---|
Ctrl+C | 退出TUI |
Ctrl+L | 清屏 |
Ctrl+U | 清除输入行 |
↑ / ↓ | 浏览历史消息 |
Tab | 自动补全命令 |
Ctrl+H | 显示帮助 |
TUI命令模式:
在TUI中,以/开头的输入会被解析为命令:
> /help # 显示帮助
> /status # 查看状态
> /model # 切换模型
> /clear # 清空对话
> /export # 导出对话
> /quit # 退出TUI配置:
yaml
# ~/.openclaw/config.yaml
tui:
# 主题
theme: dark # dark, light
# 字体大小
font_size: 14
# 显示时间戳
show_timestamp: true
# 最大显示行数
max_lines: 1000聊天渠道直接对话
配置好消息渠道后,你可以直接在飞书、钉钉、Telegram等平台与OpenClaw对话。
飞书对话:
┌─────────────────────────────────────┐
│ OpenClaw助手 │
├─────────────────────────────────────┤
│ │
│ [你] 帮我整理下载文件夹 │
│ │
│ [OpenClaw助手] │
│ 好的,我来帮你整理。 │
│ │
│ ✓ 扫描完成:156个文件 │
│ ✓ 分类完成:5个类别 │
│ ✓ 整理完成 │
│ │
│ ───────────────────────── │
│ 10:30 │
└─────────────────────────────────────┘Telegram对话:
┌─────────────────────────────────────┐
│ MyOpenClawBot │
├─────────────────────────────────────┤
│ │
│ You: 帮我整理下载文件夹 │
│ │
│ Bot: 好的,我来帮你整理... │
│ ✓ 扫描完成:156个文件 │
│ ✓ 整理完成 │
│ │
│ ───────────────────────── │
│ 10:30 AM │
└─────────────────────────────────────┘渠道特性对比:
| 特性 | Web控制台 | TUI | 飞书/钉钉 | Telegram |
|---|---|---|---|---|
| 文件上传 | ✓ | ✗ | ✓ | ✓ |
| 图片显示 | ✓ | ✗ | ✓ | ✓ |
| 富文本 | ✓ | ✗ | ✓ | ✓ |
| 语音消息 | ✗ | ✗ | ✓ | ✓ |
| 离线消息 | ✗ | ✗ | ✓ | ✓ |
| 多设备同步 | ✗ | ✗ | ✓ | ✓ |
API访问
对于开发者,OpenClaw还提供了HTTP API接口。
API端点:
http://localhost:18789/api/v1认证:
bash
# 获取API Token
openclaw api token create
# 输出
API Token: sk-api-xxxxxxxxxxxx调用示例:
bash
# 发送消息
curl -X POST http://localhost:18789/api/v1/chat \
-H "Authorization: Bearer sk-api-xxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"message": "帮我整理下载文件夹",
"session_id": "default"
}'
# 响应
{
"response": "好的,我来帮你整理...",
"session_id": "default",
"message_id": "msg_xxxxx",
"tokens": {
"input": 23,
"output": 156
}
}API端点列表:
| 端点 | 方法 | 描述 |
|---|---|---|
/api/v1/chat | POST | 发送消息 |
/api/v1/sessions | GET | 获取会话列表 |
/api/v1/sessions/{id} | GET | 获取会话详情 |
/api/v1/sessions/{id} | DELETE | 删除会话 |
/api/v1/files | GET | 获取文件列表 |
/api/v1/files | POST | 上传文件 |
/api/v1/tasks | GET | 获取任务列表 |
/api/v1/tasks | POST | 创建任务 |
选择适合你的访问方式,开始与OpenClaw互动吧。下一章,我们将详细介绍常用的CLI命令。