原文：https://x.com/Voxyz_ai/status/2031346083151159386
作者：Voxyz (@Voxyz_ai)

过去三个月，我眼睁睁看着几万人安装了 OpenClaw。

腾讯甚至在他们深圳总部摆摊，免费帮人安装。

但大多数人在一周内就放弃了。

不是因为 OpenClaw 不好。而是因为刚装好的那几个小时，他们搞砸了几件关键的事，然后就以为”就这样了”。

我从 clawdbot 时代就开始用 OpenClaw 了。拥有5个🦞Agent的团队。能踩的坑我一个不落全踩了。这里是 10 件没有任何教程会告诉你的事。每一件都让我付出了真金白银，或者浪费了一整天时间。

1. 它没挂，是你绑住了它的手

你的第一个OpenClaw🦞上线了。你让它读个文件。没反应。运行个命令。没反应。你觉得它坏了。

它没坏。它好得很。你只是没给它工具。

在之前的版本里，默认的 tools.profile 是 messaging。你的代理只允许发消息。读文件、写文件、运行命令、用浏览器——全都被禁用了。

想象一下雇了个全职员工，但只给他一部电话和一把椅子。他就坐那儿。他能说话。但他什么都干不了。

"tools": { "profile": "full" }

就这一行代码。你的代理从一部电话变成了一整个办公室。

译者注：这些配置项都在（以Mac为例） ~/.openclaw/openclaw.json 这个JSON文件内，下同↓↓↓

如果你还想让代理运行命令时不用问你（比如在 Telegram 上没有确认弹窗的地方）：

"tools": {
  "profile": "full",
  "exec": { "security": "full", "ask": "off" }
}

两个开关。profile 控制有没有工具。exec.ask 控制用之前要不要问你。先设 profile，再设 exec。反过来设没用。

从某个版本开始，onboard 默认改成 coding 了。新安装不会遇到这个问题。但如果你是老用户，或者手动改过配置，检查一下。

译者注：OpenClaw的v2026.3.2版本默认权限是’messaging’，而v2026.3.7版本改回了‘coding’

2. 你最重要的规则可能从来没被读过

这个坑浪费了我大半天。

我在 AGENTS.md 里写了一条规则。我的代理一直无视它。换成 Opus 模型。还是无视。我以为是模型太蠢。

结果是那条规则在文件中间。它根本没进真正发给代理的上下文。

为啥？OpenClaw 对每个工作区文件有 20,000 字符限制。超过的部分会被静默截断。它保留前 70%，保留后 20%，中间 10% 直接砍掉。

没有错误提示。没有警告。你的代理在不完整的指令下运行，而你完全不知道。

就像交给新员工一本合规手册，但中间有几页粘在一起了。他以为自己全读完了。你也以为他全读完了。

怎么检查：在聊天里输入 /context list。如果你看到 TRUNCATED，就是被截断了。

修复方法：把最重要的规则放在文件顶部。中间是死亡区域。

如果你的文件确实需要很长，调整这两个设置：

"bootstrapMaxChars": 20000,
"bootstrapTotalMaxChars": 150000

第一个是单个文件限制。第二个是所有文件加起来的限制。

3. 你 80% 的 API 费用是在烧钱

两周后，我打开 token 仪表盘。80% 是输入。不是输出。

我的代理不是在思考。它是在复习。每一轮对话，它都重新读一遍系统提示、工具定义、SOUL.md、还有完整的聊天记录。在发每条消息之前，它都从头到尾复习一遍它的世界观。

有个读者给我看他的数据：1.39 亿输入，93.5 万输出。比例是 148:1。他的代理每轮对话塞进去 52KB 上下文。光是 MEMORY.md 就 22KB。每条消息都以重读一本小书开始。

想象一下一个员工每天早上开工前，先把所有公司政策文件读上两小时。他大部分工资都花在阅读上了。

修复方法很简单：核心规则放 SOUL.md 里。其他东西都移到 memory 文件夹，让代理通过 memory tools 按需读取。

改完之后，token 消耗下降了 40-60%。输出质量没变。

你的钱应该用来买思考。不是用来一遍又一遍读同一本手册。

4. 别在模型上省钱，省你的时间

很多人本能地选择最便宜的模型来跑代理。

我试过。便宜模型省了 20 美元。然后我花了一小时修输出。又花了一小时解释哪里出错了。重写提示词。再跑一遍。最后还是切回最强模型。一次就搞定了。

我省下的 20 美元，花了我一整天。

我的做法：一个最高档订阅。所有代理都用它跑。不按 token 计费。没有用量焦虑。代理想调用多少次就调用多少次，提示词想写多长就写多长。

但这里有个区别：不是所有代理都需要同一个模型。

跟人聊天的代理需要 Opus。它得理解语气、读懂情绪、写得像个人。便宜模型干不了这个。

拉数据、扫通知、整理内容的代理用 GPT-5.4 更好。不是因为它便宜，而是因为它更快、更稳定、更听话。Opus 会把简单任务想复杂。扫垃圾邮件的时候，它会分析语气、猜测意图。写日报的时候，它会加自己的看法。

agents:
  defaults:
    model:
      primary: "openai/gpt-5.4"
  list:
    - id: community-bot
      model: "anthropic/claude-opus-4-6"

这不是为了省钱。这是为了给合适的活配合适的工具。

5. 你的记忆系统三周后就会崩

第一天看 MEMORY.md 还挺清爽。三周后它就是个垃圾抽屉。

