ClawdBot详细步骤从docker run到Dashboard访问的全流程解析1. 项目概述ClawdBot是一个可以在本地设备上运行的个人AI助手它使用vLLM提供后端模型能力让你能够快速搭建一个功能强大的AI对话系统。这个项目最大的特点就是简单易用只需要几条命令就能完成部署非常适合想要快速体验AI助手功能的开发者和技术爱好者。简单来说ClawdBot就像是你个人的智能秘书可以帮你处理各种文本相关的任务而且完全运行在你自己的设备上保证了数据隐私和安全。2. 环境准备与快速部署2.1 系统要求在开始之前确保你的系统满足以下基本要求Docker和Docker Compose已安装至少8GB可用内存20GB可用磁盘空间稳定的网络连接2.2 一键部署命令部署ClawdBot非常简单只需要执行以下命令docker run -d \ --name clawdbot \ -p 7860:7860 \ -v ~/.clawdbot:/app \ moltbot/moltbot这个命令做了以下几件事情从Docker Hub拉取moltbot/moltbot镜像创建一个名为clawdbot的容器将容器的7860端口映射到主机的7860端口将本地的~/.clawdbot目录挂载到容器的/app目录用于持久化配置2.3 验证部署状态部署完成后检查容器是否正常运行docker ps你应该能看到clawdbot容器正在运行。如果容器没有启动可以查看日志docker logs clawdbot3. Dashboard访问配置3.1 初始访问问题处理部署完成后直接访问http://localhost:7860可能会遇到无法访问的问题。这是因为需要先处理设备授权请求。首先查看待处理的设备请求docker exec -it clawdbot clawdbot devices list这个命令会列出所有等待批准的设备请求其中包含状态为pending的请求。3.2 批准设备请求找到pending状态的请求后执行批准命令docker exec -it clawdbot clawdbot devices approve [request_id]将[request_id]替换为实际的请求ID。批准后前端应该就能正常访问了。3.3 获取Dashboard访问链接如果仍然无法访问可以通过以下命令获取带token的访问链接docker exec -it clawdbot clawdbot dashboard这个命令会输出一个包含token的URL类似http://127.0.0.1:7860/?token23588143fd1588692851f6cbe9218ec6b874bb859e7757623.4 本地端口转发如果你是在远程服务器上部署需要在本地进行端口转发ssh -N -L 7860:127.0.0.1:7860 your_usernameyour_server_ip然后在本地浏览器中访问http://localhost:78604. 模型配置与自定义4.1 配置文件位置ClawdBot的主要配置文件位于容器内/app/clawdbot.json宿主机~/.clawdbot/clawdbot.json4.2 自定义模型配置如果你想使用自定义模型可以修改配置文件。以下是配置示例{ 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 } ] } } } }4.3 通过UI界面配置模型你也可以通过Dashboard界面配置模型访问Dashboard点击左侧的Config菜单选择Models → Providers在这里添加或修改模型配置4.4 验证模型配置配置完成后验证模型是否可用docker exec -it clawdbot clawdbot models list如果配置成功你会看到类似这样的输出Model Input Ctx Local Auth Tags vllm/Qwen3-4B-Instruct-2507 text 195k yes yes default5. 高级功能配置5.1 频道配置可选ClawdBot支持Telegram等频道集成但由于网络环境限制这部分配置相对复杂。如果你有特殊需求可以参考官方文档进行配置。基本配置示例{ channels: { telegram: { enabled: true, dmPolicy: pairing, botToken: your_bot_token, groupPolicy: allowlist, streamMode: partial } } }5.2 验证频道状态配置完成后可以验证频道状态docker exec -it clawdbot clawdbot channels status --probe6. 使用体验与功能展示成功部署并配置后你就可以通过Dashboard与ClawdBot进行交互了。界面提供了直观的聊天界面你可以文本对话直接输入问题或指令ClawdBot会给出响应文件处理上传文档让ClawdBot进行分析和处理配置管理通过界面修改各种设置和参数会话历史查看和管理之前的对话记录ClawdBot的界面设计简洁易用左侧是功能菜单中间是聊天区域右侧可以显示额外的信息和设置选项。7. 常见问题解决7.1 端口冲突问题如果7860端口已被占用可以改用其他端口docker run -d \ --name clawdbot \ -p 7870:7860 \ -v ~/.clawdbot:/app \ moltbot/moltbot然后访问http://localhost:78707.2 权限问题如果遇到文件权限问题可以尝试sudo chown -R $USER:$USER ~/.clawdbot7.3 容器启动失败如果容器启动失败检查Docker日志docker logs clawdbot常见的启动失败原因包括内存不足端口被占用配置文件格式错误7.4 模型加载失败如果模型无法加载检查模型配置是否正确网络连接是否正常模型文件是否完整8. 总结通过本文的详细步骤你应该已经成功部署并配置了ClawdBot现在可以开始使用这个强大的个人AI助手了。总结一下关键步骤环境准备确保Docker就绪执行一键部署命令访问配置处理设备授权获取访问链接模型配置根据需求自定义模型设置功能体验通过Dashboard与AI助手交互ClawdBot的优势在于部署简单、配置灵活而且完全在本地运行保证了数据安全。无论是用于个人学习、开发测试还是小规模团队使用都是一个很不错的选择。如果你在部署或使用过程中遇到任何问题建议先查看官方文档或者在相关的技术社区寻求帮助。大多数常见问题都能在社区找到解决方案。获取更多AI镜像想探索更多AI镜像和应用场景访问 CSDN星图镜像广场提供丰富的预置镜像覆盖大模型推理、图像生成、视频生成、模型微调等多个领域支持一键部署。