Clawdbot汉化版环境部署：Clawdbot Gateway + Ollama + Nginx SSL反向代理

Clawdbot 汉化版现已支持企业微信入口，这意味着你不仅能通过 WhatsApp、Telegram、Discord 等国际平台与 AI 助手实时对话，还能无缝接入国内最常用的企业协作场景——企业微信。无需额外开发，开箱即用，消息收发、会话记忆、多轮上下文理解全部原生支持。企业微信管理员只需在后台配置可信域名和回调地址，员工即可在工作群或私聊中直接唤起 AI，完成会议纪要整理、日报生成、知识库问答、流程审批辅助等高频任务，所有数据全程留存在你自己的服务器上。

Clawdbot 就是一个你可以随时跟 AI 对话的智能助手，就像 ChatGPT 一样，但是：
在微信里就能用（支持 WhatsApp、Telegram、Discord、企业微信等）
完全免费（使用你自己的 AI 模型，不依赖任何云 API）
数据隐私（所有聊天记录、会话状态、模型权重都保存在你本地服务器）
24 小时在线（开机自动启动，断电恢复后自动重连）
网关令牌：dev-test-token

---

1. 什么是 Clawdbot？

Clawdbot 不是另一个需要注册、充值、看广告的 SaaS 工具，它是一套真正属于你的 AI 对话基础设施。你可以把它理解成“AI 助手的操作系统”——底层由你掌控，上层应用自由扩展。

它由三个核心组件构成：

• Clawdbot Gateway：统一通信网关，负责接收来自微信、WhatsApp、Telegram、Discord、网页面板等渠道的消息，分发给 AI 引擎，并将回复准确投递回对应用户。
• Ollama：轻量级本地大模型运行时，让你在普通笔记本或家用 NAS 上就能跑起 Qwen2、Phi3、Llama3 等主流开源模型，无需 GPU 也能流畅响应。
• Nginx SSL 反向代理：为 Gateway 提供 HTTPS 安全访问、域名绑定、负载分流能力，让企业微信等平台能稳定回调，同时屏蔽非法请求。

这三者组合起来，就构成了一个可落地、可审计、可定制、零月费的私有 AI 助手系统。你不是在租用服务，而是在部署一个数字同事。

---

2. 部署前准备：环境与依赖

2.1 系统要求

Clawdbot 汉化版推荐运行在 Linux 环境（Ubuntu 22.04/24.04 或 CentOS Stream 9），最低配置如下：

组件	推荐配置	最低配置
CPU	4 核以上	2 核
内存	8 GB	4 GB（运行 qwen2:0.5b 级别模型）
硬盘	50 GB SSD（含模型缓存空间）	20 GB
网络	公网 IP 或内网穿透能力（企业微信需公网域名）	—

注意：企业微信回调必须通过 HTTPS 域名访问 Gateway 接口，因此你需要一个已备案的域名（如 ai.yourcompany.com），并能解析到你的服务器 IP。

2.2 快速安装基础依赖

打开终端，依次执行以下命令（以 Ubuntu 为例）：

# 更新系统
sudo apt update && sudo apt upgrade -y

# 安装必要工具
sudo apt install -y curl wget git gnupg ca-certificates nginx-full

# 安装 Node.js 20（Clawdbot 要求）
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

# 安装 pnpm（构建工具）
sudo npm install -g pnpm

# 安装 Docker（可选，用于隔离运行）
sudo apt install -y docker.io
sudo systemctl enable docker
sudo usermod -aG docker $USER

2.3 安装 Ollama：本地模型引擎

Ollama 是运行开源大模型最简单的方式。执行以下命令一键安装：

# 下载并安装 Ollama
curl -fsSL https://ollama.com/install.sh | sh

# 启动服务（开机自启）
sudo systemctl enable ollama
sudo systemctl start ollama

# 验证安装
ollama --version
# 应输出类似：ollama version is 0.3.10

安装完成后，你可以立即拉取一个轻量模型测试：

ollama pull qwen2:0.5b

该模型仅占用约 1.2 GB 磁盘空间，可在 4 GB 内存机器上实现秒级响应，非常适合首次部署验证。

---

3. 部署 Clawdbot Gateway 与汉化版核心

3.1 获取汉化版源码并初始化

Clawdbot 官方未提供中文界面，本汉化版由社区维护，已集成企业微信支持、中文提示词模板、简体中文 Web 控制台及完整文档。

