一键部署Clawdbot：打造属于你的24小时在线AI助手

1. 为什么你需要一个“在微信里就能用”的AI助手？

你有没有过这样的时刻：

• 想快速查个技术问题，却懒得打开浏览器、登录网页、复制粘贴——只希望在微信对话框里敲一句就得到答案；
• 客户在企业微信里发来一长段需求文档，你一边开会一边想：“要是能自动总结重点就好了”；
• 团队用Telegram同步项目进展，突然需要把会议纪要转成英文发给海外同事，但手头没有顺手的工具；
• 明明本地有Qwen2、Phi3这些轻量又聪明的模型，却只能靠命令行调用，没法真正“嵌入工作流”。

Clawdbot 就是为这些真实场景而生的。它不是另一个需要注册、充值、等审核的SaaS服务，而是一个完全运行在你本地设备上的AI网关——安装一次，开机自启，微信/企微/WhatsApp/Telegram全平台接入，所有聊天记录只存你硬盘，不上传、不联网、不依赖任何云服务。

更重要的是：它已经为你预装了汉化界面、企业微信入口和开箱即用的配置。你不需要懂Node.js原理，也不用研究Ollama参数，只要三步：启动、配对、发送消息——你的24小时AI助手就上线了。

这不是概念演示，而是可立即投入日常使用的生产力工具。接下来，我会带你从零开始，完成部署、连接、调优到进阶应用的全过程。

2. 快速启动：5分钟让Clawdbot跑起来

2.1 确认服务状态（第一眼判断是否就绪）

打开终端，执行：

ps aux | grep clawdbot-gateway

如果看到类似输出，说明服务已在后台运行：

root     133175  0.8  2.1 1245678 89234 ?    Ssl  10:23   0:04 /usr/bin/node /root/clawdbot/dist/index.js gateway

表示一切正常，可跳至第3节直接测试对话。
若无结果或提示command not found，请继续执行以下启动命令：

bash /root/start-clawdbot.sh

该脚本会自动检查依赖、加载配置、启动网关服务，并设置开机自启。整个过程约10–20秒，无需人工干预。

小贴士：/root/start-clawdbot.sh 是镜像预置的智能启动器，它会自动识别你是否已安装Ollama、是否已有默认模型，并在缺失时给出清晰提示，而不是报错退出。

2.2 本地终端对话测试（验证核心能力）

进入Clawdbot目录并发送第一条消息：

cd /root/clawdbot
node dist/index.js agent --agent main --message "你好，我是第一次使用Clawdbot"

几秒后，你应该看到类似这样的结构化响应：

{
  "session_id": "a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8",
  "response": "你好！很高兴认识你～我是你的本地AI助手，所有对话都只存在你的电脑上。你可以问我技术问题、写代码、总结文档，甚至帮你润色邮件。需要我做什么？😊",
  "model": "ollama/qwen2:1.5b",
  "thinking_level": "medium"
}

响应中包含 session_id（用于多轮记忆）、model（当前所用模型）、thinking_level（思考深度），说明底层推理链路已打通。
若提示 Error: model not found，请先执行 ollama list 查看已安装模型，或参考第5节下载轻量模型。

3. 三种对话方式：选最适合你工作习惯的一种

Clawdbot支持三种交互路径，它们不是互斥选项，而是按需组合的协作模式：

方式	适用场景	启动成本	隐私性	推荐指数
终端直连	快速调试、批量任务、自动化脚本	☆☆☆☆（零配置）	（纯本地）	☆
网页控制台	临时查看、多账号切换、非技术人员试用	☆☆☆（需记IP+令牌）	☆（仅HTTP本地访问）	☆
即时通讯接入	日常办公、客户对接、团队协同	☆（需扫码/填Token）	（消息走本地网关，不经过第三方服务器）

下面分别展开实操要点。

3.1 终端直连：最简、最可控的调用方式

所有命令均以 node dist/index.js agent 开头，核心参数如下：

