Clawdbot 完整安装与使用教程（从 0 到 1 全指南）

一、工具简介

clawdbot 是一款开源个人 ai 智能体 (personal ai agent)，核心优势为本地部署+系统级执行+全渠道交互，可通过聊天工具 (telegram/whatsapp 等) 下达指令，自动完成文件整理、代码部署、日程同步等任务，所有数据本地存储，隐私零泄露。截至 2026 年 1 月，github 星标突破 4 万+，支持 windows/mac/linux/云服务器多平台。

二、前置要求(硬件+软件)

1. 硬件配置

2. 软件与权限准备

3. 关键凭证 (必选其一)

• AI 模型 API Key: 支持 Claude/GPT-4 (需科学上网)、智谱 GLM-4.5、阿里云百炼、MiniMax 等国产模型 (国内可直接访问)
• 聊天平台 Token: Telegram Bot Token (新手推荐)、WhatsApp/ Discord/ Slack Token (进阶用户)

三、全网权威下载路径汇总

官方核心路径

四、安装步骤 (三种主流方式)

方式一: Docker 部署 (跨系统通用,推荐新手)

1. 环境准备

• 安装 Docker 并启动 (验证: 终端输入 docker --version 显示版本)
• Windows 用户需先启用 WSL2: 控制面板→程序→启用或关闭 Windows 功能→勾选“适用于 Linux 的 Windows 子系统”和“虚拟机平台”，安装 Ubuntu 22.04 LTS

2. 拉取源码与配置

# 1. 克隆源码 (失败则直接下载压缩包解压)
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot

# 2. 复制配置文件并修改
cp .env.example .env
vim .env # 或用记事本打开 .env 文件

必改配置项:

• CLAWS_BOT_NAME: 自定义 AI 名称 (如“MyClawdbot")
• CLAWS_SERVER_PORT: 本地端口 (默认 8080, 冲突可改 8081)
• CLAWS_DEFAULT_MODEL: AI 模型 (本地填“llama3:8b”，云端填 API Key)
• CLAWS_DATA_DIR: 数据存储路径 (建议改为绝对路径, 如 "/Users/xxx/clawdbot/data")

3. 启动容器

# 构建镜像并后台运行 (首次需 5-10 分钟下载依赖)
docker-compose up -d --build

# 验证启动: 查看容器状态 (显示“up”即为成功)
docker ps

# 查看日志 (排查报错)
docker logs clawdbot

4. 验证部署

打开浏览器访问 http://localhost:8080 (端口对应配置文件)，出现 Clawdbot 管理界面则部署成功。

易方销售系统EfangIsale

1 先进的多级用户及代理商管理功能 2 透明的会员资金管理，系统自动完成会员资金的管理业务。 3 规范的业务流程，客户提交订单--业务人员受理订单--技术人员开通业务，简单，规范，使用的企业管理更加规范化。 4 便捷安装接入，只要把你的前台链接到我们指定的入口，其它的业务管理全部由系统自动完成。 5 领先的产品及菜单管理功能。可对产品和会员的菜单进行动态的增加、修改、删除，从而使用轻松方便的增加新

下载

方式二: 一键脚本安装 (Mac/Linux 原生, 快速部署)

# 1. 执行官方一键安装脚本
curl -fsSL https://clawd.bot/install.sh | bash

# 2. 运行配置向导 (自动生成配置文件)
clawdbot onboard --install-daemon

# 3. 按向导提示完成:
# - 选择启动模式 (推荐 QuickStart)
# - 输入 AI 模型 API Key
# - 选择聊天渠道 (如 Telegram) 并输入 Token

方式三: npm 全局安装 (进阶用户, 灵活配置)

# 1. 安装 Node.js 22+ (已安装可跳过)
nvm install 22
nvm use 22

# 2. 全局安装 Clawdbot
npm install -g clawdbot@latest
# 或用 pnpm: pnpm add -g clawdbot@latest

# 3. 启动配置向导
clawdbot onboard

# 4. 启动网关 (核心服务)
clawdbot gateway --port 18789 --verbose

五、聊天工具对接 (以 Telegram 为例, 最稳定)

1. 获取 Telegram Bot Token

1. 打开 Telegram, 搜索“@BotFather"
2. 发送/newbot, 按提示输入机器人名称和用户名 (需以“bot”结尾)
3. 收到 API 密钥 (格式: 123456:ABC-DEF1234ghIkl)，复制保存

2. 配置对接

1. 打开 .env 文件 (Docker 部署) 或 ~/.clawdbot/clawdbot.json (脚本安装)
2. 填入 TELEGRAM_BOT_TOKEN="你的密钥"
3. 重启服务:
   • Docker: docker-compose restart
   • 脚本安装: clawdbot gateway restart

3. 验证对接

1. Telegram 搜索创建的机器人, 发送/start
2. 收到欢迎语后, 发送测试指令 (如“列出当前目录文件”)
3. 机器人返回执行结果即对接成功

六、使用指南 (核心功能+操作指令)

1. 基础操作流程

（本节无具体内容，预计在实际文档中会有详细的基础操作流程介绍）

2. 常用指令示例

3. 进阶配置 (解锁更多功能)

(1) 对接国产模型 (以智谱 GLM-4.5 为例)

1. 注册智谱 AI 平台,获取 API Key: 智谱开放平台
2. 编辑配置文件~/.clawdbot/clawdbot.json:

{
  "agents": {
    "defaults": {
      "model": { "primary": "glm/glm-4-plus" },
      "models": { "glm-4-plus": { "alias":"智谱 GLM-4.5" } }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "glm": {
        "baseUrl": "https://open.bigmodel.cn/api/paas/v4",
        "apiKey":"你的智谱 API Key",
        "api": "openai-completions",
        "models": [
          {
            "id": "glm-4-plus",
            "name": "GLM-4.5",
            "contextWindow": 102400,
            "maxTokens": 32000
          }
        ]
      }
    }
  }
}

3. 重启网关: clawdbot gateway restart

(2) 安装技能插件

1. 访问 Clawdhub, 下载所需插件 (如邮件整理、浏览器自动化)
2. 将插件文件放入 clawdbot/plugins 目录
3. 执行 clawdbot plugin install 激活插件

七、常见问题与解决方案

1. 安装失败

2. 功能异常

3. 安全与稳定性

• 风险提示: Clawdbot 拥有系统级权限, 禁止在主力电脑运行, 建议使用闲置设备或云服务器
• 避免中断: 设置电脑“永不睡眠”, WSL2 用户执行 wsl --shutdown 避免后台耗电
• 成本优化: 轻度使用选择国产模型 (如 GLM-4.5), 重度使用搭配 Claude Opus