# 创建工作目录
sudo mkdir -p /root/clawdbot
cd /root/clawdbot

# 克隆汉化版仓库（非官方，已适配企业微信）
sudo git clone https://github.com/clawd-bot-cn/clawdbot.git .

# 安装依赖（使用 pnpm 加速）
sudo pnpm install

# 构建项目
sudo pnpm build

构建成功后，你会看到 dist/ 目录下生成了可执行的 JS 文件。

3.2 配置 Gateway：启用企业微信与多通道

编辑主配置文件：

sudo nano /root/.clawdbot/clawdbot.json

将以下内容粘贴进去（覆盖原有内容），请根据注释修改关键字段：

{
  "auth": {
    "token": "dev-test-token"
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "ollama/qwen2:0.5b",
        "fallback": "ollama/phi3:3.8b"
      }
    }
  },
  "gateways": {
    "http": {
      "port": 18789,
      "host": "0.0.0.0"
    },
    "wechatwork": {
      "enabled": true,
      "corp_id": "YOUR_CORP_ID_HERE",
      "secret": "YOUR_APP_SECRET_HERE",
      "agent_id": 1000002,
      "token": "your_wechatwork_token",
      "aes_key": "YOUR_AES_KEY_43_CHARS_LONG"
    },
    "whatsapp": {
      "enabled": true
    },
    "telegram": {
      "enabled": true
    },
    "discord": {
      "enabled": true
    }
  }
}

企业微信参数获取方式：

• corp_id：企业微信管理后台 → 「我的企业」→「企业信息」底部
• secret：「应用管理」→ 找到你创建的「AI助手」应用 → 「应用详情」→ 「Secret」
• agent_id：同上页面中的「AgentId」（纯数字）
• token 和 aes_key：点击「接收消息」→ 开启 → 自动生成（复制保存）

注意：aes_key 必须是 43 位随机字符串（可用 openssl rand -base64 32 | tr -d "=+/" | cut -c1-43 生成）

3.3 启动 Gateway 并验证

# 启动网关（后台运行）
nohup node dist/index.js gateway > /tmp/clawdbot-gateway.log 2>&1 &

# 查看是否启动成功
ps aux | grep clawdbot-gateway
# 应看到类似：node dist/index.js gateway

# 实时查看日志
tail -f /tmp/clawdbot-gateway.log
# 正常启动后会显示： Gateway listening on http://0.0.0.0:18789

此时，你已可通过 http://你的服务器IP:18789 访问网页控制台，输入令牌 dev-test-token 即可开始对话。

---

4. 配置 Nginx SSL 反向代理（企业微信必需）

企业微信只接受 HTTPS 回调，且要求域名有效。我们使用 Nginx + Let's Encrypt 实现全自动证书签发与反向代理。

4.1 配置 Nginx 站点

# 编辑新站点配置
sudo nano /etc/nginx/sites-available/clawdbot

# 粘贴以下内容（替换 your-domain.com 为你的实际域名）
server {
    listen 80;
    server_name ai.your-domain.com;

    location / {
        return 301 https://$server_name$request_uri;
    }
}

