ClawdBot保姆级教程：clawdbot dashboard获取token及本地端口映射方法

ClawdBot保姆级教程：clawdbot dashboard获取token及本地端口映射方法

1. 引言：你的个人AI助手，在家就能跑

想象一下，你有一个24小时在线的AI助手，它不仅能和你聊天、帮你写东西，还能处理各种任务。最关键的是，它完全运行在你自己的电脑或服务器上，你的所有对话和数据都留在本地，安全又私密。

这就是ClawdBot能带给你的体验。

ClawdBot是一个开源的、可以在你自己设备上运行的个人AI助手。它就像一个智能大脑，通过vLLM后端提供强大的模型推理能力，让你能轻松部署和使用各种大语言模型。今天这篇教程，就是要帮你解决ClawdBot部署后最关键的几个问题：怎么访问它的控制面板？怎么获取访问令牌？以及怎么从本地电脑安全地连接到远程服务器上的ClawdBot？

如果你已经部署了ClawdBot，但发现浏览器打不开控制面板，或者不知道如何配置，那么这篇文章就是为你准备的。我会用最直白的方式，一步步带你搞定这些配置。

2. 为什么需要token和端口映射？

在开始具体操作之前，我们先简单理解一下这两个概念是干什么用的。

访问令牌（Token）就像是进入ClawdBot控制面板的“钥匙”。ClawdBot默认启用了安全验证，没有正确的token，你就无法访问它的Web界面。这保证了只有授权的用户才能操作你的AI助手。

本地端口映射则是一个网络连接技巧。当ClawdBot运行在远程服务器（比如云服务器、家里的NAS或者另一台电脑）上时，它的控制面板通常只能通过服务器的本地地址（如127.0.0.1:7860）访问。这意味着你从自己的电脑浏览器直接输入服务器IP是访问不到的。

端口映射就是建立一条“隧道”，把你本地电脑的某个端口（比如7860）和远程服务器上ClawdBot的端口连接起来。这样，你在自己电脑上访问localhost:7860，实际上访问的就是远程服务器上的ClawdBot。

简单来说：

• Token：解决“能不能进”的问题
• 端口映射：解决“怎么连上”的问题

下面我们就开始具体的操作步骤。

3. 第一步：获取dashboard访问链接和token

当你第一次运行ClawdBot后，最直接的方法就是通过命令行获取访问信息。

3.1 通过命令行获取dashboard链接

在运行ClawdBot的终端中，直接输入以下命令：

clawdbot dashboard

执行后，你会看到类似这样的输出：

🦞 Clawdbot 2026.1.24-3 (885167d) — Your .env is showing; don't worry, I'll pretend I didn't see it. Dashboard URL: http://127.0.0.1:7860/?token=23588143fd1588692851f6cbe9218ec6b874bb859e775762 Copy to clipboard unavailable. No GUI detected. Open from your computer: ssh -N -L 7860:127.0.0.1:7860 root@100.64.232.100 Then open: http://localhost:7860/ http://localhost:7860/?token=23588143fd1588692851f6cbe9218ec6b874bb859e775762 Docs: https://docs.clawd.bot/gateway/remote https://docs.clawd.bot/web/control-ui

这里有几个关键信息：

1. Dashboard URL：http://127.0.0.1:7860/?token=23588143fd1588692851f6cbe9218ec6b874bb859e775762

   • 这是带token的完整访问链接
   • 127.0.0.1:7860是ClawdBot在服务器本地的地址
   • ?token=后面那一长串字符就是你的访问令牌

2. SSH端口映射命令：ssh -N -L 7860:127.0.0.1:7860 root@100.64.232.100

   • 这是建立本地到服务器端口映射的SSH命令
   • 100.64.232.100需要替换成你服务器的实际IP地址
   • root需要替换成你登录服务器的用户名

3. 本地访问地址：http://localhost:7860/和http://localhost:7860/?token=23588143fd1588692851f6cbe9218ec6b874bb859e775762

   • 建立端口映射后，在本地电脑访问的地址

重要提示：上面显示的token（23588143fd1588692851f6cbe9218ec6b874bb859e775762）只是一个示例，你的实际token会是另一串完全不同的字符。请务必使用你自己命令输出中显示的token。

