Clawdbot：您的私有化AI自动化管家中文指南

Clawdbot是一款开源、自托管的个人AI助手。它最大的特点是不仅能对话，更能根据指令直接操作您的电脑（如运行脚本、管理文件）并整合数十个通讯平台，将强大的AI能力无缝融入您现有的工作与生活流。

一、核心概念与架构

理解Clawdbot的架构，能帮助您更好地配置和使用它。

Clawdbot遵循 “网关（Gateway）- 节点（Node）” 的架构模式，这是其实现多功能、多设备接入的基础。

网关：是Clawdbot的“大脑”和控制中心。它负责处理AI模型请求、管理记忆、协调所有通信渠道和技能。网关需要在一个长期运行的设备上部署。
节点：是连接到网关的“手脚”。您可以在其他电脑上安装节点客户端，通过节点远程使用网关的AI能力。节点会将其所在设备的工具（如Shell、浏览器）暴露给网关，实现远程自动化。

数据与隐私：所有配置、对话历史和记忆文件都默认存储在本地（~/.clawdbot/目录），您的数据无需经过第三方服务器，确保了完全的隐私和自主权。

二、安装部署：选择您的方案

在开始前，请确保您的系统满足Node.js 22或更高版本的要求。

Clawdbot提供了灵活的部署方式，您可以根据自身情况选择：

部署方式	适用场景	核心优势
本地直接安装	快速开始在常用电脑上使用	最简单，无需额外服务
云端托管 (如Railway)	希望7x24小时运行，无本地服务器	免运维，有公网IP，易于配置
macOS虚拟机 (如Lume)	在非Mac电脑上获得完整iMessage支持	平衡了隔离性与功能完整性

方案A：本地直接安装（推荐新手）

这是最快捷的入门方式，适用于在您日常使用的电脑（macOS, Linux, Windows）上安装。

安装Clawdbot 通过包管理器安装是最佳实践。打开终端，执行以下命令：
```
# 使用 npm 安装
npm install -g clawdbot@latest
# 或使用 pnpm 安装
pnpm add -g clawdbot@latest
```
对于macOS用户，也可以直接从官网下载.dmg或.zip安装包进行安装。
运行初始化向导 安装完成后，运行以下命令启动交互式配置向导。它会引导您完成核心设置，并可选地将Clawdbot安装为后台守护进程。
```
clawdbot onboard --install-daemon
```

方案B：云端托管部署（以Railway为例）

如果您希望助手能全天候在线，或没有可长期开机的本地设备，Railway等PaaS平台是理想选择。

一键部署：访问Railway模板页面，使用Clawdbot模板创建新项目。
关键配置：在Railway项目设置中，必须：
- 添加一个存储卷（Volume），挂载路径设置为 /data，用于持久化保存数据。
- 设置环境变量 SETUP_PASSWORD（用于保护Web设置页面）和 PORT=8080。
- 在“Public Networking”中开启HTTP代理，端口设为 8080。
网页端配置：部署完成后，访问 https://<您的域名>/setup，用设置的密码登录，即可在网页向导中完成模型、通信渠道等所有配置，无需操作服务器终端。

三、核心配置详解

初始化过程中，以下几个环节至关重要。

1. 配置AI模型：赋予助手“智慧”

Clawdbot本身不提供模型，需要您配置一个AI后端。您可以选择商业API或本地模型。

使用商业API（如Claude, GPT）：在初始化向导的“Model/Auth Provider”步骤中，选择“Vercel AI Gateway”或直接选择对应提供商，然后粘贴您的API密钥。
使用本地模型（如Ollama）：追求隐私和零成本的理想选择。
1. 首先在本地安装并启动Ollama。
2. 拉取一个支持工具调用的模型，例如：ollama pull llama3.3。
3. 在Clawdbot中配置Ollama。最简单的方式是设置环境变量：export OLLAMA_API_KEY="ollama-local"，Clawdbot会自动发现本地可用的模型。

2. 连接通信渠道：与助手对话

这是Clawdbot的魔力所在，您可以通过熟悉的聊天软件与助手交互。

渠道	关键配置步骤	隐私与控制策略
Discord	1. 在Discord开发者门户创建机器人，获取Token。 2. 在Clawdbot配置中填入Token。	私聊默认需“配对码”验证；群聊可设为“仅在被@时回复”。
Telegram	1. 在Telegram中联系 `@BotFather` 创建机器人，获取Token。 2. 在Clawdbot配置中填入Token。	配置方式与Discord类似。
iMessage	1. 确保Mac的“信息”App已登录。 2. 通过Homebrew安装 `imsg` 命令行工具：`brew install steipete/tap/imsg`。 3. 在Clawdbot配置文件中指定 `cliPath` 和 `dbPath`。	重要：此功能需授予Clawdbot“完全磁盘访问”权限。

渠道的配置通常在初始化向导中完成，也可以在安装后编辑配置文件 ~/.clawdbot/clawdbot.json。一个基础的Discord配置示例如下：

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN_HERE"
    }
  }
}

四、使用技巧与高级功能

基础交互

配置完成后，在您已连接的通信渠道（如Discord私聊或群组）中，直接像与真人聊天一样向您的Clawdbot助手发送消息即可。首次私聊时，您可能需要根据提示使用 clawdbot pairing approve 命令来批准该对话。

探索高级自动化

Clawdbot真正的威力在于其“技能（Skills）”和“工具（Tools）”系统。

文件操作：您可以要求它读取、总结或修改您电脑上的文档。
Shell命令：在安全许可下，它可以执行终端命令，完成软件安装、系统监控等任务。
网页控制：它可以操作浏览器，进行信息搜索、数据抓取等。
扩展市场：访问ClawdHub技能市场，安装由社区开发的技能（如邮件处理、智能家居控制），轻松扩展助手能力。

多代理与记忆

多代理：您可以配置多个具有不同性格、专长和权限的AI代理，例如一个“严谨的代码助手”和一个“随和的日程管家”，并根据场景自动路由对话。
持久记忆：助手会自动将重要对话和上下文保存为本地Markdown文件，形成长期记忆，实现跨越数周甚至数月的连续对话。

五、故障排查与帮助

检查服务状态：使用 clawdbot health 和 clawdbot status 命令检查网关和节点运行是否健康。
诊断工具：运行 clawdbot doctor 命令，它可以扫描常见配置问题并提供修复建议。
查阅日志：日志文件通常位于 ~/.clawdbot/logs/ 目录下，是排查复杂问题的第一手资料。
寻求社区支持：Clawdbot拥有活跃的开发者社区（例如Discord），遇到问题时可以在那里寻求帮助。

总结：Clawdbot将大型语言模型从“聊天机器人”转变为可行动的“数字员工”。通过本指南完成部署后，您将拥有一个高度定制化、尊重隐私且能力强大的个人AI伙伴。

重要提示：授予AI助手执行系统命令和访问文件的能力存在固有风险。请务必从官方渠道下载软件，仔细审查其请求的操作，并在初始阶段使用严格的访问控制列表（allowlist）。

菜单

分享

Clawdbot：您的私有化AI自动化管家中文指南