Clawdbot小白入门指南

Clawdbot 是一个开源、可本地部署的“行动派”AI助手。它的核心能力不是生成代码，而是能理解你的自然语言指令，直接在你的电脑上执行实际任务（如管理文件、操作浏览器、发送邮件等），像一个拥有系统操作权限的AI副手。

MindWeave · 2026-01-28 15:23:04 发布

Clawdbot和你之前了解的 OpenCode（AI编程助手）定位不同，Clawdbot 更像是一个能读懂你的自然语言、并直接在你的电脑上干活的 AI管家或副手。下面是一份专为新手设计的入门指南。

简单来说，它是开源、能自托管（装在你自己的设备上），并拥有“动手”能力的AI助手。

维度	Clawdbot 是什么	与OpenCode等AI编程助手的核心区别
核心定位	“行动派”AI副手：能真正执行任务，从聊天到行动。	“参谋型”编程助手：侧重代码生成与分析。
工作原理	在你的电脑/服务器上运行（本地优先），通过“网关”接入微信等聊天软件，用大模型理解指令，通过“技能”操作系统。	通常在终端或IDE中工作，专注于与代码相关的交互。
核心能力	执行：可操作文件、运行命令、控制浏览器、管理日历/邮件等。	生成与分析：擅长生成、解释、审查代码。
交互方式	无感融入：在你日常用的微信、Telegram等聊天软件里对话，无需打开新应用。	专注场景：在编程环境（终端、编辑器）中互动。
数据与隐私	隐私优先：所有数据、记忆都在你自己的设备上。	依赖服务商：通常需将代码或问题发送至云端AI处理。

在开始前，请确保你的设备满足以下条件：

打开终端，执行官方推荐的一键安装命令：

bash

curl -fsSL https://clawd.bot/install.sh | bash

安装完成后，输入 clawdbot --version 检查是否成功。

注：Windows用户需先安装并进入WSL2的Ubuntu系统，再执行上述命令。

安装后，运行配置向导来设置核心参数：

bash

clawdbot onboard --install-daemon

这个交互式向导会引导你完成：

向导完成后，你需要具体配置你选择的聊天软件。以连接微信为例：

安全提示：由于微信没有官方机器人支持，强烈建议使用一个备用手机号或小号来连接，避免主号风险。

首次向你的Clawdbot微信发送消息时，它会回复一个配对码。这是重要的安全机制，防止他人随意访问你的机器人。
你需要回到终端，批准这次配对：

bash

# 1. 查看待处理的配对请求
clawdbot pairing list whatsapp
# 2. 批准配对（将[code]替换为收到的实际配对码）
clawdbot pairing approve whatsapp [code]

批准后，你就可以在微信里和你的AI助手对话了。

开始可以和它聊天，问任何问题。它的核心能力是 “做事”，你可以尝试用自然语言给它派活：

你想让它做的事	可以直接在微信里对它说的话
文件管理	“帮我把‘下载’文件夹里所有的图片，按日期整理到‘照片’文件夹里。”
信息处理	“读一下我刚发给你的PDF文件，用中文总结核心要点。”
网络操作	“去知乎搜索‘AI智能体’，把最热门的3个回答摘要发给我。”
系统管理	“检查一下我的电脑硬盘还剩多少空间，有没有大文件可以清理的？”
日程邮件	“查看我今天的日历，把会议安排列出来。再帮我草拟一封下午3点会议的邀请邮件。”

请时刻牢记，Clawdbot拥有强大的执行权限，安全使用是第一要务：

隔离环境：最佳实践是在虚拟机、备用电脑或便宜的云服务器（VPS） 上运行，不要放在存有重要工作资料或敏感信息的主力电脑上。
谨慎配对：只批准你完全信任的设备或账号发起的配对请求。
网络防护：如果你将其部署在云服务器上并想远程访问管理后台，务必使用SSH隧道（如 ssh -L 18789:127.0.0.1:18789 user@你的服务器IP）来访问，不要将管理端口直接暴露在公网。
最小权限：在Clawdbot的配置中，可以设置其可访问的目录范围，遵循最小必要原则。

当熟悉基本操作后，你可以：

安装更多技能：通过 clawdhub search [关键词] 和 clawdhub install [技能名] 来扩展它的能力，比如控制智能家居、管理GitHub仓库等。
探索不同模型：在配置中切换使用Claude、GPT等不同模型，体验差异。
部署到云端：为了让助手24小时在线，可以将其部署到像DigitalOcean、Hetzner这样的云服务商，月成本约5美元。
了解工作机制：它的记忆和配置都以Markdown文件形式存储在 ~/.clawdbot/ 和 ~/clawd/ 目录下，高级用户可以查看和修改。