jordymaui 的第一篇 OpenClaw 文章有 330 万次浏览、33000 次收藏。但那篇已经有一半过时了——安装流程变了、Anthropic 取消了对第三方工具的订阅接入、新模型发布了。整个环境在两个月里天翻地覆。

所以这是更新版本。在跑了 500 小时之后，他整理了从零开始的完整配置指南。

三个前置条件

在碰终端之前，需要准备好三样东西。

AI Model API Key。OpenClaw 不绑定单一模型供应商，目前可选的有：Anthropic Claude（Opus 4.6 是最智能的模型，适合配置阶段；Sonnet 4.6 更便宜，日常任务够用）、OpenAI GPT-5.4（上周 Anthropic 取消订阅接入后大量用户迁移到这里）、Google Gemini 2.5 Pro（长上下文任务表现好，有慷慨的免费额度起步）、Ollama 本地模型（完全免费，但达不到前沿质量）、DeepSeek（来自中国，定价有竞争力）。

建议：用 Opus 4.6 做主模型，先充 250 美元Credits避免新手 rate limit 瓶颈。

Groq API Key。这是单独于主模型的，用来驱动语音笔记转录——也就是你的 Agent 能理解 Telegram 语音消息的关键。免费注册获取。

Web Search API Key。Brave Search 约每月 5 美元，最可靠；Tavily 有免费额度；Firecrawl 搜索加页面抓取一体化；SearXNG 完全免费但需要自托管。建议 Brave Search。

安装流程

Windows 一条命令：iwr -useb https://openclaw.ai/install.ps1 | iex。Mac 先装 Homebrew，然后 openclaw onboard。

setup wizard 几步走：选 Anthropic 供应商、粘贴 API Key、选 Opus 4.6 模型、配置 Telegram 通讯（最简单的平台）。

Telegram 连接流程：找 BotFather 建 bot、拿到 API Key、粘贴给 Agent、收到 PAIR code、回到 Telegram 粘贴配对码。完成后发一条"hi"，看 Agent 回复。

最值得做的三个配置步骤

第一步：装 kickstart skill（免费）。这是 jordymaui 自己做的，包含 SOUL.md（Agent 人格）、USER.md（你的信息）、AGENTS.md（操作手册）、TOOLS.md（本地环境笔记）、HEARTBEAT.md（主动检查清单）。kickstart 不只是创建这些文件，它会引导你把内容填好。这能节省第一天的四个小时摸索时间。

第二步：装 QMD skill。这个 Skill 给 Agent 的记忆系统加了语义搜索能力。没有 QMD，你的 Agent 是有标签但没索引的文件柜；有 QMD，所有内容都被索引并可搜索。"我上次说预算的事是哪次来着？"直接命中，不需要 Agent 扫描几周前的对话记录。

第三步： onboarding session 用语音回复。告诉 Agent："在开始任何事之前，先建一个不超过 20 个问题的问卷，了解我是谁、我们在做什么。" Agent 会返回问题列表，然后用语音笔记回复——不是打字。随意说，想到哪儿说到哪儿，停下来思考也行。Agent 能从你的语音里捕捉到你沟通的方式、你真正关心什么、脑子里在想什么。实测：一个语音笔记比几周的打字消息更有价值。

五个关键实践

模型路由。不要所有任务都跑 Opus——它最智能但也最贵。配置成 Opus 处理复杂任务（推理、多步流程、创造性工作），Sonnet 或 Groq 处理日常任务（查日历、简单查询、监控、通知）。这一项能直接把每月账单砍一半。

CLAUDE.md 要短。这个文件在 Agent 处理的每条消息里都会被重新注入。泄露的 Claude Code 源码确认了这一点。如果写了两千字人生故事，每次都在烧 token，而且 Agent 会因为重复内容产生混乱。jordymaui 的 CLAUDE.md 只有 6 行：名字、角色、沟通风格、三条规则。其他一切放在 Skills 和记忆文件里，Agent 需要的时候再拉取。

按工作拆分数 Agent。如果你在跑超过 3-4 种不同任务，用独立的 Agent。一个 Agent 同时扫 Twitter、管数据、写内容、处理邮件、跑定时任务——大概两周后上下文开始混淆，任务之间互相污染，速度变慢。按工作分 Agent，上下文干净、响应快、错误少。

每周读一次自己的记忆文件。Agent 每次对话后会写笔记。每周检查一次，你会发现在它行动之前先抓到错误的假设——有时候非常准确，有时候错得离谱。像读助手的日记。

每周跑 openclaw update。上周有 9 个 CVE 一周内发布，其中一个评分 9.9/10。不更新就裸奔。