ClawdBot镜像免配置：docker-compose一键拉起含UI+API+模型服务

1. 快速了解ClawdBot

ClawdBot是一个可以在自己设备上运行的个人AI助手，它使用vllm提供后端模型能力，让你能够快速搭建一个功能完整的AI服务。这个镜像最大的特点就是免配置，通过docker-compose就能一键拉起包含UI界面、API接口和模型服务的完整环境。

想象一下，你只需要运行几条简单的命令，就能拥有一个功能强大的AI助手，既可以通过网页界面交互，也可以通过API调用，还能根据需求更换不同的模型。这就是ClawdBot带来的便利。

2. 环境准备与快速部署

2.1 系统要求

在开始之前，确保你的系统满足以下基本要求：

• 操作系统：Linux、macOS或Windows（建议使用Linux服务器）
• Docker和Docker Compose：已安装并正常运行
• 硬件配置：至少4GB内存，推荐8GB以上
• 存储空间：至少10GB可用空间

2.2 一键部署步骤

部署ClawdBot非常简单，只需要几个步骤：

首先，创建项目目录并进入：

mkdir clawdbot && cd clawdbot

创建docker-compose.yml文件：

version: '3.8'
services:
  clawdbot:
    image: moltbot/moltbot
    ports:
      - "7860:7860"
      - "8000:8000"
    volumes:
      - ./data:/app/data
      - ./config:/app/config
    restart: unless-stopped
    environment:
      - TZ=Asia/Shanghai

启动服务：

docker-compose up -d

等待几分钟后，服务就会启动完成。你可以通过访问 http://你的服务器IP:7860 来打开Web界面。

3. 初始配置与访问设置

3.1 设备授权处理

第一次访问时，可能会遇到无法直接打开页面的情况。这是因为需要先进行设备授权。

通过以下命令查看待处理的设备请求：

docker exec -it clawdbot_clawdbot_1 clawdbot devices list

你会看到类似这样的输出，其中包含pending状态的请求：

🦞 Clawdbot 2026.1.24-3 — 发现待处理设备请求

Device ID: abc123def456
Status: pending
Requested: 2024-01-15 10:30:25

批准设备请求：

docker exec -it clawdbot_clawdbot_1 clawdbot devices approve abc123def456

3.2 获取访问链接

如果仍然无法访问，可以通过以下命令获取带token的访问链接：

docker exec -it clawdbot_clawdbot_1 clawdbot dashboard

这个命令会输出一个包含token的URL，类似：

Dashboard URL: http://127.0.0.1:7860/?token=23588143fd1588692851f6cbe9218ec6

使用这个链接就能正常访问Web界面了。

4. 模型配置与自定义

4.1 修改模型配置

ClawdBot默认使用预置的模型，但你也可以根据需要更换其他模型。

通过修改配置文件来更换模型。配置文件位于 /app/clawdbot.json，在容器内已映射到相应位置。

创建自定义配置文件：

{
  "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.2 通过UI界面配置

你也可以通过Web界面来配置模型：

1. 打开Web界面后，点击左侧的"Config"菜单
2. 选择"Models"选项
3. 在"Providers"标签页中修改模型配置
4. 保存配置后重启服务生效

4.3 验证模型配置

配置完成后，可以通过以下命令验证模型是否正常工作：

docker exec -it clawdbot_clawdbot_1 clawdbot models list

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

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

这表示模型已经正确加载并可以正常使用了。

5. 功能体验与使用技巧

5.1 Web界面使用

ClawdBot提供了一个直观的Web界面，你可以通过浏览器与AI助手进行交互。界面主要包含以下几个区域：

• 聊天区域：中间的主区域，显示对话历史
• 输入框：底部输入你的问题或指令
• 侧边栏：包含配置、模型设置、设备管理等选项

使用起来非常简单，就像和普通的聊天应用一样，输入你的问题，AI助手就会给出回答。

5.2 API接口调用

除了Web界面，ClawdBot还提供了API接口，方便开发者集成到自己的应用中。

基本的API调用示例：

curl -X POST "http://localhost:8000/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-local" \
  -d '{
    "model": "Qwen3-4B-Instruct-2507",
    "messages": [
      {"role": "user", "content": "你好，请介绍一下你自己"}
    ]
  }'

API返回格式与OpenAI兼容，方便现有应用的迁移和集成。

5.3 实用技巧

在使用ClawdBot时，有几个小技巧可以提升体验：

1. 清晰提问：尽量提供明确的上下文和具体的问题
2. 分段处理：对于复杂任务，可以拆分成多个简单问题
3. 使用系统提示：通过系统提示来定制AI的行为风格
4. 调整温度参数：如果需要创造性回答，可以适当提高温度值

6. 常见问题解决

6.1 访问问题

如果无法访问Web界面，可以按以下步骤排查：

1. 检查容器是否正常运行：docker ps
2. 查看容器日志：docker logs clawdbot_clawdbot_1
3. 确认端口是否开放：检查防火墙设置
4. 尝试使用带token的访问链接

6.2 模型加载问题

如果模型无法正常加载：

1. 检查配置文件格式是否正确
2. 确认模型名称和路径是否正确
3. 查看容器日志中的错误信息
4. 确保有足够的内存加载模型

6.3 性能优化

如果感觉响应速度较慢，可以尝试：

1. 增加容器内存限制
2. 调整并发参数配置
3. 使用更轻量级的模型
4. 优化提示词长度

7. 总结

ClawdBot提供了一个极其简便的方式来部署和使用AI助手服务。通过docker-compose一键部署，你就能获得包含Web界面、API接口和模型服务的完整环境。

主要优势：

• 部署简单：几条命令就能完成全部部署
• 功能完整：同时提供UI和API两种使用方式
• 配置灵活：支持自定义模型和参数调整
• 资源友好：可以在普通硬件上运行

使用建议：

• 初次使用时先通过Web界面熟悉功能
• 根据需要调整模型和配置参数
• 定期更新镜像获取最新功能
• 关注资源使用情况，适时调整配置

无论你是想快速体验AI助手的能力，还是需要为项目集成AI功能，ClawdBot都是一个很好的选择。它的免配置特性和完整功能让AI技术的使用变得前所未有的简单。

---

获取更多AI镜像

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