server {
    listen 443 ssl http2;
    server_name ai.your-domain.com;

    ssl_certificate /etc/letsencrypt/live/ai.your-domain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/ai.your-domain.com/privkey.pem;
    ssl_trusted_certificate /etc/letsencrypt/live/ai.your-domain.com/chain.pem;

    # SSL 安全加固
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256;
    ssl_prefer_server_ciphers off;

    location / {
        proxy_pass http://127.0.0.1:18789;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_cache_bypass $http_upgrade;
    }

    # 企业微信验证专用路径（必须开放）
    location /cgi-bin {
        proxy_pass http://127.0.0.1:18789;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

启用站点：

sudo ln -sf /etc/nginx/sites-available/clawdbot /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx

4.2 申请并自动续期 SSL 证书

# 安装 Certbot
sudo apt install -y certbot python3-certbot-nginx

# 申请证书（确保域名已解析到本机 IP）
sudo certbot --nginx -d ai.your-domain.com

# 设置自动续期（Certbot 已自动配置 systemd timer）
sudo systemctl list-timers | grep certbot

完成后，访问 https://ai.your-domain.com 即可看到安全锁图标，企业微信后台的「接收消息」URL 填写 https://ai.your-domain.com/cgi-bin/webhook 即可完成验证。

---

5. 连接企业微信：三步上线 AI 助手

5.1 在企业微信管理后台创建应用

1. 登录 企业微信管理后台
2. 进入「应用管理」→ 「自建」→ 「创建应用」
3. 填写名称（如“内部AI助手”）、头像、描述
4. 记录生成的 AgentId（数字）和 Secret（密钥）

5.2 配置接收消息

1. 点击刚创建的应用 → 「接收消息」
2. 开启「接收消息」开关
3. 填写：
   • URL：https://ai.your-domain.com/cgi-bin/webhook
   • Token：你配置文件中设置的 token（如 your_wechatwork_token）
   • EncodingAESKey：你配置文件中设置的 aes_key
4. 点击「验证」，若显示绿色对勾即成功

5.3 发布并授权

1. 返回应用详情页 → 「可见范围」→ 选择部门/成员（建议先选自己测试）
2. 点击「发布」
3. 成员在手机企业微信 → 「工作台」→ 找到该应用 → 点击进入 → 即可开始对话

小技巧：在对话中发送 /help，AI 会自动返回功能说明；发送 /reset 可清空当前会话记忆。

---

6. 日常运维与实用技巧

6.1 一键启停脚本（推荐放入 /root/）

创建启动脚本：

sudo nano /root/start-clawdbot.sh

内容如下：

#!/bin/bash
cd /root/clawdbot
pkill -f "node dist/index.js gateway"
sleep 2
nohup node dist/index.js gateway > /tmp/clawdbot-gateway.log 2>&1 &
echo "Clawdbot Gateway started."

创建重启脚本：

sudo nano /root/restart-gateway.sh

内容如下：

#!/bin/bash
bash /root/start-clawdbot.sh
echo "Gateway restarted. Log: tail -f /tmp/clawdbot-gateway.log"

赋予执行权限：

sudo chmod +x /root/start-clawdbot.sh /root/restart-gateway.sh

6.2 模型切换与性能调优

不同场景推荐不同模型组合：

场景	推荐模型	特点	命令示例
企业微信快速问答（客服/FAQ）	qwen2:0.5b	响应快、内存占用低	node dist/index.js config set agents.defaults.model.primary ollama/qwen2:0.5b
技术文档总结/代码生成	phi3:3.8b	推理强、逻辑稳	ollama pull phi3:3.8b
高质量报告撰写/创意文案	llama3.1:8b	表达丰富、结构清晰	ollama pull llama3.1:8b

所有模型均通过 ollama list 查看，ollama rm 模型名 可卸载。

6.3 数据备份与迁移

# 备份全部（配置 + 会话 + 身份 + 日志）
sudo tar -czf /backup/clawdbot-$(date +%Y%m%d-%H%M).tar.gz \
  /root/.clawdbot \
  /root/clawd \
  /tmp/clawdbot-gateway.log

# 迁移到新服务器后解压即可恢复
sudo tar -xzf clawdbot-20240101-1200.tar.gz -C /

---

7. 总结

Clawdbot 汉化版不是玩具，而是一套可投入真实业务使用的 AI 对话底座。它把原本需要数万元定制开发的企业微信 AI 助手，压缩成几条命令就能跑起来的开源方案。你掌握的不只是“怎么用”，而是“怎么改”、“怎么扩”、“怎么管”。

从今天起，你的 AI 助手具备了：

• 企业级接入能力：微信、WhatsApp、Telegram、Discord 四端统一管理
• 完全自主可控：模型、数据、日志、配置，全部在你手中
• 零持续成本：无需 API 调用费、无并发限制、无用量封顶
• 平滑升级路径：从 qwen2:0.5b 到 llama3.1:70b，只需一条 ollama pull

部署只是开始。下一步，你可以：
🔹 为企业微信添加审批流插件
🔹 为 Telegram Bot 增加 Markdown 渲染支持
🔹 将会话记录同步到本地 SQLite 或 PostgreSQL
🔹 用 --deliver --reply-channel 实现定时日报自动推送

真正的 AI 自主权，始于你敲下第一个 git clone 的那一刻。

---

> **获取更多AI镜像**
>
> 想探索更多AI镜像和应用场景？访问 [CSDN星图镜像广场](https://ai.csdn.net/?utm_source=mirror_blog_end)，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。