不用装依赖也能管？ClawdBot SSH 隧道直连 Dashboard 实战

在本地AI助手越来越流行的今天，ClawdBot 以其完全离线、可控、多通道接入的特性，成为许多技术爱好者和开发者的首选。它支持 WebUI、Telegram、CLI 等多种交互方式，后端由高效的 vLLM 驱动，即便在树莓派或普通服务器上也能流畅运行大模型。然而，很多用户在实际使用中会遇到一个常见痛点：如果 ClawdBot 部署在远程服务器或树莓派上，本地电脑却不想安装任何依赖（Docker、Node.js、Python 等），还能不能轻松管理 Dashboard、切换模型、查看对话历史？

答案是肯定的——通过 SSH 隧道直连，你可以完全零本地依赖，只需一台能 SSH 登录的电脑，就能直接在本地浏览器打开 ClawdBot 的完整 Web Dashboard，实现“远程管本地”的极简体验。本文将手把手带你完成从服务器部署到 SSH 隧道直连的全流程实战，帮助你彻底摆脱本地环境配置的烦恼。

文章导航

1. ClawdBot 为什么值得远程部署？

ClawdBot 是一个真正自主可控的本地 AI 助手系统，所有推理、记忆、工具调用都在你的设备上完成，无需任何云端服务。它支持：

多模型热切换：Qwen3、DeepSeek、Llama3 等
多通道接入：Telegram、WebUI、CLI
持久化工作区与长期记忆
Agent 编排与多模态能力
标准 OpenAI 兼容 API，可无缝对接现有工具链

相比其他本地方案，ClawdBot 的优势在于“开箱即用 + 深度可扩展”：新手几分钟就能跑通，老手可以轻松定制工作流。更重要的是，它官方提供预编译的 Docker 镜像，支持 amd64 和 arm64 架构，完美适配云服务器、树莓派、旧电脑等场景。

将 ClawdBot 部署到远程服务器（或树莓派）的好处显而易见：

24/7 在线，不占用本地电脑资源
利用服务器更高性能：GPU、内存
多设备随时访问：手机、笔记本、平板
数据完全留在你自己的机器上，隐私安全

而通过 SSH 隧道直连 Dashboard，你甚至不需要在本地安装任何图形界面工具，就能实现完整的可视化管理。

2. 传统本地部署 vs 远程 + SSH 隧道部署对比

很多用户习惯直接在本地电脑运行 ClawdBot，但当你希望它常驻后台、或利用服务器性能时，远程部署 + SSH 隧道才是更优解。下面用表格直观对比两种方式：

维度	本地直接部署	远程服务器 + SSH 隧道直连
本地依赖要求	需要 Docker、端口映射等	完全零依赖，只需 SSH 客户端
资源占用	占用本地电脑 CPU/GPU/内存	服务器承担所有计算，本地只浏览
在线时长	随电脑开机而定	24/7 常驻
多设备访问	需内网穿透或公网暴露	任意设备只要能 SSH 即可访问
安全性	本地安全，但易受本地环境影响	SSH 加密隧道 + 本地不暴露端口，更安全
管理便利性	直接浏览器访问	通过本地浏览器无缝访问远程 Dashboard
适用场景	单机日常使用	生产级部署、多人共享、树莓派边缘计算

显然，对于希望“轻量化本地、重量级服务器”的用户，SSH 隧道方案几乎是完美解法。

3. 实战准备：服务器环境与基础要求

开始之前，确保你有一台可 SSH 登录的远程服务器或树莓派。推荐配置：

系统：Ubuntu 22.04/24.04、Debian 12、Raspberry Pi OS 64-bit（Bookworm）
内存：至少 4GB；推荐 8GB+，用于加载 4B~8B 模型
存储：建议 SSD，至少 20GB 可用空间
网络：公网可访问 SSH（端口 22 或自定义）

安装基础依赖（只需在服务器执行一次）：

# 更新系统
sudo apt update && sudo apt upgrade -y

# 安装 Docker
sudo apt install ca-certificates curl -y
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y

# 测试 Docker
sudo docker run hello-world

树莓派用户额外注意：使用 64 位系统，避免 microSD 卡 I/O 瓶颈，建议挂载 USB SSD。

4. 一键部署 ClawdBot 到远程服务器

