ChatClaw:轻量本地 AI 助手,聊天 + 执行双模式,隐私数据不上云

当大家还在为 AI 对话工具的隐私问题发愁时，一款名叫 ChatClaw 的开源本地 AI 助手悄悄上线了——不联网、不上报、本地跑，讯飞星火认知大模型加持，轻量到连树莓派都能带动。

ChatClaw 是什么？

ChatClaw 是基于讯飞星火认知大模型的轻量化本地 AI 助手，主打「隐私优先 + 轻量本地部署」。核心定位：

• 轻量化本地部署：单文件二进制，无需安装 Python/Node 环境，内存占用极低
• 聊天 + 执行双模式：既能对话聊天，也能执行本地指令、自动化任务
• 低资源占用：最低 512MB 内存即可运行，老旧设备也能带动
• 开源社区支持：MIT 协议开源，社区活跃，插件生态持续扩展
• 隐私优先：数据不离本地，支持完全离线运行

安装教程：三步跑起来

ChatClaw 的安装设计遵循「零门槛」原则，不需要任何编程基础。

① 下载二进制

前往 GitHub 发布页，根据你的系统选择对应版本：

② 配置讯飞 API Key

在讯飞开放平台（xfyun.cn）注册账号，创建应用获取以下三个凭证：

APPID = xxxxxxxx
API_KEY = xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
API_SECRET = xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

将三个值填入 config.yaml 或通过环境变量传入：

# Linux / macOS
export CHATCLAW_APPID=xxxxxxxx
export CHATCLAW_KEY=xxxxxxxx
export CHATCLAW_SECRET=xxxxxxxx

# Windows PowerShell
=”xxxxxxxx”

③ 运行

# 启动交互聊天模式
./chatclaw chat

# 启动任务执行模式
./chatclaw run –task “整理桌面文件并按日期分类”

# 完全离线模式（本地模型）
./chatclaw chat –offline

✅ 就这三步。没有 pip install，没有 npm，没有虚拟环境。

聊天 + 执行双模式详解

ChatClaw 最核心的设计是「聊天模式」与「执行模式」的无缝切换，一个助手，两种工作方式：

聊天模式（Chat Mode）

以自然语言交互为主，类似本地版 ChatGPT：

• 连续对话，支持多轮上下文记忆
• 文档问答：丢进去一个 PDF/TXT，直接追问内容
• 知识检索：基于本地知识库进行 RAG 检索增强
• 支持中文、英文、粤语等多语言交互

执行模式（Run Mode）

AI 主动调用本地工具完成任务，而不是被动回答：

• 文件操作：整理、重命名、搜索、归档
• Shell 指令：执行系统命令、脚本自动化
• 网络请求：爬取网页、调用 API、发送通知
• 代码生成 + 执行：写完直接跑，结果立即反馈

隐私优先：你的数据不离本地

市面上大多数 AI 助手的对话数据都会上传服务器用于训练，ChatClaw 的做法截然相反：

① 本地推理优先

配合量化小模型（如 Qwen2.5-3B、Phi-3-mini），ChatClaw 可在本地 CPU 完成推理，无需联网，对话内容永不离开你的设备。

② 云端调用明确隔离

当用户选择调用讯飞星火云端 API 时，ChatClaw 会明确提示：「本次对话将通过网络发送至讯飞服务器」，并支持用户在每次请求前确认，不存在静默上传。

③ 对话记录本地加密存储

历史对话以 AES-256 加密存储在本地 ~/.chatclaw/history/ 目录，只有你的账户可以读取，密钥不托管给任何第三方。

开源社区：插件生态持续扩展

ChatClaw 采用 MIT 开源协议，代码在 GitHub 完全公开，任何人都可以贡献插件或二次开发。目前社区已贡献的插件包括：

贡献插件只需遵循 ChatClaw Plugin API 规范，提交 PR 后社区会在 48 小时内完成审查。

写在最后

ChatClaw 不是要颠覆 ChatGPT，它只是想做好一件事：让每个人都能在自己的设备上，用上好用的 AI，且不用担心隐私问题。

在 AI 助手普遍云端化、数据集中化的今天，一个「数据不离本地」的选项显得尤为珍贵。

轻量、开源、隐私优先——ChatClaw 给出的答案是：AI 工具可以既强大，又不侵犯你的隐私。