Clawdbot 本地部署私有化 AI Agent (智能体) 教程

Clawdbot 是由知名开发者 Peter Steinberger 开发的一款开源 AI 助手，它允许你通过熟悉的即时通讯软件（如 Telegram），指挥部署在本地的 AI，替代 Zapier 或 Make 等昂贵的自动化平台，构建完全属于你的数字生产力系统。

一、Clawdbot 能解决什么问题？

1. 个人事务助理 (Personal Assistant)
   无需切换 APP，在聊天窗口即可完成跨应用操作：

“帮我查询下周二的空闲时间，并向团队发送会议邀请邮件。”
“读取 ‘项目A’ 文件夹里的最新 PDF，总结核心数据并发给我。”

2. 网页任务自动化 (Web Automation)
   这是 Clawdbot 区别于普通机器人的杀手锏。它内置了无头浏览器 (Headless Browser) 能力，可以安全地模拟网页访问。这意味着你可以让 AI 自动查阅公开数据、监控网页变更，相当于内置了一个轻量级的 RPA 机器人。
3. 本地文件与知识库管理
   不同于云端 AI 无法触及你的硬盘，Clawdbot 可以安全地管理本地文件。你可以指令它自动归档下载目录、批量重命名发票，或者基于本地 Markdown 笔记库回答问题。

二、Clawdbot部署教程

1、基础环境

• 运行环境： Node.js 22+ (LTS 版本推荐)。
• 模型支持： 既支持 OpenAI/Anthropic API，也支持通过 Ollama 接入 Llama 3 等本地开源模型，实现零数据泄露。

Clawdbot 对硬件要求相当宽松。基本聊天功能仅需2GB 内存与双核处理器；若要启用浏览器自动化或多工作流程，建议配备4GB 以上内存与20GB 硬盘空间。

它支持的平台包括macOS、Linux，以及通过WSL2 运行的Windows 环境。

2、快速安装步骤

2.1 、macOS / Linux 安装

开启终端执行以下指令：

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

安装程序会自动检测系统环境、安装必要依赖，并启动安装向导。

2.2 、Windows 安装（PowerShell）

iwr -useb https://clawd.bot/install.ps1 | iex

若需要在CI/CD 环境或自动化脚本中使用：

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

安装完成后，执行exec bash重新载入环境变数，再手动执行引导设定：

clawdbot onboard --install-daemon

---

2.3 引导设置向导详解

执行clawdbot onboard后，系统会逐步引导完成以下配置：

Gateway 模式选择

• Local：适合单机使用，推荐首次安装选择
• Remote：适合云端VPS 部署

AI 模型认证

• Anthropic API Key（推荐）：前往console.anthropic.com取得
• OpenAI API Key
• OAuth（Claude Pro/Max 订阅用户）
• OpenAI Codex 订阅

模型选择

• anthropic/claude-opus-4-5：最高品质，适合复杂推理任务
• anthropic/claude-sonnet-4-5：平衡效能与成本

通讯频道设定

支持的平台包括WhatsApp、Telegram、Discord、Slack、Signal、iMessage、Google Chat、Microsoft Teams、Matrix 等。以WhatsApp 为例，系统会显示二维码，使用手机扫描即可完成连结。

---

2.5 、启动Gateway 服务

clawdbot gateway --port 18789 --verbose

若要让服务在背景持续运行：

安裝 systemd 服務（Linux）

sudo loginctl enable-linger "$USER"systemctl --user daemon-reloadsystemctl --user enable --now clawdbot-gateway.service

确认服务状态：

clawdbot statusclawdbot healthclawdbot gateway status

---

2.6、云端VPS 部署指南

本文以DigitalOcean 为例，选择Ubuntu 24.04 LTS、2GB RAM、1 vCPU 的Droplet：

ssh root@YOUR_IPadduser clawd && usermod -aG sudo clawd && su - clawdcurl -fsSL https://clawd.bot/install.sh | bashexec bashclawdbot setup --wizardclawdbot gateway --bind lan --port 18789

通过SSH 通道存取本地端：

ssh -L 18789:127.0.0.1:18789 clawd@YOUR_IP

开启http://127.0.0.1:18789即可存取控制界面。

其他云端平台选项包括Hetzner、Linode、Railway、Render 等，部分提供免费额度供测试使用。

扩展资源

• 官方文档（https://docs.clawd.bot/）
• GitHub （https://github.com/clawdbot/clawdbot）