• --agent main：指定主AI代理（你可配置多个角色，如“技术顾问”“文案助手”）
• --message "xxx"：你要提问的内容
• --thinking [level]：控制AI思考深度（见下表）
• --json：强制返回JSON格式，方便程序解析

思考深度对照表（直接影响响应质量与耗时）

参数值	响应特点	典型用途	平均耗时（Qwen2:1.5b）
off	直接查缓存或模板回复	“你好”“再见”类问候	<0.2s
minimal	单步推理，不展开	天气查询、单位换算	0.3–0.6s
low	简单逻辑链，1–2步推导	写Python函数、改错别字	0.7–1.2s
medium（默认）	中等复杂度，含上下文理解	总结长文本、生成周报	1.3–2.5s
high	多步推理、自我验证、结构化输出	架构设计、代码审计、论文润色	3.0–6.0s

实战示例：

# 快速查Linux命令（minimal）
node dist/index.js agent --agent main --message "如何查看当前占用CPU最高的前5个进程？" --thinking minimal

# 深度写代码（high）
node dist/index.js agent --agent main \
  --message "用Python写一个CLI工具：接收文件路径，统计其中Python代码行数（排除空行、注释行），支持递归扫描子目录" \
  --thinking high \
  --json

提示：将常用命令设为别名（见第6节“高级技巧”），比如 ai "帮我写Dockerfile"，效率提升立竿见影。

3.2 网页控制台：可视化操作，零命令基础

在浏览器中访问：
http://你的服务器IP:18789

输入网关令牌：dev-test-token（镜像预置，无需修改）

你会看到一个简洁的对话界面，左侧是会话列表（自动保存历史），右侧是实时聊天窗口。所有操作均通过HTTP请求本地clawdbot-gateway服务完成，不涉及任何外部API调用。

关键能力：

• 点击任意历史会话可继续上下文对话（AI自动关联session_id）
• 右上角「设置」可切换模型、调整温度（temperature）、启用/禁用记忆
• 支持Markdown渲染，代码块自动高亮
• 导出当前会话为.md文件，方便归档或分享

注意：该页面仅监听localhost和服务器局域网IP，不会暴露到公网。若需外网访问，请自行配置反向代理+HTTPS+身份认证（不在本镜像默认范围内，保障隐私优先）。

3.3 即时通讯接入：把AI“装进”你每天打开10次的App

Clawdbot原生支持四大平台：企业微信（本次镜像重点增强）、WhatsApp、Telegram、Discord。我们以企业微信为例，说明其独特优势：

• 无需手机扫码：企业微信管理后台可直接获取corpid和corpsecret，服务端静默鉴权
• 支持应用消息推送：AI可主动向指定成员/部门发送日报、告警、待办提醒
• 消息加解密支持：符合企业微信安全规范，防止中间人窃听
• 会话存档兼容：可对接企业微信会话存档API，满足合规审计要求

企业微信接入步骤（3分钟完成）

1. 登录企业微信管理后台 → 「应用管理」→ 「创建应用」
2. 填写应用名称（如“Clawdbot助手”），保存后获取：
   • corpid（企业ID，形如 ww1234567890abcdef）
   • corpsecret（应用密钥，形如 AbC123DeF456GhI789JkL012MnO345PqR）
3. 在服务器终端执行：

cd /root/clawdbot
node dist/index.js wecom pair --corpid "ww1234567890abcdef" --corpsecret "AbC123DeF456GhI789JkL012MnO345PqR"

4. 看到 Wecom app configured successfully 即表示接入成功。
5. 打开企业微信APP → 搜索应用名称 → 进入后即可开始对话。

安全说明：corpid和corpsecret仅存储于/root/.clawdbot/clawdbot.json，文件权限为600（仅root可读），且未硬编码在任何JS源码中。

其他平台（WhatsApp/Telegram/Discord）配置逻辑一致，均采用pair子命令引导，全程交互式提示，杜绝配置错误。

