ClawdBot快速上手指南：3步搭建本地AI助手，无需复杂配置
ClawdBot快速上手指南：3步搭建本地AI助手，无需复杂配置
你是不是也想过拥有一个像钢铁侠的JARVIS那样的AI助手？能帮你写代码、处理文件、搜索信息，甚至还能操作你的电脑？以前这听起来像是科幻电影里的情节，但现在，有了ClawdBot（现在叫Moltbot），这个梦想真的可以实现了。
ClawdBot是一个完全开源的本地AI助手，它最大的特点就是能直接执行任务，而不只是给你建议。想象一下，你告诉它“帮我整理桌面上的文件”，它真的会去执行命令；你说“写一个Python爬虫”，它不仅能写出代码，还能帮你运行测试。这就是ClawdBot的魅力所在。
今天我就带你用最简单的方式，3步搭建属于自己的本地AI助手，完全不需要复杂的配置过程。
1. 什么是ClawdBot？为什么它这么火？
1.1 从ClawdBot到Moltbot
ClawdBot原本叫这个名字，但在2026年1月，因为名字与Anthropic的Claude太相似，收到了律师函，项目紧急更名为Moltbot。不过别担心，功能完全一样，而且旧命令clawdbot仍然兼容。
Moltbot这个名字其实挺有意思的，意思是“脱皮龙虾”，吉祥物是一只可爱的小龙虾Molty。虽然名字变了，但核心功能一点没变，反而因为这次改名事件，让更多人知道了这个项目。
1.2 为什么大家都在用ClawdBot？
我用了ClawdBot一段时间，发现它火起来真的不是偶然。传统的大模型工具，比如ChatGPT或者Claude，只能给你建议和代码，但ClawdBot能直接帮你执行。
举个例子：
- 你想创建一个新项目？告诉ClawdBot，它会自动创建文件夹、初始化git、安装依赖
- 需要处理一批文件？ClawdBot能批量重命名、转换格式、整理归档
- 想写个脚本？它不仅能写代码，还能运行测试，发现错误还会自己修复
这种“说做就做”的能力，让它从众多AI工具中脱颖而出。
1.3 ClawdBot的核心能力
ClawdBot的强大之处在于它的三大核心能力：
任务自动规划：你把一个复杂任务告诉它，它会自动拆解成多个可执行的步骤。比如“帮我搭建一个博客网站”，它会先创建项目结构，然后安装依赖，接着配置数据库，最后部署上线。
本地执行能力：ClawdBot可以直接在你的电脑上执行命令、操作文件系统、运行代码。这意味着它真的能“动手做事”，而不只是“动嘴建议”。
自我修复机制：这是最让我惊喜的一点。如果任务执行失败了，ClawdBot会分析错误原因，然后尝试不同的解决方案，直到成功为止。就像有个不知疲倦的助手在帮你调试。
2. 3步快速搭建ClawdBot
好了，说了这么多，现在让我们开始动手搭建。整个过程只需要3步，比安装一个普通软件还简单。
2.1 第一步：一键安装ClawdBot
ClawdBot的安装被设计得极其友好，无论你是用Windows、macOS还是Linux，都有对应的安装方式。
对于macOS和Linux用户，打开终端，输入这一条命令：
curl -fsSL https://molt.bot/install.sh | bash对于Windows用户，打开PowerShell，输入：
iwr -useb https://molt.bot/install.ps1 | iex或者用CMD：
curl -fsSL https://molt.bot/install.cmd -o install.cmd && install.cmd && del install.cmd这个一键安装脚本会帮你做很多事情：
- 自动检测你的系统环境
- 安装必要的依赖（包括Node.js）
- 下载ClawdBot的最新版本
- 完成基础配置
整个过程大概需要2-3分钟，取决于你的网络速度。安装过程中，脚本会问你几个配置问题，大部分直接按回车用默认值就行。
2.2 第二步：简单配置与初始化
安装完成后，我们需要进行一些简单的配置。ClawdBot提供了一个很贴心的引导流程。
在终端中输入：
moltbot onboard --install-daemon这个命令会启动配置向导，它会问你几个问题：
- Gateway端口设置：默认是18789，直接按回车就行
- 模型供应商选择：这里你可以选择使用哪个AI模型
- API密钥配置：如果你有OpenAI、Claude等账号，可以在这里配置
对于大多数用户，我建议这样配置：
- 端口就用默认的18789
- 模型供应商选择“vllm”（这是ClawdBot自带的本地模型引擎）
- API密钥可以先跳过，用本地模型就行
配置完成后，ClawdBot会自动安装后台服务。这意味着它会在后台运行，随时准备响应你的指令。
2.3 第三步：启动并使用ClawdBot
配置完成后，ClawdBot就已经在运行了。现在打开你的浏览器，访问：
http://127.0.0.1:18789/chat你会看到一个简洁的聊天界面，这就是ClawdBot的操作面板。
第一次使用需要授权： 当你第一次访问时，可能会看到一个待处理的设备请求。别担心，这很正常。回到终端，输入：
clawdbot devices list你会看到类似这样的输出：
🦞 Clawdbot 2026.1.24-3 (885167d) Device ID Status Last Seen ----------------------------------- ---------- ------------------- abc123def456ghi789jkl012 pending 2026-01-24 10:30:15找到状态是“pending”的设备，复制它的Device ID，然后执行：
clawdbot devices approve abc123def456ghi789jkl012把上面的ID换成你看到的实际ID。授权完成后，刷新浏览器页面，就能正常使用了。
如果还是无法访问，可以在终端输入：
clawdbot dashboard这个命令会显示一个带token的链接，用这个链接就能直接访问了。
3. ClawdBot的实用功能体验
现在你的ClawdBot已经搭建好了，让我们来看看它能做什么。我根据自己的使用经验，总结了一些最实用的功能。
3.1 文件操作：你的智能文件管家
ClawdBot最实用的功能之一就是文件操作。你可以用自然语言告诉它要做什么，它会自动执行。
试试这些命令：
- “帮我在桌面创建一个名为‘test_project’的文件夹”
- “列出当前目录下所有的Python文件”
- “把‘document.txt’文件复制到备份文件夹”
ClawdBot不仅能执行简单的文件操作，还能处理复杂的任务。比如你可以说：“帮我把这个文件夹里所有的图片文件重命名，按照‘image_001.jpg’这样的格式”。
3.2 代码编写与执行：你的编程助手
作为开发者，这是我最喜欢的功能。ClawdBot不仅能写代码，还能运行代码、调试代码。
写一个简单的Python脚本： 告诉ClawdBot：“写一个Python脚本，从CSV文件中读取数据，计算每列的平均值，并生成报告。”
它会：
- 分析你的需求
- 编写完整的Python代码
- 创建必要的文件
- 运行脚本测试
- 如果有错误，会自动修复
更复杂的项目： 你甚至可以说：“帮我创建一个Flask web应用，包含用户注册、登录和文件上传功能。”
ClawdBot会：
- 创建项目结构
- 安装所有依赖
- 编写核心代码
- 配置数据库
- 设置路由和模板
3.3 系统操作：你的电脑管家
ClawdBot可以执行各种系统命令，帮你管理电脑。
一些实用的例子：
- “查看当前系统的内存使用情况”
- “帮我清理临时文件”
- “检查网络连接状态”
- “重启某个服务”
3.4 信息搜索与处理：你的研究助手
ClawdBot可以帮你搜索信息、处理数据、生成报告。
比如：
- “搜索今天最新的AI新闻，并总结成要点”
- “分析这个日志文件，找出错误信息”
- “从这些数据中提取关键指标，生成可视化图表”
4. 高级配置与个性化设置
虽然ClawdBot开箱即用，但如果你想更深入地定制它，这里有一些高级配置方法。
4.1 修改模型配置
默认情况下，ClawdBot使用自带的vllm引擎和Qwen3-4B-Instruct模型。如果你想使用其他模型，可以修改配置文件。
配置文件位于~/.clawdbot/clawdbot.json（在CSDN镜像中映射为/app/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" } ] } } } }你可以在这里添加其他模型供应商，比如OpenAI、Claude等。只需要添加对应的API密钥和端点地址。
4.2 通过UI界面修改配置
如果你不熟悉JSON配置，也可以通过Web界面来修改。
在ClawdBot的Web界面中：
- 点击左侧的“Config”
- 选择“Models”
- 点击“Providers”
- 在这里添加或修改模型配置
这种方式更直观，适合不熟悉命令行操作的用户。
4.3 验证配置是否生效
修改配置后，可以在终端输入以下命令验证：
clawdbot models list如果看到类似下面的输出，说明配置成功了：
🦞 Clawdbot 2026.1.24-3 (885167d) Model Input Ctx Local Auth Tags vllm/Qwen3-4B-Instruct-2507 text 195k yes yes default5. 使用技巧与最佳实践
经过一段时间的使用，我总结了一些让ClawdBot更好用的技巧。
5.1 如何给ClawdBot下指令
ClawdBot理解自然语言，但更清晰的指令能得到更好的结果。
不好的指令：“处理一下那个文件”好的指令：“请打开‘/home/user/documents/report.pdf’文件，提取所有标题，保存到‘titles.txt’”
具体化：越具体的指令，ClawdBot执行得越好。包括文件路径、格式要求、处理方式等细节。
分步骤：对于复杂任务，可以分步骤进行。先让ClawdBot完成第一步，检查结果，再继续下一步。
5.2 安全使用建议
ClawdBot有执行权限，所以安全很重要：
- 从简单任务开始：先试试文件查看、信息查询等安全操作
- 重要文件先备份：在执行可能修改文件的操作前，先备份重要数据
- 理解命令再执行：ClawdBot执行前会告诉你它要做什么，确认无误再继续
- 使用沙盒环境：对于不确定的操作，可以在测试环境中先尝试
5.3 性能优化技巧
如果你的ClawdBot运行缓慢，可以尝试：
- 减少并发任务：在配置中降低
maxConcurrent的值 - 使用轻量模型：Qwen3-4B-Instruct已经比较轻量，如果还觉得慢，可以尝试更小的模型
- 关闭不需要的功能：在Web界面中关闭不使用的技能模块
6. 常见问题与解决方案
在使用过程中，你可能会遇到一些问题。这里是我遇到的一些常见问题及解决方法。
6.1 无法访问Web界面
问题：访问http://127.0.0.1:18789/chat时无法连接。
解决步骤：
- 检查ClawdBot是否在运行：
clawdbot status - 如果没运行，启动它：
clawdbot start - 如果已运行但无法访问，获取带token的链接：
clawdbot dashboard - 使用返回的链接访问
6.2 设备授权问题
问题：新设备访问时需要授权，但不知道如何操作。
解决方法：
# 查看待授权设备 clawdbot devices list # 授权设备（替换为实际的Device ID） clawdbot devices approve [你的Device ID]6.3 模型加载失败
问题：ClawdBot无法加载模型，提示连接错误。
可能原因和解决：
- 端口冲突：检查8000端口是否被占用
- 内存不足：确保有足够内存运行模型（至少4GB）
- 配置错误：检查
clawdbot.json中的模型配置
6.4 执行权限问题
问题：ClawdBot无法执行某些命令或操作文件。
解决：
- 检查ClawdBot的运行权限
- 确保要操作的文件和目录有相应权限
- 对于系统级操作，可能需要以管理员权限运行
7. 总结
ClawdBot（Moltbot）确实是一个让人眼前一亮的产品。它把AI从“建议者”变成了“执行者”，这种转变带来的效率提升是巨大的。
我使用ClawdBot的这几个月，最大的感受就是：它真的能节省时间。以前需要手动操作的任务，现在只需要一句话就能完成。写代码、处理文件、整理数据，这些重复性工作都可以交给ClawdBot。
给新手的建议：
- 从简单开始：先试试文件操作、信息查询等基础功能
- 逐步深入：熟悉后再尝试代码编写、系统操作等高级功能
- 注意安全：重要操作前先备份，理解命令再执行
- 参与社区：ClawdBot有活跃的社区，遇到问题可以寻求帮助
ClawdBot还在快速发展中，每周都有新功能加入。现在正是开始使用的好时机，你可以随着它的成长一起学习进步。
最让我欣赏的是，ClawdBot完全开源且免费。你可以在自己的设备上运行，所有数据都留在本地，既安全又私密。对于注重隐私的用户来说，这是很大的优势。
如果你对AI助手有需求，无论是为了提升工作效率，还是单纯想体验前沿技术，ClawdBot都值得一试。3步安装，几乎零配置，就能拥有一个强大的本地AI助手，这样的机会不容错过。
获取更多AI镜像
想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。