控制面板
Clawdbot 提供了一个基于浏览器的控制面板,让你可以通过可视化界面管理和监控你的 AI 助手。
访问控制面板
默认情况下,控制面板运行在本地:
http://127.0.0.1:18789/确保网关正在运行后,在浏览器中打开上述地址。
主要功能
会话管理
- 查看所有活跃会话
- 实时监控对话内容
- 手动重置或结束会话
- 查看会话历史和令牌使用量
渠道状态
- 查看各渠道连接状态
- WhatsApp 二维码配对
- 渠道重连和诊断
- 消息统计和分析
代理配置
- 管理多个 AI 代理
- 配置代理绑定规则
- 调整沙箱设置
- 工具权限管理
日志查看
- 实时日志流
- 按级别过滤
- 错误诊断
- 导出日志
安全访问
本地访问
默认配置下,控制面板仅绑定到 127.0.0.1,只能从本机访问。
远程访问
如需远程访问,推荐以下安全方式:
1. Tailscale VPN (推荐)
{
gateway: {
bind: "0.0.0.0:18789",
token: "your-secure-token"
}
}然后通过 Tailscale IP 访问。
2. SSH 隧道
ssh -L 18789:127.0.0.1:18789 user@your-server然后访问 http://127.0.0.1:18789/
Token 认证
启用 token 认证以增强安全性:
{
gateway: {
token: "your-secure-token"
}
}或通过环境变量设置:
export CLAWDBOT_GATEWAY_TOKEN="your-secure-token"键盘快捷键
| 快捷键 | 功能 |
|---|---|
Ctrl + K | 快速搜索 |
Ctrl + L | 清除日志 |
Ctrl + R | 刷新状态 |
Escape | 关闭弹窗 |
WebSocket 连接
控制面板通过 WebSocket 与网关实时通信:
ws://127.0.0.1:18789/ws连接协议:
- 请求:
{type:"req", id, method, params} - 响应:
{type:"res", id, ok, payload|error}
故障排除
无法访问控制面板
- 确认网关正在运行:
clawdbot status - 检查端口是否被占用:
lsof -i :18789 - 查看网关日志:
clawdbot logs --follow
连接断开
- 检查网络连接
- 确认 token 正确
- 查看浏览器控制台错误