ClawBot项目AI提示配置：自定义上下文指令方法

ClawBot支持四种项目特定AI提示配置方法，听起来挺全的：一、用AGENTS.md注入静态上下文；二、用SOUL.md定义长期记忆指令；三、通过CLI命令动态注入临时上下文；四、在Web控制台可视化编辑模板。这四种方式基本覆盖了不同场景下的需求。

如果你希望ClawBot在处理某个项目时，始终遵循专属的行为规范或者知识约束，但发现默认的系统提示词覆盖不了这些场景，问题多半出在项目上下文没正确注入，或者格式不符合解析规则。下面展开讲讲具体怎么操作。

一、通过AGENTS.md文件注入静态项目上下文

ClawBot在每次请求中，会自动加载项目根目录下的AGENTS.md文件内容，作为结构化的上下文指令。这个文件得用Markdown语法写，支持标题、列表和代码块。系统会把它转成结构化的提示片段，然后拼接到请求头部。

具体步骤如下：

1、在项目根目录新建一个纯文本文件，命名为AGENTS.md。

2、用二级标题定义角色定位，比如写上## 本项目技术栈：Python 3.12 + FastAPI + PostgreSQL。

3、用无序列表明确约束条件，比如- 所有SQL语句必须使用参数化查询，禁止字符串拼接。

4、保存文件后，执行clawdbot reload context命令，触发上下文热重载。

5、发条测试消息，比如“生成一个用户注册接口”，看看响应里有没有体现AGENTS.md里声明的技术栈和安全要求。

二、利用SOUL.md定义长期记忆导向指令

SOUL.md是ClawBot识别的另一个核心上下文文件，专门用来设定AI的“行为人格”和记忆优先级策略。它不参与单次请求的即时逻辑判断，而是影响模型对历史对话摘要的压缩方式，以及跨会话意图的延续性。

具体做法：

1、在项目根目录新建SOUL.md文件。

2、首行写入!priority:high标记，表示这个文件内容拥有最高上下文权重。

3、添加人格化指令，比如你是一名专注金融合规的后端工程师，所有建议必须引用《证券期货业网络信息安全管理办法》第27条。

4、加入记忆锚点句式，比如当用户提及“上季度审计报告”，自动关联路径：/docs/compliance/audit_q1.pdf。

5、运行clawdbot context validate --file SOUL.md检查语法合法性，如果返回✓ Valid syntax，就说明生效了。

三、通过CLI命令行动态注入临时上下文片段

有时候，某次调试会话需要快速附加一些指令，又不想改文件。这时可以用clawdbot context inject命令，直接向当前会话注入上下文块。这个操作只对本次会话和后续5分钟内的连续交互有效，不会持久化存储。

操作流程：

1、打开终端，确保ClawBot服务在运行。

2、执行命令：clawdbot context inject --role "数据库迁移顾问" --constraint "只输出PostgreSQL兼容语法"。

3、系统会返回一个注入ID，比如context-8a3f2b1e。

4、马上发消息：“把users表增加email_verified字段”，看看响应是不是限定在PostgreSQL语法，并且带点角色口吻。

5、如果要清除这个临时上下文，执行clawdbot context clear --id context-8a3f2b1e就行。

四、在Web控制台中可视化编辑项目上下文模板

Web控制台提供了图形化的上下文管理界面，支持多版本快照、差异比对和一键回滚。这个方式特别适合团队协作，能避免多人同时编辑同一个文件导致的冲突。

具体步骤：

1、确保设备已获批准，并获取有效的Dashboard链接（执行clawdbot dashboard获取）。

2、在浏览器里打开Dashboard地址，登录后点击左侧导航栏的Context Studio。

3、选择目标项目，点击+ New Template按钮。

4、在编辑区粘贴Markdown内容，右侧的实时预览会显示渲染效果和结构解析结果。

5、点击Publish as v2.1发布新版本，系统会自动更新所有关联会话的上下文引用指针。

6、关键提示：发布后需要手动触发clawdbot gateway restart，新模板才会生效。