4. 模型调优：让AI既快又准，适配你的硬件

Clawdbot默认使用ollama/qwen2:1.5b，这是一个在消费级显卡（如RTX 3060）上可流畅运行、中文理解强、响应快的平衡之选。但你完全可以根据实际需求切换：

4.1 查看与切换模型

# 查看已安装模型
ollama list

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

# 切换为高质量模型（需GPU显存≥8GB）
node dist/index.js config set agents.defaults.model.primary ollama/llama3.1:8b

# 立即生效（无需重启网关）
node dist/index.js config reload

4.2 模型选择指南（基于实测效果）

模型	适用场景	CPU占用	GPU显存需求	中文能力	推荐硬件
qwen2:0.5b	快速问答、指令执行、日程提醒	低	无	★★★★☆	4核CPU+8GB内存
qwen2:1.5b	文档总结、代码生成、多轮对话	中	≥4GB	★★★★★	RTX 3060及以上
phi3:3.8b	技术文档解读、逻辑推理、SQL生成	中高	≥6GB	★★★★☆	RTX 4070及以上
llama3.1:8b	高质量创作、多语言翻译、复杂架构设计	高	≥10GB	★★★★	A10/A100云实例

提示：所有模型均通过ollama pull下载，国内用户建议配置Ollama镜像源（如清华源），加速下载。命令：
export OLLAMA_HOST=https://ollama.mirrors.ustc.edu.cn
ollama pull qwen2:1.5b

5. 数据安全与隐私控制：你的数据，你做主

Clawdbot的设计哲学是：AI可以很强大，但绝不以牺牲隐私为代价。所有数据均遵循“本地存储、明确授权、最小留存”原则。

5.1 数据存储位置一览（全部位于/root目录下）

类型	路径	说明	是否加密
配置文件	/root/.clawdbot/clawdbot.json	包含网关令牌、各平台密钥、模型路径	（文件权限600）
对话历史	/root/.clawdbot/agents/main/sessions/	按session_id分文件存储，JSON格式	（可手动加密）
日志文件	/tmp/clawdbot-gateway.log	实时运行日志，循环覆盖（默认保留7天）	（敏感信息已脱敏）
身份设定	/root/clawd/IDENTITY.md	AI人设描述（姓名、性格、头像路径）
备份存档	/root/clawdbot-backup-*.tar.gz	全量备份（含配置+会话）	（建议传输时加密）

5.2 主动管理数据的实用命令

# 查看最近10条对话（快速确认内容）
jq -r '.messages[-10:][] | "\(.role): \(.content)"' /root/.clawdbot/agents/main/sessions/sessions.json 2>/dev/null | head -10

# 清空当前会话（保留其他会话）
rm /root/.clawdbot/agents/main/sessions/sessions.json

# 彻底重置（删除所有会话+配置，恢复出厂）
rm -rf /root/.clawdbot/agents/main/sessions/
rm -f /root/.clawdbot/clawdbot.json
bash /root/restart-gateway.sh

# 创建加密备份（需提前安装gpg）
tar -czf - /root/.clawdbot /root/clawd | gpg -c > clawdbot-secure-backup-$(date +%Y%m%d).tar.gz.gpg

重要提醒：Clawdbot不收集、不上报、不分析任何用户数据。所有网络请求（如Ollama模型拉取、Telegram BotFather交互）均由你主动触发，服务端无埋点、无遥测、无心跳上报。

6. 高级技巧：让Clawdbot真正融入你的工作流

6.1 创建终端快捷命令（告别长路径）

编辑~/.bashrc，添加：

# Clawdbot快捷命令（支持中文参数）
alias ai='cd /root/clawdbot && node dist/index.js agent --agent main --message'
alias aifast='cd /root/clawdbot && node dist/index.js agent --agent main --message "$1" --thinking low'
alias aideep='cd /root/clawdbot && node dist/index.js agent --agent main --message "$1" --thinking high'
alias ailist='ollama list'