3.2 处理设备授权请求（如果无法访问）

有时候，即使有了正确的链接和token，你可能还是无法访问控制面板。这时候需要检查一下设备授权状态。

在ClawdBot运行的终端中，执行以下命令查看设备列表：

clawdbot devices list

如果看到有状态为pending（等待中）的请求，说明有新的访问尝试需要授权。你会看到类似这样的输出，其中包含待处理的请求信息。

要批准这些请求，使用以下命令：

clawdbot devices approve [request]

将[request]替换为实际的请求ID或标识符。批准后，相应的设备就能正常访问控制面板了。

3.3 直接修改配置文件（备用方案）

如果上述方法都不行，还有一个备用方案：直接修改配置文件。

ClawdBot的主要配置文件位于~/.clawdbot/clawdbot.json。在CSDN星图镜像中，这个文件被映射到了/app/clawdbot.json。

你可以直接编辑这个文件，但一般情况下，通过命令行获取token和进行设备授权就足够了。

4. 第二步：建立本地到远程的端口映射

现在你有了token，但控制面板在远程服务器上，怎么从本地电脑访问呢？这就需要用到端口映射。

4.1 什么是端口映射？

简单理解，端口映射就像是在你的本地电脑和远程服务器之间搭了一座桥。你在本地电脑访问localhost:7860，请求会通过这座桥转发到远程服务器的127.0.0.1:7860，然后再把响应传回给你的本地电脑。

这样做的好处是：

• 安全：不需要在服务器上开放7860端口到公网
• 方便：在本地浏览器就能操作远程服务
• 稳定：通过SSH加密连接，数据传输安全

4.2 使用SSH建立端口映射

从前面clawdbot dashboard命令的输出中，我们已经看到了推荐的SSH命令：

ssh -N -L 7860:127.0.0.1:7860 用户名@服务器IP地址

让我解释一下这个命令的各个部分：

• ssh：SSH客户端命令
• -N：不执行远程命令，只建立连接
• -L 7860:127.0.0.1:7860：本地端口映射配置
  • 第一个7860是你本地电脑的端口
  • 127.0.0.1:7860是远程服务器上ClawdBot的地址
• 用户名@服务器IP地址：你的服务器登录信息

实际操作步骤：

1. 打开本地电脑的终端（Windows用PowerShell或CMD，Mac/Linux用Terminal）

2. 执行SSH端口映射命令，替换其中的用户名和IP地址：

   ssh -N -L 7860:127.0.0.1:7860 root@你的服务器IP

3. 输入服务器密码（如果使用密钥认证，可能需要指定密钥路径）

4. 命令会保持运行，不要关闭这个终端窗口

5. 打开浏览器，访问http://localhost:7860/?token=你的token

注意：如果你在服务器上使用了非默认的SSH端口（不是22），需要在命令中指定端口号：

ssh -N -L 7860:127.0.0.1:7860 -p 2222 root@你的服务器IP

这里的-p 2222表示使用2222端口连接SSH。

4.3 验证连接是否成功

建立SSH连接后，你可以在本地浏览器中尝试访问：

1. 打开浏览器
2. 输入地址：http://localhost:7860/?token=你的token
3. 如果能看到ClawdBot的控制面板登录界面，说明连接成功

如果无法连接，检查以下几点：

• SSH命令是否还在运行（终端窗口不要关闭）
• 本地电脑的7860端口是否被其他程序占用
• 服务器上的ClawdBot服务是否正常运行
• token是否正确

5. 第三步：配置和验证模型

成功访问控制面板后，你可能需要配置或验证ClawdBot使用的AI模型。

5.1 查看当前可用模型

在终端中执行以下命令，查看ClawdBot当前可用的模型列表：

clawdbot models list

你会看到类似这样的输出：

🦞 Clawdbot 2026.1.24-3 (885167d) — Your task has been queued; your dignity has been deprecated. Model Input Ctx Local Auth Tags vllm/Qwen3-4B-Instruct-2507 text 195k yes yes default

这表示系统识别到了一个可用的模型：vllm/Qwen3-4B-Instruct-2507。如果这个列表中有模型显示，基本说明模型配置是成功的。

5.2 通过配置文件修改模型（推荐方式）

