Clawdbot 汉化镜像：预集成 Ollama 与 WebUI，本地 AI 助手部署指南

出现有效 content → 底层模型调用通 model 显示具体模型名 → Ollama 已正确挂载 无报错、无超时 → 网络与权限配置正常

这一步通过，代表整个技术栈——Ollama（推理引擎）+ Clawdbot（通信胶水）+ WebUI（交互界面）——已形成闭环。

三种对话方式，按需选择

Clawdbot 提供了三层交互入口：极简命令行、主流消息平台、可视化网页。它们不是并列选项，而是递进式体验设计。

终端直连：调试与快速验证的首选

这是最轻量、最透明的方式，适合开发者、运维人员或想第一时间验证模型效果的用户。

基础问答（无需上下文）

# 问天气、查定义、写诗句，一句话搞定
node dist/index.js agent --agent main --message "用 Python 写一个计算斐波那契数列前 20 项的函数"

# 加上 --json 参数，获得程序可解析的纯结构化输出
node dist/index.js agent --agent main --message "列出中国五大淡水湖及面积" --json 

控制思考深度：从'快答'到'深思'

AI 不是只有一个模式。Clawdbot 允许你按需调节它的'脑力分配'：

# 极速模式：适合闲聊、查词、简单指令（<1 秒）
node dist/index.js agent --agent main --message "今天星期几？" --thinking minimal

# 平衡模式：日常办公主力（2–5 秒，推荐新手默认）
node dist/index.js agent --agent main --message "帮我润色这段产品描述，让它更吸引年轻用户" --thinking medium

# 深度模式：架构设计、长文生成、复杂逻辑推演（10 秒+，需耐心）
node dist/index.js agent --agent main --message "设计一个支持千万级用户的短链服务，要求高并发、低延迟、可追溯" --thinking high 

小贴士：首次使用建议先用 --thinking medium，熟悉响应风格后再按需调整。high 模式对 qwen2:0.5b 这类小模型压力较大，易出现卡顿，此时可换用 phi3:3.8b 或 llama3.1:8b。

消息平台接入：让 AI 成为你的'数字同事'

这才是 Clawdbot 的核心功能——它把 AI 变成了你通讯录里的一个真实联系人。

企业微信（新增汉化专属入口）

企业微信是国内团队最常用的协同工具，Clawdbot 汉化版为此做了深度适配：

1. 打开企业微信管理后台 → '应用管理' → '自建应用' → 创建新应用
2. 获取 AgentId、Secret、CorpId，粘贴至终端提示处
3. 启动后，管理员在「工作台」即可看到'AI 助手'应用，成员点击即可发起私聊

在服务器终端执行：

cd /root/clawdbot node dist/index.js wecom pair 

优势在于：支持企业微信全部特性——消息已读回执、会话存档（需开通）、审批流对接、甚至可嵌入微文档评论区。

WhatsApp / Telegram：国际协作无缝衔接

配置流程高度自动化，以 WhatsApp 为例：

# 一行命令启动配对向导
node dist/index.js whatsapp pair 

终端会生成一个动态二维码。用手机 WhatsApp → 设置 → 关联设备 → 扫描，10 秒内完成绑定。之后，你只需在 WhatsApp 中给这个'账号'发消息，AI 就会实时回复，支持图片识别、PDF 解析、多轮追问。

Telegram 同理，但更轻量：node dist/index.js telegram pair 后，按 BotFather 指引创建 bot，复制 token 粘贴即可。它会自动成为你 Telegram 中的一个机器人，支持 /ask 斜杠命令，也支持直接对话。

WebUI 网页控制台：非技术人员的友好入口

不需要记命令、不用开终端，打开浏览器就能用。

1. 在任意设备浏览器中访问：http://你的服务器 IP:18789
2. 输入令牌：dev-test-token（首次使用请勿修改）
3. 进入后，界面左侧是会话列表，右侧是聊天窗口，顶部有模型切换、思考深度滑块、历史清空按钮

WebUI 不仅是聊天界面，更是配置中心：

• 点击右上角齿轮图标，可修改默认模型、调整温度（temperature）、设置系统提示词（system prompt）
• '会话管理'页可导出某次完整对话为 Markdown 或 JSON
• '日志查看'页实时显示 gateway 和 agent 的原始日志流，比 tail -f 更直观

对运营、产品、客服等非技术岗位来说，这是最快上手、最不易出错的方式。

连接微信/WhatsApp/Telegram：实操避坑指南

虽然配置步骤简洁，但新手常在细节处卡住。以下是三个平台最典型的'踩坑点'与解决方案。

WhatsApp：二维码扫不出？试试这三招

