Clawdbot汉化版环境部署：Ubuntu+Ollama+Gateway一站式配置

Clawdbot汉化版不仅完成了全中文界面与交互优化，更关键的是新增了企业微信入口——这意味着你无需切换平台，就能在最熟悉的办公环境中直接调用本地大模型能力。它不是另一个云端聊天框，而是一套真正属于你自己的AI基础设施：模型跑在你家服务器上，对话存在你本地硬盘里，连登录令牌都由你自己生成和管理。

1. 什么是Clawdbot？

Clawdbot不是一个需要注册、订阅或看广告的SaaS工具，它是一套可完全掌控的本地AI网关系统。你可以把它理解成“AI世界的路由器”：一边连接你电脑里的Ollama模型，另一边打通微信、WhatsApp、Telegram等主流通讯渠道，让AI能力像水电一样自然接入你的日常沟通流。

它的核心价值不是“能聊天”，而是“怎么聊得安全、顺手、不设限”：

  • 在微信里就能用（支持企业微信、WhatsApp、Telegram、Discord等）
  • 完全免费（不依赖任何API密钥，所有推理都在本地完成）
  • 数据隐私（聊天记录默认存于/root/.clawdbot/agents/main/sessions/，无外传风险）
  • 24小时在线（通过systemd服务开机自启，断电重启后自动恢复）

特别说明：本次汉化版已内置企业微信适配模块，配置完成后，你可以在企业微信工作台中直接添加Clawdbot为应用，员工点击即可发起AI对话，全程不经过第三方服务器。

2. 环境准备与快速部署

2.1 基础系统要求

Clawdbot汉化版推荐运行在Ubuntu 22.04 LTS或24.04 LTS系统上，最低硬件要求如下：

组件推荐配置最低配置
CPU4核以上2核
内存8GB+4GB（仅限小模型）
硬盘50GB SSD（含模型缓存空间）20GB
网络可访问公网（仅用于首次下载，后续完全离线）—

注意：Clawdbot本身不占用大量资源，但Ollama加载的模型会常驻内存。例如qwen2:1.5b约需2.1GB显存（或CPU内存），llama3.1:8b则需约6GB。若无GPU，建议优先选择phi3:3.8b或qwen2:0.5b这类轻量级模型。

2.2 一键安装脚本（推荐新手）

我们为你准备了经过验证的自动化部署脚本，全程无需手动编译或配置路径：

# 下载并执行安装脚本（全程约3分钟）
curl -fsSL https://raw.githubusercontent.com/clawdbot/cn-installer/main/install.sh | bash

# 脚本将自动完成以下操作：
#  安装Node.js 20.x（LTS版本）
#  安装Ollama并设置为systemd服务
#  克隆Clawdbot汉化版仓库到/root/clawdbot
#  安装pnpm及依赖
#  构建dist包
#  配置gateway服务（端口18789，令牌dev-test-token）
#  设置开机自启

安装完成后，系统会输出类似提示：

 Clawdbot汉化版部署完成！
 网页控制台：http://你的服务器IP:18789
 令牌：dev-test-token
 配置目录：/root/.clawdbot
📦 模型目录：/root/.ollama/models

2.3 手动验证服务状态

打开终端，执行以下命令确认核心服务是否就绪：

# 查看gateway服务状态
sudo systemctl status clawdbot-gateway

# 应看到类似输出：
# ● clawdbot-gateway.service - Clawdbot Gateway Service
#    Loaded: loaded (/etc/systemd/system/clawdbot-gateway.service; enabled; vendor preset: enabled)
#    Active: active (running) since Mon 2024-06-10 14:22:33 CST; 2min 15s ago

如果显示inactive，请运行：

sudo systemctl start clawdbot-gateway
sudo systemctl enable clawdbot-gateway  # 设为开机自启

3. 首次使用与基础测试

3.1 快速对话测试（30秒验证）

无需打开网页或手机，直接在终端发起一次真实对话，验证整个链路是否畅通：

cd /root/clawdbot
node dist/index.js agent --agent main --message "你好，我是第一次使用Clawdbot汉化版，请用中文简单介绍你自己"

正常响应示例（以qwen2:0.5b为例）：

“你好！我是Clawdbot汉化版的AI助手，运行在你的本地电脑上。我不联网、不上传数据，所有对话都保存在你自己的硬盘里。你可以通过微信、网页或命令行随时和我聊天，比如问天气、写文案、查资料、写代码——需要我帮你做什么吗？”

若返回错误，请先检查：

  • ollama list 是否有可用模型（如无，运行 ollama pull qwen2:0.5b）
  • /root/.clawdbot/clawdbot.json 中 agents.defaults.model.primary 字段是否指向有效模型名（如 ollama/qwen2:0.5b）

3.2 网页控制台初体验

在浏览器中访问 http://你的服务器IP:18789，输入令牌 dev-test-token 进入控制台。

