必须在agents.md中用2空格缩进树状结构描述项目目录,并显式列出.openclaw/;关键目录需在下方用▶标注功能,如▶ src/是全部可编辑源码所在;选中项目根目录后顶部显示“当前工作区”才生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在AionClaw中让AI准确理解并操作你的项目,必须在上下文里清晰说明当前项目目录结构,否则AI可能误读文件位置、读错配置、甚至修改错误路径下的文件。
确认当前工作目录是项目根目录
打开AionClaw客户端,点击左下角「自动化」→「定时任务」→右上角「+新建任务」→在弹出窗口中点击「选择工作目录」按钮,手动导航并选中你的项目根文件夹(例如 【project/】),点击确定。这一步不可跳过,AionClaw不会自动推断你正在处理哪个项目,它只信任你显式指定的路径。
选完后,界面顶部会显示类似「当前工作区:/Users/you/project」的提示——只有看到这个,后续所有上下文描述才具备坐标基准。
在AGENTS.md中用树状缩进写明结构
在项目根目录下新建或编辑 AGENTS.md 文件,用纯文本树状格式逐级缩进描述,不加任何解释性文字,不使用代码块包裹。
示例写法:
```
src/
├── components/
│ ├── Header.jsx
│ └── Footer.jsx
├── utils/
│ └── api.js
package.json
README.md
.env
.openclaw/
```
注意:缩进必须用空格(不能用Tab),每级缩进2个空格;文件名后不加斜杠,目录名后必须加斜杠;.openclaw/ 必须显式列出,因为AionClaw依赖该目录执行任务记录与缓存,AI若不知其存在,可能绕过关键机制。
对关键目录添加功能注释(仅限必要处)
在树状结构下方空一行,用短句说明1~2个核心目录的实际作用,每句以「▶」开头,仅标注真正影响AI行为的目录。
▶ src/ 是全部可编辑源码所在,所有代码修改必须在此目录内进行
▶ .openclaw/ 是AionClaw运行时自动生成和读取的任务日志与缓存目录,禁止手动删除或移动
▶ .env 包含敏感配置,读取时需跳过值内容,仅解析键名用于环境判断
不要为 README.md、package.json 这类通用文件加注释——AI已内置识别逻辑;只注释那些不标准、有业务特殊性的目录或文件,比如 custom-hooks/、legacy-migration/ 等。
验证上下文是否生效
方法一:在对话任务中直接输入「列出当前项目根目录下的所有一级子项」→AionClaw应返回你写在AGENTS.md中的 src/、package.json、.env 等名称,且顺序一致。
方法二:输入「.openclaw 目录里有哪些子目录」→应准确返回 config/、tasks/、logs/、cache/(前提是你的 .openclaw/ 目录真实存在且非空)。
如果返回「未找到 .openclaw 目录」或列表缺失,说明 AGENTS.md 未被加载——检查文件是否真的放在项目根目录,且文件名是全大写的 AGENTS.md(不是 agents.md 或 Agnets.md)。











