Clawdbot汉化版部署教程：CentOS7环境下Ollama+Clawdbot全链路安装

本文介绍了如何在星图GPU平台上自动化部署Clawdbot 汉化版增加企业微信入口镜像，实现企业微信内AI智能协作。用户可在微信工作群中直接@助手生成会议纪要、整理日报或解答技术问题，所有数据本地运行、安全可控，显著提升团队办公效率。

三七二十一的七

139人浏览 · 2026-01-30 01:11:47

三七二十一的七 · 2026-01-30 01:11:47 发布

Clawdbot汉化版部署教程：CentOS7环境下Ollama+Clawdbot全链路安装

Clawdbot汉化版在原生功能基础上，特别增加了企业微信入口，让国内团队协作更无缝——无需翻墙、不依赖境外服务，消息收发稳定，会话记录完全本地化存储。这意味着你可以在熟悉的微信工作群中直接@AI助手提问，获取技术解答、生成会议纪要、自动整理日报，所有数据始终留在你的服务器上。

Clawdbot 就是一个你可以随时跟 AI 对话的智能助手，就像 ChatGPT 一样，但是：
在微信里就能用（支持 WhatsApp、Telegram、Discord 等）
完全免费（使用你自己的 AI 模型）
数据隐私（所有聊天记录都在你自己的电脑上）
24 小时在线（开机自动启动）
网关令牌：dev-test-token

1. 什么是 Clawdbot？

Clawdbot 不是另一个云端聊天机器人，而是一套可完全自主掌控的本地化AI交互系统。它由三部分组成：Ollama模型运行时（负责推理）、Clawdbot核心引擎（负责对话管理与协议适配）、多端网关服务（负责连接微信/WhatsApp等IM平台）。整套流程不经过任何第三方服务器，从输入提示词到返回答案，全程在你的CentOS7机器上完成。

它的核心价值在于“可控”二字：

你决定用哪个模型（Qwen2、Phi3、Llama3.1……），而不是被平台限定；
你掌握每一条聊天记录的存储位置和加密方式；
你配置每一次响应的思考深度、输出格式甚至人格设定；
你添加企业微信支持后，一线销售、客服、运维人员都能在日常沟通中自然调用AI能力，无需切换App或学习新界面。

简单说：Clawdbot 是把大模型装进你办公室的“AI插座”——插上即用，拔掉即停，线路归你管，电流归你控。

2. 环境准备与一键部署

2.1 系统要求确认

Clawdbot汉化版已在CentOS 7.9（内核3.10.0-1160.el7.x86_64）完整验证。请确保你的服务器满足以下最低要求：

CPU：4核以上（推荐8核）
内存：16GB起（运行8B模型建议32GB）
硬盘：50GB可用空间（含模型缓存与日志）
网络：能访问GitHub、Docker Hub（用于首次拉取依赖）

执行以下命令检查基础环境：

# 查看系统版本
cat /etc/centos-release

# 查看内存与CPU
free -h && lscpu | grep -E "(CPU|Mem)"

# 检查SELinux状态（必须为disabled或permissive）
getenforce

若SELinux处于Enforcing状态，请临时关闭并永久禁用：

sudo setenforce 0
echo "SELINUX=disabled" | sudo tee /etc/selinux/config

2.2 安装基础依赖

CentOS7默认源较旧，需先启用EPEL并更新工具链：

sudo yum install -y epel-release
sudo yum update -y
sudo yum groupinstall -y "Development Tools"
sudo yum install -y git curl wget tar gzip unzip jq python3 python3-pip nodejs npm

注意：Clawdbot要求Node.js v18+。CentOS7默认yum源仅提供v10，需手动升级：
curl -fsSL https://rpm.nodesource.com/setup_lts.sh | sudo bash -
sudo yum install -y nodejs
node -v  # 应输出 v18.x 或更高

2.3 部署Ollama（本地模型运行时）

Ollama是Clawdbot的“大脑引擎”，负责加载和运行大模型。我们采用官方二进制方式安装，避免Docker依赖：

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

