又发现QClaw的“整活儿”方式了！

在AI时代，每个人都希望拥有一个能够理解自己、帮助自己的智能助手。而今天我要分享的，是一个超级实用的玩法——使用QClaw打造一个表情包AI Agent。

在开始之前，可能有些朋友会好奇：

作为OpenClaw的“亲民版”，QClaw和OpenClaw有什么关系？有什么区别？

简单来说，QClaw是基于OpenClaw核心框架打造的增强版本，它保留了OpenClaw强大的自动化能力和灵活的扩展架构，同时针对中国用户的使用习惯进行了深度优化。以下是QClaw相比OpenClaw的主要优势：

• 中文支持更原生：QClaw对中文语境的理解更加精准，无论是日常对话还是专业任务，都能给出更符合中文表达习惯的回答。

• 安装配置更简单：QClaw提供了一键安装脚本和环境自动检测功能，即使是技术小白也能轻松上手

• 生态整合更深度：QClaw针对国内常用平台进行了深度集成，配置更加便捷

• 社区资源更丰富：提供了大量中文教程和现成的Skill模板，学习成本大大降低

下面我们就来开始介绍我基于QClaw制作的AI Agent。

什么是表情包AI Agent？

你有没有遇到过这样的场景：和朋友聊天时，想找一个特别贴切的表情包来表达自己的心情，翻遍了整个表情库却怎么也找不到满意的？或者看到一张有趣的图片，想把它做成表情包却不知道从何下手？

请看下图：

表情工具箱就是为了解决这些问题而生的。简单来说，它是一个能够：

• 根据你的文字描述，智能匹配最合适的表情包
• 自动搜索和整理表情包资源

的智能助手。

配置与工作流程概述：

1）首先需要预定义好代理的功能，包括设置预设指令、提供输入框以及支持上传本地文件；

2）随后用户通过对话与代理进行交互；

3）代理则会按照用户提出的要求进行检索，并从 GitHub 仓库或网络搜索中返回相关信息。

而今天我们要使用的工具之一除了QClaw以外，还有GitHub上一个超火的表情包仓库——ChineseBQB（中文表情包库）。这个仓库收录了数以万计的中文表情包，涵盖各种场景、各种风格，简直就是表情包界的"百科全书"！

下面我向大家详细解释我是如何搭建起来这个表情工具箱的。

准备工作

1. 安装QClaw

首先，你需要在你的设备上安装QClaw。QClaw支持macOS、Windows，主要就是在官网下载相关的安装包：

https://qclaw.qq.com/

然后直接安装就可以了，安装完打开之后是这样的：

当然也可以通过按钮切换风格：

2. 新建并配置Agent

点击按钮创建Agent：

然后按照提示创建，我在这里输入的是:

按照以下信息修改你的identity和soul文件，修改后立即更新：你的名称是「表情工具箱」关于你的经历「拥有丰富的表情包库，可以查询到任何的表情包」，关于你的风格「有趣」

然后它就会按照要求生成：

生成完成：

3. 准备好知识库

# 克隆ChineseBQB仓库
git clone https://github.com/zhaoolee/ChineseBQB.git

clone完成后记下它的目录，可以把没用的zip文件删除掉，因为QClaw目前还不能读取压缩文件夹中的内容。

4. 根据准备好知识库进行多轮调试

我第一次让它去帮我下载表情包到本地：

然后再跟它说后续的操作流程：

甚至还可以给它提出性能要求：

5. 直接接入微信

有小伙伴可能会问：可不可以直接让它把表情包发到我微信上？

答案是可以的。

就在QClaw的MacOS最新版（v0.2.8）就支持了选择Agent绑定微信，大家可以在这里设置：

然后就可以直接使用微信对话了：

这样是不是很方便了。

补充一下QClaw的知识

QClaw同OpenClaw一样有工作目录的概念。

QClaw的工作目录（workspace）是指Agent专用的文件操作和上下文处理的核心区域，可以理解为Agent的“家”或主要工作环境。

默认情况下，工作目录位于~/.qclaw/workspace，这里包含了AGENTS.md、SOUL.md、USER.md等引导文件，它们定义了Agent的身份、人格、操作规则和记忆内容，在每次会话开始时被加载。

需要注意的是，工作目录与存储配置、凭证和会话的~/.qclaw/目录是分开的，而且它本身并不是一个严格的沙箱环境——Agent仍可通过绝对路径访问主机上的其他位置，因此建议将敏感文件移出工作区，或根据需要启用沙箱隔离来增强安全性。