如果你想使用其他模型，可以通过修改配置文件来实现。配置文件路径是/app/clawdbot.json（在CSDN星图镜像中）。

以下是配置文件的示例结构，重点关注models部分：

{ "agents": { "defaults": { "model": { "primary": "vllm/Qwen3-4B-Instruct-2507" }, "workspace": "/app/workspace", "compaction": { "mode": "safeguard" }, "maxConcurrent": 4, "subagents": { "maxConcurrent": 8 } } }, "models": { "mode": "merge", "providers": { "vllm": { "baseUrl": "http://localhost:8000/v1", "apiKey": "sk-local", "api": "openai-responses", "models": [ { "id": "Qwen3-4B-Instruct-2507", "name": "Qwen3-4B-Instruct-2507" } ] } } } }

关键配置说明：

1. 模型提供者（providers）：这里配置了vLLM作为模型后端

   • baseUrl：vLLM服务的地址，默认是http://localhost:8000/v1
   • apiKey：API密钥，本地部署通常用sk-local
   • models：可用的模型列表，每个模型需要id和name

2. 默认代理配置（agents.defaults）：

   • primary：默认使用的主模型
   • workspace：工作目录路径
   • maxConcurrent：最大并发数

如何修改模型：

如果你想使用其他模型，比如Qwen2.5-7B-Instruct，需要做两处修改：

1. 在models.providers.vllm.models中添加新模型：

   "models": [ { "id": "Qwen3-4B-Instruct-2507", "name": "Qwen3-4B-Instruct-2507" }, { "id": "Qwen2.5-7B-Instruct", "name": "Qwen2.5-7B-Instruct" } ]

2. 在agents.defaults.model.primary中指定要使用的模型：

   "primary": "vllm/Qwen2.5-7B-Instruct"

3. 保存配置文件后，需要重启ClawdBot服务使更改生效。

5.3 通过Web界面修改模型（可视化方式）

如果你更喜欢图形化操作，也可以通过ClawdBot的Web界面来配置模型：

1. 登录ClawdBot控制面板
2. 在左侧菜单找到"Config"（配置）
3. 选择"Models"（模型）
4. 点击"Providers"（提供者）
5. 在这里你可以添加、修改或删除模型配置

这种方式更直观，适合不熟悉JSON配置的用户。

6. 常见问题与解决方案

在实际使用中，你可能会遇到一些问题。这里整理了一些常见问题及其解决方法。

6.1 无法访问控制面板

问题：按照教程操作后，仍然无法在浏览器中打开控制面板。

可能原因和解决方案：

1. SSH连接断开：

   • 检查运行SSH端口映射的终端窗口是否还在运行
   • 如果断开，重新执行SSH命令

2. 本地端口被占用：

   • 尝试使用其他本地端口，比如7861：

     ssh -N -L 7861:127.0.0.1:7860 root@你的服务器IP

   • 然后在浏览器访问http://localhost:7861/?token=你的token

3. token过期或错误：

   • 重新执行clawdbot dashboard获取最新的token
   • 确保复制完整的token，不要遗漏字符

4. ClawdBot服务未运行：

   • 在服务器上检查ClawdBot服务状态
   • 如果需要，重启ClawdBot服务

6.2 模型加载失败

问题：控制面板可以访问，但模型无法正常加载或使用。

排查步骤：

1. 检查vLLM服务：

   • 确保vLLM后端服务正在运行
   • 检查vLLM服务的端口（默认8000）是否可访问

2. 验证模型配置：

   clawdbot models list

   • 如果这个命令没有输出或报错，说明模型配置有问题

3. 检查配置文件：

   • 确认clawdbot.json中的模型配置正确
   • 特别是baseUrl和模型ID要准确

4. 查看日志信息：

   • 检查ClawdBot和vLLM的日志输出
   • 日志中通常会有具体的错误信息

6.3 连接速度慢或不稳定

问题：SSH连接经常断开，或者访问速度很慢。

优化建议：

1. 使用SSH保持连接：

   ssh -o ServerAliveInterval=60 -N -L 7860:127.0.0.1:7860 root@你的服务器IP

   -o ServerAliveInterval=60参数会让SSH每60秒发送一次保持连接的数据包。

