加入我们的 Telegram 社群 (clawdbotCN) 学习分享和了解更多 →
快速开始
控制面板

控制面板

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}

故障排除

无法访问控制面板

  1. 确认网关正在运行: clawdbot status
  2. 检查端口是否被占用: lsof -i :18789
  3. 查看网关日志: clawdbot logs --follow

连接断开

  • 检查网络连接
  • 确认 token 正确
  • 查看浏览器控制台错误

下一步