# 生效配置
source ~/.bashrc

之后即可直接使用：

ai "帮我把这段SQL改成带注释的版本"
aifast "今天北京天气"
aideep "设计一个支持并发的Redis分布式锁方案"

6.2 设置定时任务：AI自动为你打工

例如，每天上午9点向企业微信发送工作日报：

# 编辑crontab
crontab -e

# 添加一行（每天9:00执行）
0 9 * * * cd /root/clawdbot && node dist/index.js agent --agent main --message "生成今日工作日报（含昨日完成、今日计划、风险项）" --deliver --reply-channel wecom --to "张三,李四" >> /var/log/clawdbot-daily.log 2>&1

--deliver 表示触发消息推送，--reply-channel wecom 指定渠道，--to 支持用户名/部门ID/标签，精准触达。

6.3 多轮对话与上下文记忆

Clawdbot默认开启会话记忆，但你也可以显式控制：

# 方式1：指定会话ID（精确控制记忆范围）
SESSION_ID=$(uuidgen)
node dist/index.js agent --agent main --session-id $SESSION_ID --message "我的项目叫‘星图计划’，目标是构建AI镜像分发平台"
node dist/index.js agent --agent main --session-id $SESSION_ID --message "为这个项目写一份技术架构图描述"

# 方式2：绑定手机号/微信号（自动关联用户）
node dist/index.js agent --agent main --to "138****1234" --message "我是王五，负责后端开发"
# 后续所有发给138****1234的消息，AI都会记住“王五”身份

7. 故障排查：80%的问题，3条命令就能解决

遇到问题，按此顺序排查，90%可快速定位：

7.1 查看实时日志（第一线索）

tail -f /tmp/clawdbot-gateway.log

重点关注 [ERROR] 和 [WARN] 行。常见提示如：

• Failed to connect to Ollama: connect ECONNREFUSED 127.0.0.1:11434 → Ollama未启动，执行 ollama serve
• Invalid token for Telegram → Token填写错误，重新执行 node dist/index.js telegram pair
• Model 'xxx' not found → 模型未下载，执行 ollama pull xxx

7.2 检查服务进程（确认存活）

ps aux | grep -E "(clawdbot|ollama)"

应至少看到两个进程：

• clawdbot-gateway（主服务）
• ollama serve（模型服务）

若缺失后者，手动启动：ollama serve &

7.3 重启服务（终极软复位）

bash /root/restart-gateway.sh

该脚本会：

1. 杀死所有clawdbot相关进程
2. 清理临时文件（/tmp/clawdbot-*）
3. 重新加载配置
4. 启动网关服务
5. 输出最终状态（ Running 或 Failed with reason）

官方支持渠道：

• 文档：https://docs.clawd.bot
• GitHub Issues：https://github.com/clawdbot/clawdbot/issues
• Discord社区：https://discord.gg/clawd（开发者实时答疑）

8. 总结：你的AI助手，现在真正属于你了

回顾整个部署过程，你实际上完成了三件关键事：

• 掌控权回归：AI不再是一个黑盒SaaS，而是你服务器上的一个进程，配置、模型、数据全部由你定义；
• 工作流无缝嵌入：从微信里的随手一问，到终端里的批量处理，再到企业微信的自动日报，AI成为你数字工作空间的自然延伸；
• 隐私与效率不再二选一：无需在“用得爽”和“数据安不安全”之间妥协，Clawdbot证明了本地化AI同样可以强大、易用、可靠。

这并非终点，而是起点。你可以：

• 用IDENTITY.md给AI设定专属人设，让它成为你的技术合伙人；
• 用crontab让它每天凌晨自动训练新知识；
• 用--json输出对接你的内部CRM系统；
• 甚至把它封装成Docker服务，一键部署到公司内网。

真正的AI生产力，不在于参数多大、榜单多高，而在于它是否愿意安静地待在你的电脑里，随时准备帮你把想法变成现实。

---

获取更多AI镜像

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