# 启动Ollama服务（systemd方式）
sudo systemctl enable ollama
sudo systemctl start ollama

# 验证服务状态
sudo systemctl status ollama --no-pager | head -n 10

此时Ollama已后台运行。你可以立即测试一个轻量模型：

ollama run qwen2:0.5b "你好，你是谁？"

如果看到清晰中文回复，说明Ollama部署成功。

2.4 安装Clawdbot汉化版核心

Clawdbot汉化版由社区维护，代码托管于Gitee镜像（国内加速访问）：

# 创建统一工作目录
sudo mkdir -p /root/clawdbot
sudo chown $USER:$USER /root/clawdbot

# 克隆汉化版仓库（含企业微信补丁）
cd /root/clawdbot
git clone https://gitee.com/clawdbot-han/clawdbot.git .
git checkout v2.4.1-han  # 当前稳定汉化分支

# 安装依赖并构建
pnpm install --no-frozen-lockfile
pnpm build

提示：若未安装pnpm，请先运行 npm install -g pnpm。构建过程约2-5分钟，取决于网络与CPU性能。

2.5 配置企业微信网关（汉化版专属）

Clawdbot原生不支持企业微信，汉化版通过wechatwork-gateway模块实现。你需要提前在企业微信管理后台创建应用：

进入「应用管理」→「自建应用」→「创建应用」
记录下「AgentId」、「Secret」、「CorpId」
在「可信域名」中填入你的服务器公网IP（如123.45.67.89）

配置步骤如下：

# 编辑Clawdbot主配置
nano /root/clawdbot/.clawdbot/clawdbot.json

在gateways节点下添加企业微信配置（替换为你的真实参数）：

"wechatwork": {
  "enabled": true,
  "agentId": "1000001",
  "secret": "your_app_secret_here",
  "corpId": "your_corp_id_here",
  "token": "dev-test-token",
  "encodingAESKey": "your_encoding_aes_key"
}

保存后，启动网关服务：

# 启动Clawdbot网关（含企业微信支持）
nohup node dist/index.js gateway > /tmp/clawdbot-gateway.log 2>&1 &
echo $! > /tmp/clawdbot-gateway.pid

2.6 验证服务运行状态

执行以下命令确认所有组件就绪：

# 检查进程
ps aux | grep -E "(ollama|clawdbot)" | grep -v grep

# 检查端口占用（Clawdbot默认监听18789）
sudo ss -tuln | grep :18789

# 查看最近日志
tail -n 20 /tmp/clawdbot-gateway.log

正常输出应包含类似内容：
[INFO] Gateway started on http://0.0.0.0:18789
[INFO] WeChatWork gateway initialized
[INFO] Ollama connection OK

3. 快速上手：三种对话方式实测

3.1 终端直连（调试首选）

这是最直接的验证方式，绕过所有网关，直通AI核心：

# 发送第一条问候
node dist/index.js agent --agent main --message "你好，我是运维小王"

# 请求结构化输出（适合脚本调用）
node dist/index.js agent --agent main --message "列出Linux常用磁盘检查命令" --json

# 指定模型与思考深度
node dist/index.js agent --agent main \
  --message "用Python写一个监控CPU使用率并告警的脚本" \
  --model ollama/phi3:3.8b \
  --thinking high

成功标志：终端立即打印出格式清晰、内容准确的中文回复。

3.2 网页控制台（管理最便捷）

打开浏览器，访问 http://你的服务器IP:18789，输入令牌 dev-test-token 即可进入可视化界面。这里你可以：

实时查看所有活跃会话
手动触发模型切换（下拉菜单选择qwen2:1.5b或llama3.1:8b）
调整全局思考深度（滑块控制low/medium/high）
查看实时日志流（无需SSH登录）

小技巧：网页端支持Ctrl+Enter快速发送，输入/help可唤出命令列表。

3.3 企业微信接入（汉化版核心价值）

这是区别于其他方案的关键一步。完成配置后：

