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; dont worry, Ill pretend I didnt see it. Dashboard URL: http://127.0.0.1:7860/?token23588143fd1588692851f6cbe9218ec6b874bb859e775762 Copy to clipboard unavailable. No GUI detected. Open from your computer: ssh -N -L 7860:127.0.0.1:7860 root100.64.232.100 Then open: http://localhost:7860/ http://localhost:7860/?token23588143fd1588692851f6cbe9218ec6b874bb859e775762 Docs: https://docs.clawd.bot/gateway/remote https://docs.clawd.bot/web/control-ui这里有几个关键信息Dashboard URLhttp://127.0.0.1:7860/?token23588143fd1588692851f6cbe9218ec6b874bb859e775762这是带token的完整访问链接127.0.0.1:7860是ClawdBot在服务器本地的地址?token后面那一长串字符就是你的访问令牌SSH端口映射命令ssh -N -L 7860:127.0.0.1:7860 root100.64.232.100这是建立本地到服务器端口映射的SSH命令100.64.232.100需要替换成你服务器的实际IP地址root需要替换成你登录服务器的用户名本地访问地址http://localhost:7860/和http://localhost:7860/?token23588143fd1588692851f6cbe9218ec6b874bb859e775762建立端口映射后在本地电脑访问的地址重要提示上面显示的token23588143fd1588692851f6cbe9218ec6b874bb859e775762只是一个示例你的实际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地址让我解释一下这个命令的各个部分sshSSH客户端命令-N不执行远程命令只建立连接-L 7860:127.0.0.1:7860本地端口映射配置第一个7860是你本地电脑的端口127.0.0.1:7860是远程服务器上ClawdBot的地址用户名服务器IP地址你的服务器登录信息实际操作步骤打开本地电脑的终端Windows用PowerShell或CMDMac/Linux用Terminal执行SSH端口映射命令替换其中的用户名和IP地址ssh -N -L 7860:127.0.0.1:7860 root你的服务器IP输入服务器密码如果使用密钥认证可能需要指定密钥路径命令会保持运行不要关闭这个终端窗口打开浏览器访问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连接后你可以在本地浏览器中尝试访问打开浏览器输入地址http://localhost:7860/?token你的token如果能看到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 } ] } } } }关键配置说明模型提供者providers这里配置了vLLM作为模型后端baseUrlvLLM服务的地址默认是http://localhost:8000/v1apiKeyAPI密钥本地部署通常用sk-localmodels可用的模型列表每个模型需要id和name默认代理配置agents.defaultsprimary默认使用的主模型workspace工作目录路径maxConcurrent最大并发数如何修改模型如果你想使用其他模型比如Qwen2.5-7B-Instruct需要做两处修改在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 } ]在agents.defaults.model.primary中指定要使用的模型primary: vllm/Qwen2.5-7B-Instruct保存配置文件后需要重启ClawdBot服务使更改生效。5.3 通过Web界面修改模型可视化方式如果你更喜欢图形化操作也可以通过ClawdBot的Web界面来配置模型登录ClawdBot控制面板在左侧菜单找到Config配置选择Models模型点击Providers提供者在这里你可以添加、修改或删除模型配置这种方式更直观适合不熟悉JSON配置的用户。6. 常见问题与解决方案在实际使用中你可能会遇到一些问题。这里整理了一些常见问题及其解决方法。6.1 无法访问控制面板问题按照教程操作后仍然无法在浏览器中打开控制面板。可能原因和解决方案SSH连接断开检查运行SSH端口映射的终端窗口是否还在运行如果断开重新执行SSH命令本地端口被占用尝试使用其他本地端口比如7861ssh -N -L 7861:127.0.0.1:7860 root你的服务器IP然后在浏览器访问http://localhost:7861/?token你的tokentoken过期或错误重新执行clawdbot dashboard获取最新的token确保复制完整的token不要遗漏字符ClawdBot服务未运行在服务器上检查ClawdBot服务状态如果需要重启ClawdBot服务6.2 模型加载失败问题控制面板可以访问但模型无法正常加载或使用。排查步骤检查vLLM服务确保vLLM后端服务正在运行检查vLLM服务的端口默认8000是否可访问验证模型配置clawdbot models list如果这个命令没有输出或报错说明模型配置有问题检查配置文件确认clawdbot.json中的模型配置正确特别是baseUrl和模型ID要准确查看日志信息检查ClawdBot和vLLM的日志输出日志中通常会有具体的错误信息6.3 连接速度慢或不稳定问题SSH连接经常断开或者访问速度很慢。优化建议使用SSH保持连接ssh -o ServerAliveInterval60 -N -L 7860:127.0.0.1:7860 root你的服务器IP-o ServerAliveInterval60参数会让SSH每60秒发送一次保持连接的数据包。使用autossh自动重连Linux/Mac安装autosshsudo apt-get install autosshUbuntu/Debian使用autossh代替sshautossh -M 0 -N -L 7860:127.0.0.1:7860 root你的服务器IP考虑网络优化如果服务器在海外连接可能较慢可以考虑使用网络优化工具改善连接质量6.4 忘记token怎么办解决方案重新获取tokenclawdbot dashboard这个命令会显示最新的token。检查配置文件token有时也会保存在配置文件中查看/app/clawdbot.json或~/.clawdbot/clawdbot.json重置token如果需要停止ClawdBot服务删除相关的token文件或配置重启服务后生成新token7. 进阶配置与使用技巧掌握了基础访问和配置后我们来看一些进阶的使用技巧。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 → 远程7860ClawdBot控制面板本地8000 → 远程8000vLLM 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 安全注意事项使用强密码或SSH密钥确保服务器登录安全定期更新token如果怀疑token泄露及时更新限制访问IP在服务器防火墙中限制SSH访问的IP范围使用非标准端口考虑将SSH服务端口从22改为其他端口监控连接日志定期检查服务器的认证日志8. 总结通过这篇教程你应该已经掌握了ClawdBot控制面板访问的核心技能。让我们回顾一下关键步骤第一步获取访问信息使用clawdbot dashboard命令获取带token的访问链接如果需要使用clawdbot devices approve处理设备授权第二步建立本地连接通过SSH端口映射连接本地和远程服务器在本地浏览器访问localhost:7860加上token参数第三步配置和验证使用clawdbot models list验证模型状态通过配置文件或Web界面修改模型设置关键要点记住Token是钥匙没有正确的token无法访问控制面板端口映射是桥梁让本地电脑能访问远程服务配置文件是核心模型和基础设置都在clawdbot.json中命令行是工具大部分操作都可以通过命令行完成ClawdBot作为一个本地部署的AI助手给了你完全的控制权和隐私保护。虽然初始配置可能需要一些步骤但一旦设置完成你就可以享受安全、私密的AI助手服务了。如果你在配置过程中遇到问题不要着急。按照教程一步步检查大多数问题都能找到解决方法。最重要的是理解每个步骤的作用这样即使遇到新问题你也能知道从哪里开始排查。现在打开终端开始配置你的个人AI助手吧获取更多AI镜像想探索更多AI镜像和应用场景访问 CSDN星图镜像广场提供丰富的预置镜像覆盖大模型推理、图像生成、视频生成、模型微调等多个领域支持一键部署。