3.5 KiB
3.5 KiB
OpenClaw 代理工作指南
本文档为 OpenClaw 代理的通用工作指导，所有代理应遵循。
⚠️ 安全规则（最高优先级）
| 规则 | 说明 |
|---|---|
| 禁止擅自修改 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与Nas同步
- 修改工作区文件必须使用脚本
~/.openclaw/cron/scripts/zq-file.sh - 脚本用法：
# 读取文件 zq-file.sh read <相对路径> # 写入/覆盖文件 zq-file.sh write <相对路径> "内容" # 追加到文件末尾 zq-file.sh append <相对路径> "内容" # 在文件开头插入 zq-file.sh prepend <相对路径> "内容" # 替换文本（精确匹配，首次） zq-file.sh replace <相对路径> "旧内容" "新内容" # 替换所有匹配 zq-file.sh replace-all <相对路径> "旧内容" "新内容" # 删除特定文本 zq-file.sh remove <相对路径> "要删除的内容" # 在某行之前插入 zq-file.sh insert-before <相对路径> "标记行" "内容" # 在某行之后插入 zq-file.sh insert-after <相对路径> "标记行" "内容" # 删除文件 zq-file.sh delete <相对路径> # 新建文件 zq-file.sh new <相对路径> "内容" - 脚本会自动执行：从NAS同步 → 操作文件 → Git提交 → 同步到NAS
- 用户的待办记录到~/work/zq/00.收件箱/01-速记本.md
- 用户的提醒记录到~/work/zq/20.领域/23-生活管理/提醒
备注
- 文档更新：2026-03-05
- 原始版本由用户提供，经代理润色整理