ClawdBot详细步骤：从docker run到Dashboard访问的全流程解析

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 clawdbot

3. 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/?token=23588143fd1588692851f6cbe9218ec6b874bb859e775762

3.4 本地端口转发

如果你是在远程服务器上部署，需要在本地进行端口转发：

ssh -N -L 7860:127.0.0.1:7860 your_username@your_server_ip

然后在本地浏览器中访问：http://localhost:7860

4. 模型配置与自定义

4.1 配置文件位置

ClawdBot的主要配置文件位于：

• 容器内：/app/clawdbot.json
• 宿主机：~/.clawdbot/clawdbot.json

4.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界面配置模型：

1. 访问Dashboard
2. 点击左侧的"Config"菜单
3. 选择"Models" → "Providers"
4. 在这里添加或修改模型配置

4.4 验证模型配置

配置完成后，验证模型是否可用：

docker exec -it clawdbot clawdbot models list

如果配置成功，你会看到类似这样的输出：

Model Input Ctx Local Auth Tags vllm/Qwen3-4B-Instruct-2507 text 195k yes yes default

5. 高级功能配置

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 --probe

6. 使用体验与功能展示

成功部署并配置后，你就可以通过Dashboard与ClawdBot进行交互了。界面提供了直观的聊天界面，你可以：

1. 文本对话：直接输入问题或指令，ClawdBot会给出响应
2. 文件处理：上传文档让ClawdBot进行分析和处理
3. 配置管理：通过界面修改各种设置和参数
4. 会话历史：查看和管理之前的对话记录

ClawdBot的界面设计简洁易用，左侧是功能菜单，中间是聊天区域，右侧可以显示额外的信息和设置选项。

7. 常见问题解决

7.1 端口冲突问题

如果7860端口已被占用，可以改用其他端口：

docker run -d \ --name clawdbot \ -p 7870:7860 \ -v ~/.clawdbot:/app \ moltbot/moltbot

然后访问http://localhost:7870

7.2 权限问题

如果遇到文件权限问题，可以尝试：

sudo chown -R $USER:$USER ~/.clawdbot

7.3 容器启动失败

如果容器启动失败，检查Docker日志：

docker logs clawdbot

常见的启动失败原因包括：

• 内存不足
• 端口被占用
• 配置文件格式错误

7.4 模型加载失败

如果模型无法加载，检查：

• 模型配置是否正确
• 网络连接是否正常
• 模型文件是否完整

8. 总结

通过本文的详细步骤，你应该已经成功部署并配置了ClawdBot，现在可以开始使用这个强大的个人AI助手了。总结一下关键步骤：

1. 环境准备：确保Docker就绪，执行一键部署命令
2. 访问配置：处理设备授权，获取访问链接
3. 模型配置：根据需求自定义模型设置
4. 功能体验：通过Dashboard与AI助手交互

ClawdBot的优势在于部署简单、配置灵活，而且完全在本地运行，保证了数据安全。无论是用于个人学习、开发测试，还是小规模团队使用，都是一个很不错的选择。

如果你在部署或使用过程中遇到任何问题，建议先查看官方文档，或者在相关的技术社区寻求帮助。大多数常见问题都能在社区找到解决方案。

获取更多AI镜像

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