跳转到内容

访问方式

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 tui

TUI界面:

┌─────────────────────────────────────────────────────────────┐
│ 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/chatPOST发送消息
/api/v1/sessionsGET获取会话列表
/api/v1/sessions/{id}GET获取会话详情
/api/v1/sessions/{id}DELETE删除会话
/api/v1/filesGET获取文件列表
/api/v1/filesPOST上传文件
/api/v1/tasksGET获取任务列表
/api/v1/tasksPOST创建任务

选择适合你的访问方式,开始与OpenClaw互动吧。下一章,我们将详细介绍常用的CLI命令。

基于 MIT 许可发布