3.8 KiB
3.8 KiB
AGENTS.md - Your Workspace
This folder is home. Treat it that way.
⚠️ 安全规则(最高优先级)
| 规则 | 说明 |
|---|---|
| 禁止擅自修改 openclaw.json | 用户未明确要求时不得修改 |
| 禁止 force push | git push --force 绝对禁止 |
| 禁止修改第三方库代码 | 如需修改应通过 fork 或 patch |
| 禁止使用 rm -rf | 使用 trash 替代,确保可恢复 |
操作规范
通用规则
- 使用中文沟通
- 使用东八区(Asia/Shanghai)时间
Sudo 命令使用
- 需要 passwordless sudo 权限才能执行系统级操作
- 配置路径:
/etc/sudoers.d/nopasswd - 配置后验证:
sudo visudo -c
子代理使用
- 代码开发和耗时操作必须交给子代理处理
- 汇报机制
- 子代理开始工作时,立刻汇报:「已安排代理处理 [任务]」
- 每 5 分钟查询子代理状态,汇总后简报给用户
技能使用
- 使用技能过程中,遇到流程外的问题需在结果中明确汇报具体问题
定时任务
- 所有定时任务通过 OpenClaw Gateway 内置 Cron 管理
- 不使用系统级 crontab
- 相关脚本统一存放:
~/.openclaw/cron/scripts/ - 内置cron使用方法参考:
~/.openclaw/cron/jobs.json
环境说明
本机配置
| 项目 | 值 |
|---|---|
| 联网方式 | WLAN |
| IP | 192.168.1.36 |
| 网关 | 192.168.1.200(旁路由,PassWall 科学上网) |
| 项目目录 | ~/work/ |
注意:所有与 OpenClaw 本身无关的工作内容,应优先放到项目目录而非 workspace。
爬虫相关
- Cookie 存放:
~/work/cookies/(各网站登录态,JSON 格式) - 爬虫工具:
~/work/MediaCrawler/(优先使用)
局域网服务
| 服务 | 地址 | 端口 |
|---|---|---|
| NAS (SSH) | 192.168.1.22 | 2222 |
| Gitea (SSH) | 192.168.1.22 | 2223 |
| Gitea (Web) | 192.168.1.22 | 8418 |
| NAS WebDAV | 192.168.1.22 | 5005 |
用户的工作区
- 路径:~/work/zq
- 同步方式:rclone mount 实时挂载(systemd 服务:
rclone-zq.service) - 所有操作实时同步到NAS,无需手动sync - 管理命令:systemctl --user status|restart|stop rclone-zq- 日志:~/.cache/rclone/zq-mount.log - ⚠️ 禁止使用 rclone sync 操作 ~/work/zq 目录
- 该目录已通过 rclone mount 挂载,直接读写挂载点即可
- 使用 rclone sync 会绕过挂载点缓存,导致数据不一致或覆盖用户更新
- 正确做法:直接操作
~/work/zq/下的文件,挂载点会自动同步 - 用户的待办记录到~/work/zq/00.收件箱/01-速记本.md
- 用户的提醒记录到~/work/zq/20.领域/23-生活管理/提醒
Every Session
Before doing anything else:
- Read
SOUL.md— this is who you are - Read
USER.md— this is who you're helping - Read
memory/YYYY-MM-DD.md(today + yesterday) for recent context
Memory
You wake up fresh each session. These files are your continuity:
- Daily notes:
memory/YYYY-MM-DD.md— raw logs of what happened
Capture what matters. Decisions, context, things to remember.
Design Work
When helping with design tasks:
- 理解背景:问清楚项目背景、目标用户、使用场景
- 分析需求:核心功能是什么?优先级如何?
- 提出方案:给出设计建议,可以提供多个方案
- 细节打磨:颜色、布局、字体、间距、交互细节
- 交付标准:确保设计可实现,考虑开发成本
Communication
- Use professional design terminology when appropriate
- Explain design decisions clearly
- Be open to feedback and iteration
- Suggest alternatives when you see better solutions