在企业微信「工作台」找到你创建的应用（名称可设为“AI小助手”）
点击进入，发送任意消息（如“天气”）
3秒内收到AI回复，且自动识别上下文（如你问“刚才说的温度是多少？”，它能准确引用前文）

所有消息均走企业微信官方API，无中间代理，符合等保合规要求。会话记录默认保存在 /root/.clawdbot/agents/main/sessions/，按日期分文件夹存储，可直接用cat或jq解析。

4. 常见问题实战解决

4.1 企业微信收不到消息？三步定位

现象：在企微发送消息后无响应，日志中出现40018 invalid appid错误。

排查路径：

检查配置文件中corpId是否复制完整（注意末尾空格）
运行诊断命令：
```
node dist/index.js wechatwork diagnose
```
输出将明确提示缺失字段或签名失败原因
确认企业微信后台「接收消息」开关已开启（路径：应用详情 → 接收消息 → 启用）

修复命令（自动重载配置）：

node dist/index.js config reload

4.2 Ollama模型加载慢？优化内存策略

Clawdbot默认使用Ollama的/api/chat接口，但CentOS7对mmap内存映射支持较弱。启用numa绑定可提升30%加载速度：

# 编辑Ollama服务配置
sudo nano /etc/systemd/system/ollama.service

在[Service]段添加：

Environment="OLLAMA_NUMA=1"

然后重启：

sudo systemctl daemon-reload
sudo systemctl restart ollama

4.3 中文提示词响应差？调整模型参数

Qwen2系列模型对中文提示词敏感度高。若发现AI答非所问，优先检查IDENTITY.md中的人设描述是否含英文术语。汉化版已内置优化模板：

# 直接覆盖为中文友好人设
curl -s https://gitee.com/clawdbot-han/assets/raw/master/IDENTITY_zh.md \
  > /root/clawdbot/.clawdbot/IDENTITY.md

该模板强制AI以“中文母语者”身份响应，拒绝翻译腔，优先使用成语与口语化表达。

4.4 如何让AI记住部门架构？注入知识库

Clawdbot支持本地RAG（检索增强生成）。将部门组织图谱存为Markdown：

# 创建知识库目录
mkdir -p /root/clawdbot/knowledge

# 编写部门说明（示例）
cat > /root/clawdbot/knowledge/org.md << 'EOF'
# 技术中心组织架构
- CTO：张伟
- 前端组：5人，负责人李娜，专注Vue3与微前端
- 后端组：8人，负责人王磊，主攻Spring Cloud与Go微服务
- AI实验室：3人，负责人陈明，负责Clawdbot定制与模型优化
EOF

再执行注入命令：

node dist/index.js knowledge ingest --path /root/clawdbot/knowledge/org.md

此后提问“后端组负责人是谁？”，AI将精准回答“王磊”，而非泛泛而谈。

5. 生产级运维建议

5.1 开机自启（保障24小时在线）

创建systemd服务确保Clawdbot随系统启动：

sudo tee /etc/systemd/system/clawdbot.service << 'EOF'
[Unit]
Description=Clawdbot AI Gateway
After=network.target ollama.service

[Service]
Type=simple
User=root
WorkingDirectory=/root/clawdbot
ExecStart=/usr/bin/node dist/index.js gateway
Restart=always
RestartSec=10
StandardOutput=journal
StandardError=journal

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable clawdbot
sudo systemctl start clawdbot

5.2 日志轮转（防止磁盘占满）

CentOS7默认无logrotate配置，手动添加：

sudo tee /etc/logrotate.d/clawdbot << 'EOF'
/tmp/clawdbot-gateway.log {
    daily
    missingok
    rotate 30
    compress
    delaycompress
    notifempty
    create 644 root root
}
EOF

5.3 备份策略（防误操作）

每周自动备份配置与会话（保留4周）：

# 添加到crontab（每周日凌晨2点）
echo "0 2 * * 0 tar -czf /backup/clawdbot-$(date +\%Y\%m\%d).tar.gz /root/.clawdbot /root/clawdbot/knowledge" | sudo crontab -
sudo mkdir -p /backup