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

在AI时代,每个人都希望拥有一个能够理解自己、帮助自己的智能助手。而今天我要分享的,是一个超级实用的玩法——使用QClaw打造一个表情包AI Agent。
在开始之前,可能有些朋友会好奇:
作为OpenClaw的“亲民版”,QClaw和OpenClaw有什么关系?有什么区别?
简单来说,QClaw是基于OpenClaw核心框架打造的增强版本,它保留了OpenClaw强大的自动化能力和灵活的扩展架构,同时针对中国用户的使用习惯进行了深度优化。以下是QClaw相比OpenClaw的主要优势:

下面我们就来开始介绍我基于QClaw制作的AI Agent。
你有没有遇到过这样的场景:和朋友聊天时,想找一个特别贴切的表情包来表达自己的心情,翻遍了整个表情库却怎么也找不到满意的?或者看到一张有趣的图片,想把它做成表情包却不知道从何下手?
请看下图:

表情工具箱就是为了解决这些问题而生的。简单来说,它是一个能够:
的智能助手。
配置与工作流程概述:
1)首先需要预定义好代理的功能,包括设置预设指令、提供输入框以及支持上传本地文件;
2)随后用户通过对话与代理进行交互;
3)代理则会按照用户提出的要求进行检索,并从 GitHub 仓库或网络搜索中返回相关信息。
而今天我们要使用的工具之一除了QClaw以外,还有GitHub上一个超火的表情包仓库——ChineseBQB(中文表情包库)。这个仓库收录了数以万计的中文表情包,涵盖各种场景、各种风格,简直就是表情包界的"百科全书"!

下面我向大家详细解释我是如何搭建起来这个表情工具箱的。
首先,你需要在你的设备上安装QClaw。QClaw支持macOS、Windows,主要就是在官网下载相关的安装包:
https://qclaw.qq.com/然后直接安装就可以了,安装完打开之后是这样的:

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

点击按钮创建Agent:

然后按照提示创建,我在这里输入的是:
按照以下信息修改你的identity和soul文件,修改后立即更新:你的名称是「表情工具箱」关于你的经历「拥有丰富的表情包库,可以查询到任何的表情包」,关于你的风格「有趣」然后它就会按照要求生成:

生成完成:

# 克隆ChineseBQB仓库
git clone https://github.com/zhaoolee/ChineseBQB.gitclone完成后记下它的目录,可以把没用的zip文件删除掉,因为QClaw目前还不能读取压缩文件夹中的内容。
我第一次让它去帮我下载表情包到本地:

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

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

有小伙伴可能会问:可不可以直接让它把表情包发到我微信上?
答案是可以的。
就在QClaw的MacOS最新版(v0.2.8)就支持了选择Agent绑定微信,大家可以在这里设置:

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

这样是不是很方便了。
QClaw同OpenClaw一样有工作目录的概念。
QClaw的工作目录(workspace)是指Agent专用的文件操作和上下文处理的核心区域,可以理解为Agent的“家”或主要工作环境。
默认情况下,工作目录位于~/.qclaw/workspace,这里包含了AGENTS.md、SOUL.md、USER.md等引导文件,它们定义了Agent的身份、人格、操作规则和记忆内容,在每次会话开始时被加载。

需要注意的是,工作目录与存储配置、凭证和会话的~/.qclaw/目录是分开的,而且它本身并不是一个严格的沙箱环境——Agent仍可通过绝对路径访问主机上的其他位置,因此建议将敏感文件移出工作区,或根据需要启用沙箱隔离来增强安全性。
那么我就来解释一下这些文件和目录都有什么作用:
这些文件与目录位于 OpenClaw 的工作区(workspace)中,主要用于定义 Agent 的身份、行为、记忆和任务数据。下面逐一解释它们的作用以及何时可以修改。
文件 | 作用 | 修改建议 |
|---|---|---|
| Agent 的核心指令文件,定义其角色、任务流程、工具使用规则等。每次会话启动时自动加载。 | ✅ 可修改:根据需求调整 Agent 的行为逻辑。注意保持 Markdown 格式。 |
| 描述 Agent 的“人格”与语气,比如幽默、正式、简洁等。影响回复风格。 | ✅ 可修改:想让 Agent 更“懂你”时可以改写。 |
| 记录用户的偏好、常用表达、历史习惯等,供 Agent 学习并个性化响应。 | ✅ 可修改:手动添加你的喜好,或让 Agent 自动更新。 |
| 定义 Agent 的身份标识(名称、版本、用途等)。 | ⚠️ 一般不需要修改,除非你希望改变 Agent 的自我描述。 |
| 列出 Agent 可以调用的工具(如文件读写、下载器、搜索等)及其参数说明。 | ✅ 可修改:添加或限制可用工具。需确保工具已在系统中实现。 |
| 长期记忆文件,存储重要事实、用户历史交互摘要。 | ⚠️ 通常由 Agent 自动读写,不建议手动编辑(可能破坏记忆结构)。 |
| 记录 Agent 的活跃状态、最后运行时间或健康检查信息。 | ❌ 不建议修改,由系统自动维护。 |
文件 / 目录 | 作用 | 修改建议 |
|---|---|---|
| 存储结构化记忆数据(可能是向量数据库片段或对话历史快照)。 | ❌ 不建议直接修改,除非你熟悉内部格式。 |
| 表情包索引文件,记录表情包关键词、路径、使用频率等。 | ⚠️ 可手动编辑(例如批量导入),但注意 JSON 格式。 |
| 可能是临时索引缓存或分片文件(数字为进程 ID 或时间戳)。 | ❌ 不建议修改,通常由程序自动管理。 |
| 单个表情包的元数据(如标签、来源、下载链接)。 | ⚠️ 可修改,但需要符合 JSON 结构。 |
| 状态合并的临时文件,用于记录索引合并进度。 | ❌ 不建议修改,可能破坏状态一致性。 |
| Python 和 Shell 脚本,用于下载表情包资源。 | ✅ 可修改:根据你的数据源调整下载逻辑。 |
| 某个任务执行后的总结报告(时间戳或哈希后缀)。 | ✅ 可读可删,不影响 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 当作你的专属表情搭档,让沟通更生动、更有趣。快去试试吧,打造一个真正“懂你”的表情包助手,从今天开始!
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。