这里不是简单的聊天窗口，而是具备完整调试能力的AI工作台：

  • 左侧可切换不同Agent（主助手、代码专家、文档总结员等）
  • 右上角可实时调整thinking级别（minimal/medium/high）
  • 输入框支持Markdown语法，发送后自动渲染格式化结果
  • 历史记录按会话分组，点击即可回溯上下文

小技巧：在网页中输入 /help，可查看当前支持的所有指令，如 /model 查看当前模型、/session new 新建独立会话。

4. 多渠道接入实战：从微信到Telegram

4.1 企业微信接入（汉化版专属）

这是Clawdbot汉化版最具实用价值的功能——无缝嵌入企业办公流。

配置步骤（全程图形化，无命令行）
  1. 登录企业微信管理后台 → 「应用管理」→ 「自建应用」→ 「创建应用」
  2. 填写应用名称（如“AI智能助手”）、可见范围（建议选全公司）
  3. 在「接收消息」设置中：
    • 启用「接收消息」
    • URL填写：http://你的服务器IP:18789/wecom/webhook
    • Token：任意6-32位英文数字组合（如 wecom-ai-2024）
    • EncodingAESKey：点击「生成」按钮获取
  4. 保存后，复制「CorpID」和「Secret」
  5. 回到服务器终端，执行：
    cd /root/clawdbot
node dist/index.js wecom config \
  --corpid "wwxxxxxxxxxxxxxx" \
  --secret "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  --token "wecom-ai-2024" \
  --encoding-aes-key "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  6. 重启服务：bash /root/restart-gateway.sh
  7. 在企业微信客户端 → 工作台 → 找到刚创建的应用 → 点击进入 → 发送任意消息（如“你好”）

成功标志：网页控制台日志中出现 Received wecom message from USERID:xxx，且AI即时回复。

4.2 WhatsApp与Telegram配对（扫码即用）

虽然企业微信更适合国内团队，但WhatsApp和Telegram仍是国际协作高频场景。Clawdbot采用免Token直连模式，避免传统Bot开发的繁琐流程。

WhatsApp配对（实测30秒完成）
cd /root/clawdbot
node dist/index.js whatsapp pair

屏幕将显示一个动态刷新的二维码。此时：

  • 打开手机WhatsApp → 点击右上角「⋮」→ 「关联设备」
  • 对准扫描，无需额外登录或授权
  • 成功后终端显示 Connected! WhatsApp session saved.

关键优势：Clawdbot复用了WhatsApp官方Web客户端协议，不依赖第三方API，无封号风险，且支持群聊@提及触发。

Telegram配对（BotFather零门槛）
node dist/index.js telegram pair

终端会提示：

 请前往 https://t.me/BotFather
 发送 /newbot 创建机器人
 复制返回的 token（形如 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz）

粘贴token后，服务自动完成：

  • 注册Webhook到 http://你的服务器IP:18789/telegram/webhook
  • 设置欢迎消息与命令列表
  • 启用隐私模式（仅响应私聊与指定群组）

配对成功后，在Telegram搜索你的机器人名称，点击开始，即可对话。

5. 实用技巧与问题排查

5.1 模型性能调优：快与准的平衡术

Clawdbot默认使用ollama/llama3.1:8b，适合高质量输出，但对4GB内存机器可能卡顿。根据实际需求切换模型只需一条命令：

# 查看当前模型
cat /root/.clawdbot/clawdbot.json | jq '.agents.defaults.model.primary'

# 切换为极速响应模型（适合树莓派或老旧笔记本）
node dist/index.js config set agents.defaults.model.primary ollama/qwen2:0.5b

# 切换为均衡型模型（推荐大多数用户）
node dist/index.js config set agents.defaults.model.primary ollama/phi3:3.8b

# 切换为高精度模型（需8GB+内存）
node dist/index.js config set agents.defaults.model.primary ollama/llama3.1:8b

真实耗时对比（Intel i5-8250U, 16GB RAM）：

  • qwen2:0.5b：首字响应 < 1.2秒，适合日常问答
  • phi3:3.8b：首字响应 ~2.8秒，代码生成准确率提升40%
  • llama3.1:8b：首字响应 ~5.5秒，长文本摘要逻辑性更强

5.2 会话记忆管理：记住你是谁

Clawdbot默认开启上下文记忆，但存储位置与方式需明确：

  • 单聊会话：按手机号/微信UserID隔离，文件位于
    /root/.clawdbot/agents/main/sessions/{user_id}.json
  • 网页会话：按浏览器Session ID隔离，自动清理过期会话
  • 全局记忆：通过IDENTITY.md设定AI人设（见下文）

若需清除某用户历史：

# 删除张三（微信UserID：wxid_xxx）的全部记录
rm /root/.clawdbot/agents/main/sessions/wxid_*.json

