MateClaw is a pluggable agent runtime that coordinates AI agents, tools, conversations, memory, and workflows. It is designed for personal and multi-user AI assistants, including agents used through chat platforms. Catalogue add-ons provide skills for extending its agent workflows.
Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add skills/mateaix/mateclaw/guidancenpx skills add mateaix/mateclaw --skill guidancegit clone --depth 1 https://github.com/mateaix/mateclawWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/mateaix/mateclaw/guidance)<a href="https://agentmods.dev/skills/mateaix/mateclaw/guidance"><img src="https://agentmods.dev/badge/skills/mateaix/mateclaw/guidance.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00036 | $0.00536 |
| Opus 5 | $0.00018 | $0.00268 |
| Sonnet 5 | $0.00007 | $0.00107 |
| Haiku 4.5 | $0.00004 | $0.00054 |
Grade A, and why
guidance scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
What it actually says
MateClaw 安装与配置问答
当用户询问 MateClaw 的安装、初始化、环境配置、依赖要求、常见配置项时使用本技能。
核心原则:先查文档,再回答;不臆测;回答语言与提问语言一致。
工作流程
第一步:查文档目录
readMateClawDoc(action="list")
浏览返回的文件列表,找到与用户问题最相关的文档(如 zh/quickstart.md、en/config.md)。
第二步:读取相关文档
readMateClawDoc(action="read", path="zh/quickstart.md")
文档较长时只读相关章节;如多个文档都相关,按优先级依次读取。
第三步:提炼答案
从文档中提取关键信息,组织成可执行答案:
- 先给直接结论
- 再给步骤 / 命令 / 配置示例
- 补充必要前置条件和常见坑
第四步(兜底):搜索官网
如本地文档信息不足:
search(query="MateClaw 安装配置 <关键词>", language="zh-CN", count=5)
参考搜索结果补充回答,并注明信息来自官网搜索。
文档路径速查
| 内容 | 路径 |
|---|---|
| 快速开始(中文) | zh/quickstart.md |
| 配置说明(中文) | zh/config.md |
| Quick Start (EN) | en/quickstart.md |
| Config Reference (EN) | en/config.md |
输出质量要求
- 不编造不存在的配置项或命令
- 涉及版本差异时标注"请以当前版本文档为准"
- 涉及路径、命令、配置键时给可复制的原文片段
- 若信息仍不足,明确告知用户缺少哪类信息(操作系统、安装方式、报错日志等)
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 5d ago First seen · 67 lines · 36 tokens per session scan A 5b189a92b245
guidance is a skill published in the GitHub repository mateaix/mateclaw (1,061 stars, last pushed 4d ago), licensed Apache-2.0. It adds 36 tokens to every session and 536 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
make-skill
Use this skill when sedimenting a session into a reusable workspace skill. Triggers when the user wants to turn the current conversation, workflow, or troubleshooting path into a SKILL.md. Phrases like 'turn this into a skill', 'remember how I did X', 'save this workflow', 'make a skill from this', and any /make-skill…
make-skill
用于把当前会话沉淀为可复用的 workspace skill。当用户希望把当前对话、工作流或排错路径写成 SKILL.md 时触发。触发表达包括「把这个变成 skill」「记住我是怎么做 X 的」「保存这个工作流」「make a skill from this」以及任何 /make-skill 调用。.
terraform-skill
Use when working with Terraform or OpenTofu - creating modules, writing tests (native test framework, Terratest), setting up CI/CD pipelines, reviewing configurations, choosing between testing approaches, debugging state issues, implementing security scanning (trivy, checkov), or making infrastructure-as-code…
docx
Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files). Triggers include: any mention of "Word doc", "word document", ".docx", or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when…
docx
当用户需要创建、读取、编辑或处理 Word 文档(.docx)时,使用此技能。触发场景包括提到“Word 文档”、“.docx”,或要求生成带目录、标题、页码、信头等格式的专业文档;也包括提取或重组 .docx 内容、插入或替换图片、在 Word 文件中查找替换、处理修订或批注,以及将内容整理为正式 Word 文档。如果用户要求生成“报告”“备忘录”“信函”“模板”等 Word / .docx 交付物,也应使用此技能。不要用于 PDF、电子表格、Google Docs,或与文档生成无关的一般编程任务。.
multi_agent_collaboration
Use this skill when another agent's expertise or context is needed, or when the user explicitly asks to involve another agent. First list agents, then use qwenpaw agents chat for two-way communication with replies.