在2026年,个人AI助手已成为生产力工具的新宠,其中Clawdbot(也称ClawdBot或其演变版本OpenClaw/Moltbot)以开源、自托管和强大自动化能力脱颖而出。它允许用户在本地设备上部署一个24/7在线的“数字员工”,通过WhatsApp、Telegram、Discord等日常聊天工具远程操控电脑,实现浏览器自动化、代码生成、定时任务、资讯监控等功能。相比云端AI服务,Clawdbot的最大优势在于数据隐私完全掌握在自己手中,且支持高度定制化扩展。
本地安装Clawdbot门槛不高,新手只需基本终端操作经验即可上手。本文将手把手指导你完成Clawdbot本地部署的全过程,同时重点强调新手容易忽略的注意事项,帮助你避开常见坑,安全高效地拥有属于自己的私人AI助手。
文章导航
一、Clawdbot本地安装前准备工作
开始安装前,确保你的设备环境符合要求。Clawdbot基于Node.js运行,支持多平台本地部署。
1.1 系统要求对比表
| 操作系统 | 最低要求 | 推荐配置 | 注意事项 |
| macOS | macOS 14+, Node.js ≥ v22 | M1/M2/M3芯片, 16GB+内存 | 最友好, 支持菜单栏伴侣App |
| Linux | Ubuntu/Debian等 主流发行版 | 2vCPU+4GB内存VPS | 适合云服务器 或树莓派部署 |
| Windows | Windows 10+, 必须使用WSL2 | WSL2 Ubuntu环境 | 纯Windows不支持, 易遇PATH问题 |
1.2 其他前置条件
- Node.js版本:必须≥ v22(推荐v22或v23 LTS)。可通过
node -v检查,若版本过低需升级。 - 包管理器:推荐pnpm,也支持npm。
- API密钥:至少准备一个大模型API(如Anthropic Claude、OpenAI GPT、Groq、MiniMax或本地Ollama模型)。新手建议先申请免费额度测试。
- 网络环境:安装过程需联网下载依赖,国内用户可能需科学上网访问某些模型API。
- 独立环境建议:出于安全考虑,强烈推荐在虚拟机、WSL2、树莓派或闲置电脑上部署,避免在日常主力机上直接运行。
新手提示:如果你是首次接触命令行,建议先熟悉基本终端操作(如cd、ls)。整个安装过程通常5-15分钟,耐心等待依赖下载即可。

二、Clawdbot本地安装详细步骤
Clawdbot提供一键安装脚本,极大降低了部署难度。以下以macOS/Linux为例,Windows用户请在WSL2中操作。
步骤1:运行一键安装脚本(推荐方式)
在终端输入以下命令:
curl -fsSL https://clawd.bot/install.sh | bash
Windows PowerShell版本:
iwr -useb https://clawd.bot/install.ps1 | iex
该脚本会自动:
- 检测系统环境
- 安装最新Node.js
- 全局安装Clawdbot CLI
- 创建配置文件目录:通常在~/.clawdbot
安装完成后,终端会提示重开终端或运行exec bash刷新环境。
新手常见问题:如果卡在依赖下载,检查网络或尝试更换镜像源。若提示权限问题,加sudo重试(但不推荐长期用root运行)。

