ClawdBot部署全解析：小白友好教程，重点攻克授权难题

ClawdBot部署全解析：小白友好教程，重点攻克授权难题

1. ClawdBot简介：你的本地AI助手

ClawdBot是一个可以在个人设备上运行的AI助手，它使用vLLM提供后端模型能力。与依赖云端服务的AI助手不同，ClawdBot的所有数据处理和模型推理都在本地完成，确保了数据隐私和安全。

这个工具特别适合：

• 需要保护隐私的用户
• 希望在本地运行AI模型的开发者
• 想要定制化AI助手功能的技术爱好者

2. 部署准备：环境检查

2.1 系统要求

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

• 操作系统：Linux (推荐Ubuntu 22.04+)、macOS或Windows(WSL2)
• 内存：至少8GB
• 存储空间：至少10GB可用空间
• Docker：已安装并运行
• Docker Compose：v2.20+

2.2 创建项目目录

建议为ClawdBot创建专用工作目录：

mkdir -p ~/clawdbot && cd ~/clawdbot

3. 安装与启动

3.1 拉取镜像

执行以下命令获取最新版ClawdBot镜像：

docker pull clawdbot/clawdbot:latest

3.2 准备配置文件目录

ClawdBot需要配置文件来存储设置，创建配置目录：

mkdir -p ~/.clawdbot

3.3 编写docker-compose文件

在项目目录中创建docker-compose.yml文件：

version: '3.8' services: clawdbot: image: clawdbot/clawdbot:latest ports: - "7860:7860" - "18780:18780" volumes: - "~/.clawdbot:/app/.clawdbot" - "./workspace:/app/workspace" restart: unless-stopped

3.4 启动服务

运行以下命令启动ClawdBot：

docker compose up -d

4. 解决授权问题

4.1 理解授权机制

ClawdBot默认启用了设备授权机制，新设备首次访问时需要管理员批准。这是常见卡点，下面详细介绍解决方法。

4.2 触发授权请求

1. 打开浏览器访问：http://localhost:7860
2. 即使页面显示空白或错误，这一步已经触发了授权请求

4.3 查看待授权设备

在终端执行：

clawdbot devices list

你应该能看到类似输出：

ID Status Created At IP User Agent a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8 pending 2026-01-25 14:22:31 127.0.0.1 Mozilla/5.0...

4.4 批准设备

复制上一步获取的ID，执行批准命令：

clawdbot devices approve a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8

成功后会显示："Device approved successfully."

4.5 验证访问

刷新浏览器页面，现在应该能看到ClawdBot的完整界面了。

5. 模型配置

5.1 检查vLLM服务

确保vLLM后端正常运行：

docker ps | grep vllm

5.2 配置模型连接

编辑配置文件~/.clawdbot/clawdbot.json，找到models部分：

"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.3 验证模型连接

执行以下命令检查模型状态：

clawdbot models list

正常输出应包含vLLM/Qwen3-4B-Instruct-2507且Local Auth为yes。

6. 常见问题解决

6.1 授权相关问题

问题：clawdbot devices list返回空解决：确保已通过浏览器访问http://localhost:7860

问题：approve命令报错"device not found"解决：确认使用了正确的设备ID，且在宿主机终端执行命令

6.2 模型相关问题

问题：页面卡在loading解决：检查vLLM服务是否正常运行，baseUrl配置是否正确

问题：models list显示Local Auth: no解决：将baseUrl改为http://host.docker.internal:8000/v1

7. 总结与下一步

通过本教程，你已经成功部署了ClawdBot并解决了常见的授权问题。现在你可以：

1. 通过Web界面与AI助手交互
2. 根据需要修改模型配置
3. 探索更多高级功能

记住，所有配置修改都应通过~/.clawdbot/clawdbot.json文件进行，修改后需要重启服务生效。

获取更多AI镜像

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