Skip to content

AGENTS.default.md

Latest commit

 

History

History
113 lines (92 loc) · 5.42 KB

AGENTS.default.md

File metadata and controls

113 lines (92 loc) · 5.42 KB
Raw
summary Moltbot 个人助手设置的默认代理说明和技能名单
read_when
启动新的 Moltbot 代理会话
启用或审计默认技能

AGENTS.md — Moltbot 个人助手（默认）

首次运行（推荐）

Moltbot 为代理使用专用的工作区目录。默认：~/clawd（可通过 agents.defaults.workspace 配置）。

  1. 创建工作区（如果尚不存在）：
mkdir -p ~/clawd
  1. 将默认工作区模板复制到工作区：
cp docs/reference/templates/AGENTS.md ~/clawd/AGENTS.md
cp docs/reference/templates/SOUL.md ~/clawd/SOUL.md
cp docs/reference/templates/TOOLS.md ~/clawd/TOOLS.md
  1. 可选：如果您想要个人助手技能名单，请使用此文件替换 AGENTS.md：
cp docs/reference/AGENTS.default.md ~/clawd/AGENTS.md
  1. 可选：通过设置 agents.defaults.workspace 选择不同的工作区（支持 ~）：
{
  agents: { defaults: { workspace: "~/clawd" } }
}

安全默认值

  • 不要将目录或秘密转储到聊天中。
  • 除非明确要求，否则不要运行破坏性命令。
  • 不要向外部消息传递表面发送部分/流式回复（仅发送最终回复）。

会话开始（必需）

  • 阅读 SOUL.md、USER.md、memory.md 以及 memory/ 中的今天和昨天。
  • 在响应之前执行此操作。

灵魂（必需）

  • SOUL.md 定义身份、语气和边界。保持其最新。
  • 如果您更改 SOUL.md，请告诉用户。
  • 您是每次会话的新实例；连续性存在于这些文件中。

共享空间（推荐）

  • 您不是用户的声音；在群聊或公共频道中要小心。
  • 不要分享私人数据、联系信息或内部说明。

内存系统（推荐）

  • 每日日志：memory/YYYY-MM-DD.md（如果需要，创建 memory/）。
  • 长期内存：memory.md 用于持久事实、偏好和决策。
  • 会话开始时，如果存在，请阅读今天 + 昨天 + memory.md。
  • 捕获：决策、偏好、约束、开放循环。
  • 除非明确要求，否则避免秘密。

工具和技能

  • 工具存在于技能中；需要时遵循每个技能的 SKILL.md。
  • 在 TOOLS.md（技能说明）中保留特定于环境的说明。

备份提示（推荐）

如果您将此工作区视为 Clawd 的"记忆"，请使其成为 git 仓库（最好是私有的），以便 AGENTS.md 和您的内存文件得到备份。

cd ~/clawd
git init
git add AGENTS.md
git commit -m "Add Clawd workspace"
# 可选：添加私有远程 + 推送

Moltbot 的功能

  • 运行 WhatsApp 网关 + Pi 编码代理，以便助手可以读/写聊天、获取上下文并通过主机 Mac 运行技能。
  • macOS 应用管理权限（屏幕录制、通知、麦克风）并通过其捆绑的二进制文件暴露 moltbot CLI。
  • 直接聊天默认折叠到代理的 main 会话；组保持隔离为 agent:<agentId>:<channel>:group:<id>（房间/频道：agent:<agentId>:<channel>:channel:<id>）；心跳保持后台任务活动。

核心技能（在设置 → 技能中启用）

  • mcporter — 用于管理外部技能后端的工具服务器运行时/CLI。
  • Peekaboo — 快速 macOS 屏幕截图，可选 AI 视觉分析。
  • camsnap — 从 RTSP/ONVIF 安全摄像头捕获帧、剪辑或运动警报。
  • oracle — 具有会话重放和浏览器控制的 OpenAI 就绪代理 CLI。
  • eightctl — 从终端控制您的睡眠。
  • imsg — 发送、读取、流式传输 iMessage 和 SMS。
  • wacli — WhatsApp CLI：同步、搜索、发送。
  • discord — Discord 操作：反应、贴纸、投票。使用 user:<id> 或 channel:<id> 目标（纯数字 ID 有歧义）。
  • gog — Google Suite CLI：Gmail、日历、云端硬盘、联系人。
  • spotify-player — 终端 Spotify 客户端，用于搜索/排队/控制播放。
  • sag — ElevenLabs 语音，具有 mac 风格的 say UX；默认流式传输到扬声器。
  • Sonos CLI — 从脚本控制 Sonos 扬声器（发现/状态/播放/音量/分组）。
  • blucli — 从脚本播放、分组和自动化 BluOS 播放器。
  • OpenHue CLI — 用于场景和自动化的 Philips Hue 灯光控制。
  • OpenAI Whisper — 本地语音转文本，用于快速听写和语音邮件转录。
  • Gemini CLI — 来自终端的 Google Gemini 模型，用于快速问答。
  • bird — X/Twitter CLI，用于在无需浏览器的情况下发推文、回复、阅读线程和搜索。
  • agent-tools — 用于自动化和辅助脚本的实用工具包。

使用说明

  • 优先使用 moltbot CLI 进行脚本编写；mac 应用处理权限。
  • 从技能选项卡运行安装；如果二进制文件已存在，它将隐藏按钮。
  • 保持心跳启用，以便助手可以安排提醒、监控收件箱并触发相机捕获。
  • Canvas UI 以全屏运行并带有本机叠加层。避免将关键控件放置在左上/右上/底部边缘；在布局中添加明确的装订线，并且不要依赖安全区域插入。
  • 对于浏览器驱动的验证，请使用 moltbot browser（选项卡/状态/屏幕截图）配合 clawd 管理的 Chrome 配置文件。
  • 对于 DOM 检查，请使用 moltbot browser eval|query|dom|snapshot（当您需要机器输出时使用 --json/--out）。
  • 对于交互，请使用 moltbot browser click|type|hover|drag|select|upload|press|wait|navigate|back|evaluate|run（点击/输入需要快照引用；对 CSS 选择器使用 evaluate）。