• ❌ 错误操作：用 WhatsApp Business 扫普通 WhatsApp 生成的码
• 正解：确保手机端是 标准版 WhatsApp（非 Business 版），且已登录主账号
• ❌ 错误操作：扫描后提示'此二维码已过期'
• 正解：终端保持 node dist/index.js whatsapp pair 命令持续运行，不要关闭；若超时，重新执行该命令生成新码
• ❌ 错误操作：连接成功但收不到回复
• 正解：检查 /root/.clawdbot/clawdbot.json 中 whatsapp.enabled 是否为 true，并确认 ollama list 中模型名称拼写无误（如 qwen2:1.5b 不是 qwen2:15b）

Telegram：BotFather 返回的 token 总是无效？

• 关键检查点：token 格式必须是 123456789:ABCdefGHIjklMNOpqrsTUVwxyz（含冒号，前后无空格）
• 必须操作：在 BotFather 中发送 /setprivacy → 选择你的 bot → 设为 Disable（否则 bot 无法接收群聊消息）
• 高级技巧：如需在群组中使用，需将 bot 添加为管理员，并开启'允许编辑消息'权限，这样 AI 回复才能带引用原文

企业微信：消息发出去但没回复？

• 核心排查：登录企业微信管理后台 → '应用管理' → 找到你创建的'AI 助手'应用 → 检查「可信域名」是否添加了你的服务器 IP 或域名（格式如 http://192.168.1.100:18789）
• 必须操作：在应用详情页 → 「接收消息」→ 开启'接收消息'和'发送消息'权限
• 安全提示：首次启用后，建议在「客户联系」中设置'仅指定成员可使用'，避免全员误触

常用问题解决：高频故障的'一键答案'

遇到问题，先别慌着重装。90% 的状况，用下面这几条命令就能定位并修复。

服务突然'失联'了？

现象：微信发消息无响应，WebUI 打不开，终端命令报 ECONNREFUSED 根因：gateway 进程崩溃或被系统 kill 速修命令：

# 查看进程状态
ps aux | grep clawdbot-gateway

# 若无结果，强制重启
bash /root/restart-gateway.sh

# 检查重启后日志末尾是否有 "Gateway started on port 18789"
tail -n 20 /tmp/clawdbot-gateway.log 

AI 回复慢得像蜗牛？

现象：发送消息后等待超过 15 秒才有回复 根因：模型过大 + 硬件资源不足（尤其显存） 诊断命令：

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

# 查看 Ollama 内存占用
ollama ps 

优化方案（任选其一）：

# 方案 1：换轻量模型（推荐立即生效）
node dist/index.js config set agents.defaults.model.primary ollama/qwen2:0.5b

# 方案 2：限制 Ollama 显存（NVIDIA GPU 用户）
echo 'export OLLAMA_NUM_GPU=1' >> /etc/profile.d/ollama.sh
source /etc/profile.d/ollama.sh 

想换个人设，但改完没生效？

现象：修改了 /root/clawd/IDENTITY.md，重启后 AI 还是老样子 关键动作：Clawdbot 不会热加载身份文件，必须重启 gateway 才能读取新配置 正确流程：

# 1. 编辑身份文件
nano /root/clawd/IDENTITY.md

# 2. 保存退出

# 3. 重启服务（不是 reload，是 restart）
bash /root/restart-gateway.sh

# 4. 发送测试消息验证
node dist/index.js agent --agent main --message "你是谁？" 

忘记了 WebUI 密码？

现象：浏览器打不开，或输入 dev-test-token 提示错误 真相：dev-test-token 是默认令牌，但可能被手动修改过 找回命令：

# 直接读取配置文件中的 auth.token 字段
jq -r '.auth.token' /root/.clawdbot/clawdbot.json 

如果返回 null，说明配置损坏，可临时重置：

# 备份原配置
cp /root/.clawdbot/clawdbot.json /root/.clawdbot/clawdbot.json.bak

# 写入默认令牌
jq '.auth.token = "dev-test-token"' /root/.clawdbot/clawdbot.json > tmp.json && mv tmp.json /root/.clawdbot/clawdbot.json
bash /root/restart-gateway.sh 

总结：为什么这个镜像值得长期使用

Clawdbot 汉化版镜像的价值，不在于它'能做什么'，而在于它'省掉了什么'。

它省掉了：

• ✦ 反复查阅 Ollama 文档配置 GPU 参数的时间
• ✦ 在 GitHub 上逐行比对 Clawdbot 配置项的焦虑
• ✦ 为 WebUI 调试 Nginx 反向代理的深夜
• ✦ 担心聊天记录被上传到第三方服务器的顾虑

它交付的是：

• ✦ 一个开箱即用的、符合中文使用习惯的 AI 协作终端
• ✦ 一套可随业务增长平滑升级的技术底座（换模型、加渠道、扩集群）
• ✦ 一份真正属于你的 AI 资产——数据、配置、工作流，全部可控、可审计、可迁移

从今天开始，你不需要再'学习如何用 AI'，而是直接'用 AI 去工作'。无论是写一封邮件、生成一份周报、分析一张销售图表，还是在企业微信里为新员工自动解答入职问题——Clawdbot 就在那里，安静、可靠、永远在线。