2. 使用autossh自动重连（Linux/Mac）：

   • 安装autossh：sudo apt-get install autossh（Ubuntu/Debian）
   • 使用autossh代替ssh：

     autossh -M 0 -N -L 7860:127.0.0.1:7860 root@你的服务器IP

3. 考虑网络优化：

   • 如果服务器在海外，连接可能较慢
   • 可以考虑使用网络优化工具改善连接质量

6.4 忘记token怎么办

解决方案：

1. 重新获取token：

   clawdbot dashboard

   这个命令会显示最新的token。

2. 检查配置文件：

   • token有时也会保存在配置文件中
   • 查看/app/clawdbot.json或~/.clawdbot/clawdbot.json

3. 重置token（如果需要）：

   • 停止ClawdBot服务
   • 删除相关的token文件或配置
   • 重启服务后生成新token

7. 进阶配置与使用技巧

掌握了基础访问和配置后，我们来看一些进阶的使用技巧。

7.1 使用不同的本地端口

如果你本地电脑的7860端口已经被其他程序占用，可以使用不同的端口进行映射：

ssh -N -L 8888:127.0.0.1:7860 root@你的服务器IP

这样配置后，在本地浏览器访问http://localhost:8888/?token=你的token即可。

7.2 同时映射多个服务

如果你在服务器上运行了多个需要访问的服务，可以一次性映射多个端口：

ssh -N -L 7860:127.0.0.1:7860 -L 8000:127.0.0.1:8000 -L 8080:127.0.0.1:8080 root@你的服务器IP

这个命令同时映射了三个端口：

• 本地7860 → 远程7860（ClawdBot控制面板）
• 本地8000 → 远程8000（vLLM API服务）
• 本地8080 → 远程8080（其他Web服务）

7.3 使用配置文件简化SSH连接

如果你经常需要连接同一台服务器，可以创建SSH配置文件简化操作。

在本地电脑的~/.ssh/config文件中添加：

Host my-clawdbot-server HostName 你的服务器IP User root Port 22 LocalForward 7860 127.0.0.1:7860 ServerAliveInterval 60

保存后，只需要执行：

ssh -N my-clawdbot-server

就可以建立端口映射，不需要每次都输入完整的命令。

7.4 后台运行SSH连接

如果你不想一直开着终端窗口，可以让SSH在后台运行：

ssh -N -L 7860:127.0.0.1:7860 -f root@你的服务器IP

-f参数会让SSH在后台运行。要关闭后台连接，需要找到SSH进程并终止它。

7.5 安全注意事项

1. 使用强密码或SSH密钥：确保服务器登录安全
2. 定期更新token：如果怀疑token泄露，及时更新
3. 限制访问IP：在服务器防火墙中限制SSH访问的IP范围
4. 使用非标准端口：考虑将SSH服务端口从22改为其他端口
5. 监控连接日志：定期检查服务器的认证日志

8. 总结

通过这篇教程，你应该已经掌握了ClawdBot控制面板访问的核心技能。让我们回顾一下关键步骤：

第一步：获取访问信息

• 使用clawdbot dashboard命令获取带token的访问链接
• 如果需要，使用clawdbot devices approve处理设备授权

第二步：建立本地连接

• 通过SSH端口映射连接本地和远程服务器
• 在本地浏览器访问localhost:7860加上token参数

第三步：配置和验证

• 使用clawdbot models list验证模型状态
• 通过配置文件或Web界面修改模型设置

关键要点记住：

1. Token是钥匙：没有正确的token，无法访问控制面板
2. 端口映射是桥梁：让本地电脑能访问远程服务
3. 配置文件是核心：模型和基础设置都在clawdbot.json中
4. 命令行是工具：大部分操作都可以通过命令行完成

ClawdBot作为一个本地部署的AI助手，给了你完全的控制权和隐私保护。虽然初始配置可能需要一些步骤，但一旦设置完成，你就可以享受安全、私密的AI助手服务了。

如果你在配置过程中遇到问题，不要着急。按照教程一步步检查，大多数问题都能找到解决方法。最重要的是理解每个步骤的作用，这样即使遇到新问题，你也能知道从哪里开始排查。

现在，打开终端，开始配置你的个人AI助手吧！

获取更多AI镜像

想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。