那么我就来解释一下这些文件和目录都有什么作用：

这些文件与目录位于 OpenClaw 的工作区（workspace）中，主要用于定义 Agent 的身份、行为、记忆和任务数据。下面逐一解释它们的作用以及何时可以修改。

核心身份与行为定义文件（建议谨慎修改）

文件	作用	修改建议
AGENTS.md	Agent 的核心指令文件，定义其角色、任务流程、工具使用规则等。每次会话启动时自动加载。	✅ 可修改：根据需求调整 Agent 的行为逻辑。注意保持 Markdown 格式。
SOUL.md	描述 Agent 的“人格”与语气，比如幽默、正式、简洁等。影响回复风格。	✅ 可修改：想让 Agent 更“懂你”时可以改写。
USER.md	记录用户的偏好、常用表达、历史习惯等，供 Agent 学习并个性化响应。	✅ 可修改：手动添加你的喜好，或让 Agent 自动更新。
IDENTITY.md	定义 Agent 的身份标识（名称、版本、用途等）。	⚠️ 一般不需要修改，除非你希望改变 Agent 的自我描述。
TOOLS.md	列出 Agent 可以调用的工具（如文件读写、下载器、搜索等）及其参数说明。	✅ 可修改：添加或限制可用工具。需确保工具已在系统中实现。
MEMORY.md	长期记忆文件，存储重要事实、用户历史交互摘要。	⚠️ 通常由 Agent 自动读写，不建议手动编辑（可能破坏记忆结构）。
HEARTBEAT.md	记录 Agent 的活跃状态、最后运行时间或健康检查信息。	❌ 不建议修改，由系统自动维护。

数据与索引文件（通常由 Agent 或脚本生成，谨慎手动修改）

文件 / 目录	作用	修改建议
memory/ 目录	存储结构化记忆数据（可能是向量数据库片段或对话历史快照）。	❌ 不建议直接修改，除非你熟悉内部格式。
bqb_index.json	表情包索引文件，记录表情包关键词、路径、使用频率等。	⚠️ 可手动编辑（例如批量导入），但注意 JSON 格式。
.bqb_index_17761	可能是临时索引缓存或分片文件（数字为进程 ID 或时间戳）。	❌ 不建议修改，通常由程序自动管理。
62140.json	单个表情包的元数据（如标签、来源、下载链接）。	⚠️ 可修改，但需要符合 JSON 结构。
.consolidate-state.json	状态合并的临时文件，用于记录索引合并进度。	❌ 不建议修改，可能破坏状态一致性。
sticker-downloader.py / .sh	Python 和 Shell 脚本，用于下载表情包资源。	✅ 可修改：根据你的数据源调整下载逻辑。
task-summary...8-37.md	某个任务执行后的总结报告（时间戳或哈希后缀）。	✅ 可读可删，不影响 Agent 核心功能。

总结：什么情况下可以修改？

可以放心修改：AGENTS.md, SOUL.md, USER.md, TOOLS.md, sticker-downloader.py/.sh, 以及任何 *.md 总结文件。

可以小心修改（保持 JSON 结构）：bqb_index.json, 62140.json。

不建议手动修改：memory/ 目录、.consolidate-state.json、.bqb_index_*、HEARTBEAT.md、MEMORY.md。

禁止手动修改：.openclaw/ 下的内部状态文件（除非你完全清楚后果）。

修改前先备份原文件。如果你不确定某个文件的作用，可以先在 AGENTS.md 中询问 Agent 本身：“这个文件是做什么的？我可以修改吗？”

总结

通过今天的分享，相信大家已经掌握了如何使用 QClaw 快速搭建一个专属于自己的表情包 AI Agent。这个 Agent 不仅能帮你从海量表情包中秒速找到最合适的那一张，告别翻相册、搜关键词的繁琐操作；还能在日复一日的互动中，悄悄学习你的表达偏好和常用风格，变得越来越“懂你”——比如你爱用“捂脸”表示无奈，或者用“狗头”表达反讽，它都会记在心里，下次自动优先推荐。未来，无论是群聊斗图、工作吐槽，还是日常闲聊，你都可以把这个 Agent 当作你的专属表情搭档，让沟通更生动、更有趣。快去试试吧，打造一个真正“懂你”的表情包助手，从今天开始！