步骤2:运行onboard配置向导(核心步骤)
安装后执行:
clawdbot onboard --install-daemon
该命令会启动交互式配置向导,主要包括:
- 同意风险条款:系统会弹出风险提醒(涉及系统权限),仔细阅读后选择“Yes”。
- 选择启动模式:推荐“QuickStart”快速模式。
- 选择AI模型提供商:
- Anthropic:Claude系列,代码能力强
- OpenAI:GPT系列
- Groq/MiniMax:性价比高,推荐新手
- 本地Ollama:完全免费,无API费用
新手建议:先选MiniMax M2.1或Groq,响应快、成本低。输入API Key时仔细复制,避免空格。
- 选择交互渠道:
- WhatsApp:最流行,扫码登录
- Telegram:需创建Bot
- Discord/Slack等
- 技能(Skills)安装:可先跳过(Skip for now),后续在管理面板一键添加。
- 其他配置:如钩子(Hooks)、工作区偏好等,新手可默认。
配置完成后,系统自动安装后台服务(macOS用launchd,Linux用systemd),并打开Web管理面板(通常http://127.0.0.1:18789)。

步骤3:连接聊天工具(以WhatsApp为例)
WhatsApp是最便捷的交互方式:
- 在onboard向导中选择WhatsApp渠道。
- 终端显示二维码。
- 打开手机WhatsApp → 设置 → 关联设备 → 扫描二维码。
- 首次消息需配对批准:在终端运行
clawdbot pairing approve whatsapp <代码>。
连接成功后,你可在WhatsApp中直接发送消息测试,如“嗨”或“你好,Clawdbot”。
其他渠道提示:
- Telegram:需通过@BotFather创建Bot获取Token。
- 多渠道:可同时开启,Clawdbot统一管理。
步骤4:验证安装并启动
运行以下命令检查:
clawdbot doctor # 系统健康检查
clawdbot status # Gateway状态
clawdbot dashboard # 打开Web面板
一切正常后,Clawdbot已24/7后台运行。

三、新手安装Clawdbot必须注意的10个关键点
Clawdbot功能强大,但也伴随较高风险。新手最容易忽略以下事项:
1、安全第一,隔离部署
Clawdbot拥有完整系统权限(读写文件、运行shell、控制浏览器)。强烈建议在虚拟机、WSL2或独立设备部署,避免主力机数据泄露。
2、API费用控制
使用Claude Opus一天可能消耗几十到几百美元。推荐:
- 起步用MiniMax/Groq低成本模型
- 调低思考深度
- 测试阶段用本地Ollama模型
3、权限管理
macOS需手动授权屏幕录制、文件访问等。首次运行可能弹出多次授权提示。

4、不要在root下运行
永远用普通用户部署,避免权限过大导致安全隐患。
5、备份配置文件
核心配置在~/.clawdbot/目录,定期备份clawdbot.json和credentials。
6、网络与防火墙
默认仅本地访问,如需远程控制,建议用Tailscale或Cloudflare Tunnel安全暴露端口。
7、更新维护
定期运行clawdbot update或重新执行install.sh获取最新版本。
8、技能安装谨慎
社区技能丰富,但第三方技能可能有风险。先在管理面板查看来源再安装。
9、消息配对机制
首次从新设备发消息需终端手动批准,防止陌生人滥用。
10、退出与卸载
停止服务:clawdbot gateway stop;卸载:删除~/.clawdbot目录和全局包。
四、常见模型选择对比表
| 模型提供商 | 优点 | 缺点 | 日均成本估算 (中等使用) | 新手推荐 |
| Anthropic Claude | 代码能力最强, 推理优秀 | 费用高 | $20-100+ | ★★★☆☆ |
| OpenAI GPT | 通用性强, 生态成熟 | 费用中等 | $10-50 | ★★★★☆ |
| MiniMax M2.1 | 响应快,表达直接,性价比高 | 代码能力稍弱 | $1-10 | ★★★★★ |
| Groq | 极快速度 | 模型选择少 | $5-20 | ★★★★☆ |
| 本地Ollama | 完全免费, 无限使用 | 需要较高硬件 | $0 | ★★★★☆ |
五、Clawdbot安装后核心功能演示与技能扩展
部署成功后,你可以通过聊天工具指挥Clawdbot完成各种任务:
- 浏览器自动化:发送“打开GitHub并截图”,Clawdbot自动执行并返回结果。
- 定时任务:安装BlogWatcher技能,每天自动监控技术博客并推送更新。
- 代码生成:使用Coding Agent技能,几分钟开发简单网页或脚本。
- 文件管理:远程搜索、整理电脑文件。
- 无限记忆:支持长期上下文记忆,越用越聪明。
技能扩展:在Web面板搜索并一键安装社区技能,如:
- BlogWatcher:资讯监控
- Coding Agent:编程助手
- Screenshot Organizer:截图自动分类
这些技能如同“小程序”,极大扩展了Clawdbot的能力边界。
六、常见问题解答
| 问题 | 解决方案 |
| 安装卡在sharp模块 | 设置环境变量SHARP_IGNORE_GLOBAL_LIBVIPS=1重试 |
| WhatsApp扫码失败 | 检查手机网络,确保使用关联设备功能 |
| API Key无效 | 检查Key是否过期,运行clawdbot doctor诊断 |
| Gateway无法启动 | 检查systemctl status或launchctl list |
| 吃token太快 | 更换低成本模型,降低思考深度 |
| Windows PATH找不到clawdbot | 重启WSL或手动添加npm全局bin到PATH |
结语
通过以上步骤,你已成功在本地部署Clawdbot,拥有了一个真正属于自己的AI数字员工。从简单的信息查询到复杂的自动化工作流,它都能胜任。安装Clawdbot不仅能大幅提升个人效率,还能让你深入理解开源AI代理的魅力。
安全与成本控制是新手最需关注的重点——在隔离环境中逐步探索技能,才能最大化发挥其价值。
开始你的第一条指令吧,你的私人AI助手已准备就绪!
延展阅读:
新手小白没有货源如何经营抖店?没有货源如何实现盈利?新手小白需要学习的内容!