ClawdBot开源可部署：GitHub 2k Star项目，MIT协议支持商用改造

本文介绍了如何在星图GPU平台自动化部署ClawdBot开源AI助手镜像，实现本地化多模态AI应用。该镜像基于vLLM技术，支持文本对话、知识问答等核心功能，用户可快速搭建个人AI助手，保障数据隐私安全，适用于学习辅助、内容创作等场景。

谢兴豪

956人浏览 · 2026-03-12 00:49:52

谢兴豪 · 2026-03-12 00:49:52 发布

ClawdBot开源可部署：GitHub 2k Star项目，MIT协议支持商用改造

1. 项目概述：你的个人AI助手

ClawdBot是一个可以在自己设备上运行的个人AI助手项目，基于vLLM提供后端模型能力。这个开源项目在GitHub上已经获得超过2000个Star，采用MIT协议，意味着你可以自由使用、修改甚至用于商业用途。

简单来说，ClawdBot让你能够搭建一个完全属于自己的AI助手，不需要依赖任何第三方服务，所有数据都在本地处理，既安全又可控。

2. 核心功能与特点

2.1 多模态AI能力

ClawdBot的核心价值在于它的多功能性。它不仅仅是一个简单的聊天机器人，而是集成了多种AI能力：

文本对话：基于强大的语言模型，可以进行智能对话和问答
多模型支持：可以配置不同的AI模型，满足不同场景需求
本地部署：所有数据处理都在本地完成，确保隐私安全

2.2 技术架构优势

ClawdBot采用现代化的技术架构，具有以下优势：

轻量级设计：镜像体积小，资源占用低
易于扩展：支持多种模型和配置选项
开源透明：代码完全开源，可以自行审查和修改

3. 快速部署指南

3.1 环境准备

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

Docker环境已安装
至少4GB可用内存
足够的存储空间存放模型文件

3.2 部署步骤

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

首先获取项目并启动服务：

# 克隆项目（如果从GitHub获取）
git clone https://github.com/your-username/clawdbot.git

# 进入项目目录
cd clawdbot

# 使用Docker启动服务
docker-compose up -d

等待服务启动完成后，就可以开始使用了。

4. 配置与使用详解

4.1 设备授权配置

首次使用时，需要进行设备授权。这是确保只有授权设备可以访问的重要安全措施。

查看待处理设备请求：

clawdbot devices list

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

Device ID: xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Status: pending
Requested: 2024-01-24T10:30:00Z

批准设备请求：

clawdbot devices approve [设备请求ID]

4.2 访问控制面板

完成设备授权后，可以通过以下方式访问控制面板：

直接打开提供的HTTP服务地址，或者通过终端获取带token的访问链接：

clawdbot dashboard

这个命令会输出一个包含token的访问链接，类似这样：

Dashboard URL: http://127.0.0.1:7860/?token=你的访问令牌

复制这个链接到浏览器中打开，就可以进入ClawdBot的控制界面了。

5. 模型配置与管理

5.1 自定义模型配置

ClawdBot支持自定义模型配置，你可以根据自己的需求选择不同的AI模型。

通过配置文件修改模型设置，编辑/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"
          }
        ]
      }
    }
  }
}

5.2 图形界面配置

除了配置文件，你也可以通过Web界面进行模型配置：

打开ClawdBot控制面板
点击左侧的"Config"菜单
选择"Models" -> "Providers"
在这里可以添加、修改或删除模型配置

5.3 验证模型配置

配置完成后，验证模型是否正常工作：

clawdbot models list

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

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

这表明模型已经正确配置并可以正常使用了。