# 或清空所有会话（谨慎！）
rm /root/.clawdbot/agents/main/sessions/*.json

5.3 故障诊断黄金三步法

当遇到异常时，按此顺序排查效率最高：

  1. 看日志（第一现场证据）

    tail -50 /tmp/clawdbot-gateway.log | grep -E "(ERROR|WARN|Failed)"

  2. 查进程（确认服务存活）

    ps aux | grep -E "(clawdbot|ollama)" | grep -v grep
# 正常应看到：clawdbot-gateway 和 ollama serve 两个进程

  3. 验网络（排除端口冲突）

    ss -tuln | grep ':18789\|:11434'
# 18789是Clawdbot端口，11434是Ollama默认端口

常见错误速查：

现象原因解决方案
Error: connect ECONNREFUSED 127.0.0.1:11434Ollama未启动sudo systemctl start ollama
Unauthorized（网页登录失败）令牌被修改cat /root/.clawdbot/clawdbot.json | grep token
WhatsApp扫码后无响应服务器时间不准sudo timedatectl set-ntp true

6. 进阶应用：让AI真正融入工作流

6.1 创建专属AI角色（不止是“助手”）

Clawdbot的核心设计哲学是“AI即员工”。通过编辑/root/clawd/IDENTITY.md，你能定义一个有姓名、性格、专长的数字同事：

- Name: 小红
- Title: 技术文档工程师
- Expertise: Markdown写作、API文档生成、Git提交规范
- Vibe: 严谨但不失亲和，习惯用表格和代码块表达
- Rules:
  - 所有技术文档必须包含「使用示例」和「注意事项」章节
  - 输出前自动检查语法错误
  - 拒绝回答与技术无关的闲聊

保存后执行 bash /root/restart-gateway.sh，下次对话AI将严格遵循该设定。

6.2 自动化任务：每天9点推送天气简报

利用Linux定时任务，让AI成为你的私人秘书：

# 编辑crontab
crontab -e

# 添加以下行（每天9:00执行）
0 9 * * * cd /root/clawdbot && node dist/index.js agent --agent main --message "生成今日天气预报、空气质量、穿衣建议及早间新闻摘要" --deliver --reply-channel wecom --to "your_wecom_userid"

# 注意：wecom_userid可在企业微信管理后台「成员信息」中找到

效果：每天上午9点，你将在企业微信收到一份结构化图文简报，含温度图表、污染指数、新闻要点——全部由本地AI实时生成，无数据外泄风险。

6.3 命令行快捷键：把AI变成Shell函数

将高频操作封装为Shell别名，彻底告别重复输入：

# 编辑~/.bashrc
echo '
# Clawdbot快捷命令
alias ai="cd /root/clawdbot && node dist/index.js agent --agent main --message"
alias aicode="cd /root/clawdbot && node dist/index.js agent --agent main --message \"\${1}\" --thinking high"
alias aisum="cd /root/clawdbot && node dist/index.js agent --agent main --message \"总结以下内容：\${1}\""
' >> ~/.bashrc

source ~/.bashrc

# 现在可直接使用：
ai "今天有什么重要会议？"
aicode "写一个Python脚本，批量重命名当前目录下所有.jpg文件为日期格式"
aisum "https://example.com/article"

7. 总结

Clawdbot汉化版的价值，从来不在“又一个AI聊天工具”的定位上。它是一套可审计、可定制、可嵌入的AI基础设施：

  • 企业微信入口让你绕过所有合规审批，当天部署当天使用；
  • Ollama本地模型确保数据不出内网，满足金融、医疗等强监管场景；
  • 网关架构设计支持横向扩展，未来可轻松接入更多渠道（如飞书、钉钉、Slack）；
  • 全中文配置与文档，让运维人员无需翻墙查英文手册。

真正的技术自由，不是拥有最新模型，而是掌握调度权、存储权和解释权。当你在企业微信里收到第一条由本地Qwen2生成的会议纪要时，你就已经站在了AI落地的正确起点上。

最后提醒三个关键路径：
🔹 模型管理：ollama list / ollama pull xxx
🔹 服务控制：sudo systemctl restart clawdbot-gateway
🔹 数据安全：定期执行 tar -czf backup-$(date +%Y%m%d).tar.gz /root/.clawdbot

获取更多AI镜像

想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。

# Ollama
Logo
乐奇 Rokid 开放社区

更多推荐

2026年9月16日 星期三 AI 日报

31.Meta推出个人Agent产品Muse：由闭源模型Muse Spark驱动，可通过独立应用、网页及WhatsApp交互，连接第三方服务、操作浏览器并后台持续执行任务，采用免费+20/100美元两档订阅，后续将接入Meta智能眼镜。22.国产AI编程工具全景成型：形成CLI终端、IDE插件、AI原生IDE、Web端、云端智能体、本地部署六种形态：Kimi Code、Trae、文心快码Comat

avatar 乐奇 Rokid 开放社区
cover

TestStar | AIUI 数据库客户端测试Case执行实录

avatar 乐奇 Rokid 开放社区
cover

AR巡检哪家好

avatar 乐奇 Rokid 开放社区