OpenClaw 是一款免费、开源的本地优先(Local-first)自主 AI 智能体(Autonomous AI Agent),它能够通过大语言模型(LLM)执行复杂任务。与传统的网页端 Chatbot 不同,OpenClaw 主要通过通讯软件(如 Discord, Slack, Telegram 等)作为用户界面交互,并且能够真正在用户的本地基础设施中运行和操作。
核心生态与配置体系
OpenClaw 的强大之处在于其基于文件的上下文配置体系。使用者不需要每次都写一长串提示词,而是通过几个核心的 Markdown 文件来定义 Agent 的状态和边界。
1. 核心人设与用户档案
SOUL.md:Agent 的“灵魂”或完整人格文件。包含声音/语气、词汇、决策框架、反水文(anti-slop)标准。确保 Agent 像具体的“人”一样沟通。USER.md:使用者的深度档案。记录用户的作息/日程、偏好、内容赛道、关注领域等,让 Agent 具备背景知识。
2. 环境与周期控制
-
HEARTBEAT.md:心跳式批量周期检查机制。利用心跳轮询批量处理周期性任务(例如日历、待办事项监控、看板同步),而不是为单个动作设立独立的定时任务。 -
AGENTS.md: 怎么做事(约定、规则、行为准则) -
TOOLS.md:“环境速查表(作弊小抄)”。记录本地环境配置要点、SSH 细节、API 路径及常用工具。安全注意
.secrets等环境变量或加密文件中,绝不直接写在此处。API Key 等敏感信息应当放入
3. 反思与记忆闭环
LEARNINGS.md:每次纠错后的教训库。执行修复逻辑:修复当前问题→把教训写入此文件(标注错误模式)→建立防侧漏规则→并在每次会话开始时回顾。同一个错误禁止犯两次。MEMORY.md:精炼后的长期记忆。仅保存提炼后的核心洞见、项目状态和高优决策。记忆的最佳实践
memory/YYYY-MM-DD.md中。必须牢记:脑内记忆跨不过重启,想让 Agent 记住就必须固化进文件。原始的执行日志可以按天写入
关键协作边界与纪律
赋予 Agent 自主权时,必须明确划分放权边界,以防止灾难性操作:
决策权限划分
- 可以自主执行(大胆做):查阅文档、上网搜索、修复常规 Bug、梳理日志、更新本地知识库等非破坏性工作。
- 必须询问(小心做):产生费用、删除或修改生产环境核心资源、代码分支覆盖(严禁 force push)、涉及外部内容发布的敏感操作。
状态透明化与 Vibe Coding
- 工作状态反馈:若操作执行预计超过 10 秒,OpenClaw 必须在开始前反馈其正在做什么,避免让用户陷入死寂的等待黑盒。
- 审批流建立:面向公众发布的内容,必须经过人类审核拦截。采用严格的审批流:
草稿生成→发送到审批频道→人类 Approve/Reject。文案应当具有独立观点,杜绝 AI 的套话。
相关阅读:
- how-i-use-openclaw:我对 OpenClaw 的自动化工作流实践总结
- 20-openclaw-prompts:用于调教 OpenClaw 的 20 条高频提示词与规则