译者注：memory在 ~/.openclaw/workspace 目录下

上个月过时的决策跟今天的新计划挤在一起。当代理搜索记忆时，它分不清新旧。它经常捞到一个月前的信息，当成当前事实来处理。

你的桌子上堆了三个月的文件。你紧急需要一份合同。你抽出来一份。是上个月过期版本。你基于过时条款签了字。

你不需要在第一天就设计三层记忆架构。你的代理还没干成一件有用的事呢。你设计个啥？

打开 OpenClaw 内置的 temporal decay（时间衰减）。新记忆权重更高。旧记忆自动衰减。不需要手动清理。

80% 的记忆问题解决了。

记忆问题是跑出来的，不是设计出来的。先跑起来再说。

6. 没人接收输出的代理，是你成本的超级黑洞

有个读者看完我的第一篇文章，太兴奋了，一口气搭了一整套系统。结果：2000 万个文件。

有用的就一个 .env 和几个 markdown。其他全删了。花了一整天。

我也干过同样的事。第一次代理跑起来的时候，我想让它干所有事。协调员、分析师、战略师、编辑、运营。组织架构图画出来可漂亮了。

然后我发现：一半Agent每天都在生产输出，但没有任何Agent或人消费这些输出。没人读的日报。没人看的分析。什么都不需要审批的审批流程。

现在每个代理开工前必须回答三个问题：

1. 我产出什么
2. 谁接收我的输出
3. 我绝不碰什么

答不出第 2 题？这个岗位不该存在。

我在所有代理上跑了这个测试。砍掉一个。token 消耗下降 44%。速度提升 62%。

起步建议：一个代理，一个任务，一个你每天都会实际查看的输出。等它稳定了，再加第二个。

7. 五个代理不该挤在一个房间

到第三个月，5 个代理全在一个 Telegram 群里说话。日报混着运行时警报。客户支持跟内容策划缠在一起。我每天花 20 分钟翻消息找信息。

这不对。

OpenClaw 支持 Telegram forum topics（论坛主题）。一个 Telegram 论坛可以有多个主题，每个绑定不同的代理：

channels:
  telegram:
    groups:
      "-100xxxxxxxxxx":
        topics:
          "daily-brief": { agentId: "nexus" }
          "radar": { agentId: "scout" }
          "content": { agentId: "quill" }
          "runtime": { agentId: "forge" }
          "support": { agentId: "guide" }

每个主题有自己的会话、自己的工作区、自己的记忆。

办公室有独立房间。财务在财务室。工程在工程室。支持在支持室。你不会把所有人塞进一个开放大厅互相喊吧。

我打开运营室，扫一眼，就知道谁在干活、谁卡住了、什么需要我做决定。

8. 你的代理不知道是谁在跟它说话

你的代理收到一条消息。它根本不知道是你发的、另一个代理发的、还是某个外部系统发的。它一视同仁，全部执行。

就像你的员工收到一封邮件就跟着指令做，不查是谁发的。谁都能冒充你。

OpenClaw 的 ACP bridge 现在支持 provenance mode（来源模式）：

openclaw acp --provenance off          # 禁用
openclaw acp --provenance meta         # 消息带来源标签
openclaw acp --provenance meta+receipt # 来源标签 + 代理能看到可见的来源回执

meta 让系统知道消息从哪来。meta+receipt 让代理也能看到。

你的代理不该盲目信任收到的每个输入。至少对于通过 ACP bridge 来的消息，它现在可以查 ID 了。

9. 没人提醒你备份

所有人教你安装 OpenClaw。没一个人说先备份的事。

我有一次丢了整个配置。花了一整天手写重建 SOUL.md。凭记忆重写每条规则。重建的版本更差，因为我记不住当初编码进原版的一半边界情况。

OpenClaw 现在支持 原生备份：

openclaw backup create
openclaw backup create --only-config
openclaw backup create --no-include-workspace
openclaw backup verify <archive>

默认会打包本地状态、配置、凭证和会话。工作区是可选的。

我一直在跑每周 VPS 备份。现在加上这个，双重保险。

没人庆祝这个功能。直到他们需要的那一天。

10. 别设计，直接用

三个月来的最大教训。

我见过太多人安装完 OpenClaw，立马花三天画架构图。几层记忆？代理之间用什么通信协议？哪些跑 Opus，哪些跑 Sonnet？

架构图画完了。系统还没跑过任何一个真实任务。

反过来做：

• • 第一天：一个代理，连上 Telegram，做一件你每天都会重复的事。
• • 第一周：它会崩。tools.profile、规则截断、响应慢。修它们。这才是真正的学习。
• • 第二周：看看账单。精简臃肿的提示词。给不同的活配不同的模型。
• • 第三周：加第二个代理。现在你真的懂什么叫下游消费者了。
• • 第四周：架构不需要你设计。它是从你解决的每个问题中长出来的。

安装 OpenClaw 后的第一个小时，比接下来一个月都重要。

不是因为那个小时需要做多少事。而是因为那个小时决定了你是否会继续走下去。

每个教程都教你安装。这篇告诉你之后的路长什么样。

你不需要去找坑。开始走。坑会自己来找你。

译者注：虽然我的账号吃到了OpenClaw这只龙虾🦞的红利，但还是不得不说…请大家对🦞略微怯魅~ 能把🦞装上和能用好🦞完全是两件事！ 回顾人类历史，关键问题从来就不在于一个工具有多好，而在于你拿到这个工具之后究竟用来做啥，不是么？