ClawdBot 官方镜像已预编译好所有依赖，一条命令即可启动：

docker run -d \
  --name clawdbot \
  -p 7860:7860 \
  -p 18780:18780 \
  -v ~/.clawdbot:/app/.clawdbot \
  -v ~/clawdbot-workspace:/app/workspace \
  --restart=unless-stopped \
  --shm-size=2g \
  clawdbot/clawdbot:latest

命令解析：

-p 7860:7860：Web Dashboard 端口
-p 18780:18780：WebSocket 网关端口（供 Telegram 等通道使用）
-v ~/.clawdbot:/app/.clawdbot：持久化配置
-v ~/clawdbot-workspace:/app/workspace：持久化对话与文件
--shm-size=2g：为 vLLM 分配足够共享内存（树莓派必备）

首次启动会自动下载默认 Qwen3-4B 模型（约 2.3GB），等待 1-3 分钟。查看日志确认启动成功：

docker logs -f clawdbot

看到类似输出即表示正常：

🦞 Clawdbot 2026.x.x — Gateway ready on ws://localhost:18780
WebUI available at http://localhost:7860

5. SSH 隧道直连 Dashboard 核心实战

现在最关键的一步：本地零依赖访问远程 Dashboard。

5.1 最简方式：SSH 动态端口转发

在本地电脑（Windows/macOS/Linux 均可）打开终端，执行：

ssh -N -L 7860:127.0.0.1:7860 user@your-server-ip

user：你的服务器用户名（通常是 root 或 ubuntu）
your-server-ip：服务器公网 IP
-N：不执行远程命令，只转发
-L 7860:127.0.0.1:7860：将本地 7860 端口映射到服务器的 7860 端口

保持此终端窗口打开（或后台运行），然后在本地浏览器访问：

http://localhost:7860

你会看到 ClawdBot 的完整 Dashboard！无需任何本地安装。

5.2 首次访问设备授权（必须步骤）

ClawdBot 采用设备码安全机制，首次访问会跳转授权页。此时在服务器执行：

docker exec -it clawdbot clawdbot devices list

会显示类似：

ID              Status    Created At          User Agent
d1a2b3c4e5      pending   2026-02-02 04:36   Chrome/120.0.0.0

复制 pending 的 ID，然后批准：

docker exec -it clawdbot clawdbot devices approve d1a2b3c4e5

刷新本地浏览器，即可进入完整控制台。

5.3 更便捷方式：生成带 Token 临时链接

如果你不想每次都手动批准，可以在服务器执行：

docker exec -it clawdbot clawdbot dashboard

它会输出一个带 token 的完整 URL，例如：

Dashboard URL: http://127.0.0.1:7860/?token=abc123def456ghi789...

复制这个完整链接，在本地浏览器打开即可直接登录（无需再次授权，有效期通常 24 小时）。

5.4 多端口同时隧道（WebSocket 网关也直连）

如果想本地 CLI 工具也直连网关，加一个端口映射：

ssh -N -L 7860:127.0.0.1:7860 -L 18780:127.0.0.1:18780 user@your-server-ip

这样本地 ws://localhost:18780 就能直接访问远程网关。

6. 常见问题与解决方案

SSH 隧道使用中可能会遇到一些小坑，以下是真实踩坑记录整理：

问题现象	可能原因	解决方案
浏览器显示“连接被拒绝”	SSH 隧道未建立或端口错误	确认 SSH 命令正在运行，检查本地防火墙是否阻止 7860 端口
Dashboard 空白页或 WebSocket 错误	仅转发了 7860，未转发 18780	同时转发两个端口，或仅用带 token 的 dashboard 链接
树莓派启动慢或模型加载失败	共享内存不足	启动命令加 `--shm-size=2g`，树莓派建议使用 USB SSD
授权后仍无法登录	Token 过期或浏览器缓存	清除浏览器缓存，或重新生成 dashboard 链接
SSH 连接频繁断开	服务器 SSH Timeout 设置过短	编辑 /etc/ssh/sshd_config，增加 ClientAliveInterval 60，重新启动 sshd
Windows 用户 SSH 命令报错	没有内置 SSH 客户端	使用 Windows Terminal（Win10+ 自带）或安装 PuTTY、MobaXterm