OpenClaw 控制面板使用教程：全面指南

OpenClaw 控制面板（Control UI）是一个功能强大的 Web 界面，让你可以直观地管理 Gateway、聊天、配置等。本文将详细介绍控制面板的各项功能。

一、控制面板简介

Control UI 是一个基于 Vite + Lit 构建的单页应用，由 Gateway 直接提供服务。

访问地址：

• 本地访问：http://127.0.0.1:18789/ 或 http://localhost:18789/
• 远程访问：通过 Tailscale 或 SSH 隧道访问
• 自定义路径：可配置 gateway.controlUi.basePath（如 /openclaw）

二、首次连接与设备配对

1. 本地连接

如果 Gateway 运行在同一台电脑上，直接打开浏览器访问上述地址即可。

2. 设备配对（首次远程访问）

从新浏览器或设备连接时，Gateway 需要一次性配对批准。这是安全措施，防止未授权访问。

您会看到错误提示：”disconnected (1008): pairing required”

批准步骤：

# 查看待批准的请求
openclaw devices list

# 批准设备
openclaw devices approve <requestId>

注意：

• 本地连接（127.0.0.1）会自动批准
• 远程连接（LAN、Tailscale 等）需要手动批准
• 每个浏览器配置文件生成唯一设备 ID，清除浏览器数据后需要重新配对

三、控制面板主要功能

1. 💬 聊天功能

• 通过 WebSocket 与模型聊天
• 流式输出工具调用和结果
• 支持停止对话（点击 Stop 按钮或输入 /stop）
• 对话历史会自动保存

2. 📱 频道管理

• 查看 WhatsApp、Telegram、Discord、Slack 状态
• QR 码登录
• 各频道配置管理

3. ⏰ 定时任务（Cron）

• 查看定时任务列表
• 添加、编辑、运行、启用/禁用任务
• 查看任务执行历史

4. 🛠️ 技能（Skills）

• 查看技能状态
• 启用/禁用技能
• 安装新技能
• 更新 API Key

5. 📲 节点管理

• 查看已连接的 iOS/Android 节点
• 查看节点能力

6. ⚙️ 配置管理

• 查看和编辑 ~/.openclaw/openclaw.json
• 配置应用与验证
• 重启 Gateway

7. 🔧 调试功能

• 状态/健康/模型快照
• 事件日志
• 手动 RPC 调用
• 实时日志追踪

四、远程访问设置

方法1：Tailscale Serve（推荐）

openclaw gateway --tailscale serve

然后访问：https://<magicdns>/

方法2：绑定到 Tailscale 网络

openclaw gateway --bind tailnet --token "$(openssl rand -hex 32)"

然后访问：http://<tailscale-ip>:18789/

五、语言支持

Control UI 支持多语言：

• 英语 (en)
• 简体中文 (zh-CN)
• 繁体中文 (zh-TW)
• 葡萄牙语 (pt-BR)
• 德语 (de)
• 西班牙语 (es)

语言会根据浏览器设置自动选择，也可以手动从语言选择器切换。

六、安全注意事项

• 🔒 默认情况下，远程连接需要设备配对
• 🌐 建议使用 HTTPS（Tailscale Serve）访问
• ⚠️ dangerouslyDisableDeviceAuth 选项会禁用设备身份检查，存在安全风险，建议仅紧急情况下使用

七、常见问题

Q: 页面加载失败？

请先启动 Gateway：openclaw gateway

Q: 如何更新 Gateway？

在控制面板的 Update 页面可以运行更新并重启。

Q: 日志在哪里查看？

控制面板的 Logs 页面提供实时日志追踪，支持过滤和导出。

📚 查看官方文档 →

掌握控制面板的使用，你就能更方便地管理 OpenClaw 了！

本文由AI辅助整理发布