ClawdBot保姆级教程：零基础掌握设备授权，安全使用本地AI

ClawdBot保姆级教程：零基础掌握设备授权，安全使用本地AI

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

ClawdBot是一个可以在个人设备上运行的AI助手应用，它使用vLLM作为后端模型引擎，提供强大的本地AI能力。与常见的云端AI服务不同，ClawdBot的所有计算都在你的本地设备上完成，这意味着：

• 隐私安全：你的对话、文件和数据不会上传到任何服务器
• 快速响应：不需要网络请求，本地处理速度更快
• 完全控制：你可以自由配置模型参数和工作流程

ClawdBot特别适合需要保护隐私或对响应速度有要求的用户，比如处理敏感数据、进行专业创作或开发AI应用。

2. 准备工作：安装与启动

2.1 系统要求

在开始使用ClawdBot前，请确保你的设备满足以下要求：

• 操作系统：Linux/Windows/macOS均可
• 硬件配置：
  • 至少8GB内存
  • 推荐使用NVIDIA GPU（非必须但能提升性能）
• 软件依赖：
  • Docker（推荐安装方式）
  • Python 3.8+

2.2 快速安装

对于大多数用户，我们推荐使用Docker方式安装：

docker pull moltbot/moltbot docker run -p 7860:7860 -v ~/.clawdbot:/app moltbot/moltbot

这行命令会：

1. 下载ClawdBot镜像
2. 将7860端口映射到主机
3. 将配置文件挂载到本地目录

安装完成后，你可以通过http://localhost:7860访问控制面板。

3. 设备授权机制详解

3.1 为什么需要设备授权

ClawdBot采用严格的安全机制，所有新设备首次访问时都需要授权。这样做的好处是：

• 防止未授权访问：确保只有你信任的设备能使用AI服务
• 保护隐私数据：避免敏感信息被他人查看
• 记录访问历史：可以随时查看哪些设备连接过

3.2 授权流程概述

完整的授权流程分为三步：

1. 新设备尝试访问控制面板
2. 系统生成待处理请求
3. 管理员批准请求

4. 实战操作：设备授权全流程

4.1 查看待处理请求

当新设备首次访问控制面板时，你需要在终端执行以下命令查看待处理请求：

clawdbot devices list

典型输出如下：

ID Status Device ID IP User Agent d9a2f... pending 7c4b1e8a-2f3d-4a1c-b8e9-0f1a2b3c4d5e 192.168.1.100 Chrome/120.0

• ID：请求的唯一标识符
• Status：请求状态（pending表示待处理）
• Device ID：设备唯一标识
• IP：设备IP地址
• User Agent：浏览器信息

4.2 批准设备请求

找到待处理的请求后，使用其ID进行批准：

clawdbot devices approve d9a2f...

成功后会显示确认信息：

Device d9a2f... approved.

4.3 验证访问

批准后，新设备刷新页面即可正常访问控制面板。如果仍然无法访问，可以尝试：

clawdbot dashboard

这个命令会生成一个带token的直接访问链接，如：

http://127.0.0.1:7860/?token=23588143fd1588692851f6cbe9218ec6b874bb859e775762

5. 高级配置与管理

5.1 修改模型配置

ClawdBot默认使用Qwen3-4B模型，你可以通过修改配置文件更换模型：

1. 编辑配置文件（通常位于~/.clawdbot/clawdbot.json）
2. 修改models部分：

{ "models": { "providers": { "vllm": { "models": [ { "id": "Qwen3-4B-Instruct-2507", "name": "Qwen3-4B-Instruct-2507" } ] } } } }

3. 重启ClawdBot服务使更改生效

5.2 查看已授权设备

要查看所有已授权设备：

clawdbot devices list --status approved

5.3 撤销设备权限

如果需要撤销某设备的访问权限：

clawdbot devices reject [设备ID]

6. 常见问题解决

6.1 无法访问控制面板

如果按照上述步骤操作后仍无法访问，请检查：

1. ClawdBot服务是否正常运行
2. 7860端口是否被占用
3. 防火墙是否阻止了端口访问

6.2 命令找不到

如果提示clawdbot: command not found，请确认：

1. 是否在Docker容器内执行命令
2. 是否已将ClawdBot添加到PATH环境变量

6.3 授权后仍显示403错误

尝试以下步骤：

1. 清除浏览器缓存
2. 使用无痕模式访问
3. 重新生成访问token

7. 安全使用建议

为了确保ClawdBot的安全使用，我们建议：

1. 定期检查授权设备：移除不再使用的设备
2. 保护配置文件：clawdbot.json包含敏感信息，确保其权限设置正确
3. 及时更新：关注官方更新，获取最新安全补丁
4. 网络隔离：如无必要，不要将服务暴露在公网

8. 总结

通过本教程，你已经掌握了ClawdBot的设备授权机制和基本使用方法。记住几个关键点：

1. 新设备访问需要先批准
2. 使用clawdbot devices list查看请求
3. 使用clawdbot devices approve批准设备
4. 遇到问题可以使用clawdbot dashboard获取直接访问链接

ClawdBot为你提供了强大的本地AI能力，同时也赋予你完全的控制权。合理使用这些功能，你就能在保护隐私的同时享受AI带来的便利。

获取更多AI镜像

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