这可能是你需要的唯一一份 OpenClaw 教程。从零开始,搭建一个完整、可运行的 AI 助手系统——无需编写任何代码。
01 什么是 OpenClaw?
大多数 AI 工具是你需要去访问的地方。而 OpenClaw 是一个为你服务的工具——它可以主动为你做事。
ChatGPT、Claude、Gemini 是你需要帮助时才会打开的工具。OpenClaw 则不同:它全天候在服务器上运行,可以连接到你的应用程序,甚至无需你的指令就能采取行动。
它的核心在于三大支柱:
- 强大的“大脑”和记忆力:通过 API 连接到 AI 模型,记住所有信息,并随着时间的推移不断改进
- 始终在线:全天候运行,可以主动联系你、安排任务、监控事项并发送更新
- 强大的工具和功能:连接到 Telegram、Gmail、日历、云端硬盘、Slack 和 Discord,实际执行操作
真实用户案例:
- “每天早上七点,它都会检查我的日历、扫描我的电子邮件,并向我发送当天的优先事项。”
- “它在我的日历上发现了一个面试,并自动创建了一份准备文档,研究了公司和职位,然后将其与我的简历进行匹配。”
- “我的健身房只允许提前 24 小时注册课程。我设置了程序监控课程表,在课程报满之前自动帮我注册。”
你可能在网上看到它叫 Clawdbot 或 Moltbot——其实是同一个项目,只是改了几次名字。OpenClaw 是它现在的名字。
02 在哪里运行 OpenClaw?
有三种主要方式:
方式一:在你的个人电脑上运行
- ✅ 免费且易于上手
- ❌ 合上笔记本电脑时程序停止运行
- ❌ 个人文件、密码、浏览器历史记录都会被访问
- ❌ 出问题也发生在你的个人电脑上
方式二:使用 Mac mini 或专用备用硬件
- ✅ 良好的隔离性,只要保持电源连接就会一直运行
- ❌ 前期投入超过 500 美元
- ❌ 需要端口转发,应对断电和网络稳定性问题
方式三:运行在服务器或 VPS 上(推荐)
- ✅ 独立的云端计算机,每月只需几美元起
- ✅ 24/7 全天候在线
- ✅ 即使 OpenClaw 出问题,也是独立运行的
- ✅ 情况糟糕时可以彻底删除服务器并重新开始
本教程使用 Hostinger VPS——原因很简单:他们提供一键式 OpenClaw 模板。无需使用终端,无需了解 Docker,只需点击“部署”即可开始运行。他们会自动处理基础安全措施,你的网关将获得随机端口和预配置的身份验证。
服务器配置建议:
- KVM 1(2 CPU 核、8 GB 内存、100 GB 磁盘)——足够满足基本设置
- KVM 2——有充足扩展空间
- KVM 4——如果想运行 Ollama 等本地模型
03 首次部署与凭证
付款后,你会进入 OpenClaw 配置页面。关键字段如下:
网关令牌
这是你整个设置的主密钥。任何拥有此令牌的人都可以完全访问你的控制面板以及你的机器人可以执行的所有操作。请像对待密码一样对待它——不要粘贴到聊天窗口,不要截屏保存,不要放在文本文件里。
API 密钥(AI 大脑)
OpenClaw 需要一个“大脑”,这需要通过 API 密钥从 AI 模型获取。本教程使用 Anthropic Claude。
获取 API 密钥的步骤:
- 注册 Claude 账户,完成入门调查
- 进入控制面板,点击“购买积分”
- 建议充值 40 美元——充值 40 美元后升级到第二级,每分钟可输入 450,000 个代币,设置过程更流畅
- 设置消费限额(建议设为 100 美元/月)
- 禁用自动充值功能——信用额度用完时 OpenClaw 会自动停止,比收到意外账单好得多
- 创建 API 密钥,复制并保存在安全的地方
04 第一次对话与身份引导
部署完成后,打开 OpenClaw 网关登录页面,粘贴你的网关令牌。
在聊天页面输入“你好”——这将运行 Bootstrap.md 文件,一个初始测试,会问一系列问题:
- 我是谁?你是谁?
- 我应该怎么称呼你?
- 感觉如何?
- 你所在的时区是什么?
- 我们将一起做什么工作?
请认真回答这些问题。 如果你的回答太简单,可能无法充分发挥机器人的功能。你需要赋予它个性和身份,让它在你接下来的合作中始终保持这种状态。
一个详细提示的示例:
- “要简洁明了、直截了当、不拐弯抹角”
- “不要用官腔,不要用填充词”
- “表达自己的观点,如果发现问题请及时指出”
发送后,OpenClaw 会构建真正的持久记忆——用得越多,它就越好用。
💡 提示:如果你的机器人停止响应或返回空白消息,最常见的原因是你的 API 额度用完了或达到了速率限制。在进行任何其他故障排除之前,先检查你的 LLM 控制面板。
05 安全基础(必做)
OpenClaw 功能强大:它可以运行终端命令、访问文件、发送消息、浏览网页。这种强大的功能意味着安全防护至关重要。
最近有人发帖称,他们的机器人浏览网页时,获取了一个嵌入了隐藏文本的页面——对人类不可见,但 AI 可以读取。这段隐藏文本试图诱骗机器人执行恶意指令。机器人识破了它的伎俩,并标记为可疑文件。
设置安全防护只需两分钟:
- 复制 OpenClaw 文档中的安全页面 URL
- 在聊天窗口中粘贴并发送:“请实施并验证此页面上的所有内容。但有一个例外,请将 allowinsecureauth 设置为 true”
- 机器人会查阅安全文档并加强自身设置
(allowinsecureauth 指的是我们之前提到的 URL 中的“不安全”徽章。目前你需要将其设为 true 才能通过浏览器访问控制面板。)
设置行为规则
告诉你的机器人:
- “代表我发送消息时,请务必先草拟并获得我的批准。”
- “删除文件前务必先询问。”
- “发出网络请求前务必先询问。”
这就是最小权限原则——只授予代理实际需要的权限。
设置运行限制
告诉你的机器人:
- “如果任务失败三次,就停止。”
- “不要让任何任务无限期运行。”
- “除非我另有指示,否则运行时间限制为 10 分钟。”
这可以避免网上流传的那些灾难性事件——有人醒来发现不知不觉花掉了几百美元的积分。
最重要的一点:从小处着手。
- 先从 Telegram 开始
- 也许添加一两项技能
- 不要立即连接你的主要邮箱、银行或密码管理器
- 通过实验了解工作原理,在信任设置后再逐步扩展
06 连接 Telegram
在 OpenClaw 聊天窗口中输入:“让我们设置 Telegram。”
机器人会返回分步说明:
- 在 Telegram 上与 BotFather 聊天——搜索 BotFather,或点击说明中的专属链接
- 发送
/newbot命令 - 为你的机器人命名(例如“伟大的格雷格”)
- 选择用户名(必须以
bot结尾,例如GregTheGreatBot) - 复制 API 令牌——像密码一样妥善保管
- 返回 OpenClaw,粘贴机器人令牌
一两分钟后,它会显示 Telegram 已开启并已连接。
接下来,在 Telegram 上给你的机器人发消息,点击“开始”。它会显示“访问未配置”的消息,并给出一个配对码。复制这条消息,返回 OpenClaw,粘贴到聊天窗口中。这样就把你的 Telegram 用户 ID 添加到了允许列表中——只有经过批准的联系人才能与你的机器人对话。
现在,试试发送“你好”,OpenClaw 就会在 Telegram 上回复你。
💡 OpenClaw 支持 15 个以上的即时通讯平台。你可以使用 WhatsApp、Discord 或 Slack——只需询问你的机器人如何设置即可。
07 理解与寻找 Skills(技能)
技能让 OpenClaw 从一个只能聊天的工具变成可以实际执行任务的工具——本质上就是插件。
在哪里找到技能?
ClawHub(clawhub.ai)——官方技能市场。你可以:
- 发布自己创建的技能
- 浏览最热门的技能
- 按名称、类型搜索
- 隐藏可疑技能
⚠️ 安全警告:安全研究人员在 ClawHub 上发现了 300 多个恶意技能。近一半的受检技能至少存在一个安全隐患。下载量高并不意味着它就安全。
在下载任何技能之前,请务必查看技能页面上的 VirusTotal 报告。如果某个技能请求了它不应该需要的权限(比如一个记笔记的技能需要网络访问权限),这绝对是一个危险信号。
通过 Telegram 安装技能
设置好 Telegram 后,你可以点击斜杠,输入 clawhub 并运行该命令,然后搜索技能。你也可以让机器人帮你检查代码:“先运行安全扫描,检查代码,看看它是否可信。”
08 安装第一个 Skill:Google Workspace(GOG)
GOG 是最多人想安装的技能,因为它能将 OpenClaw 连接到你的整个 Google Workspace。
步骤:
- 让机器人安装这个技能
- 按照提示进行 Google 端的 OAuth 设置
Google Cloud Console 设置
-
打开 Google Cloud Console,登录你的 Google 账号
-
创建新项目(命名为 OpenClaw)
-
选择项目,启用 API 和服务
-
搜索并启用 Gmail、Calendar、Drive、Sheets、Docs、Contacts API
-
配置 OAuth 同意屏幕:
- 应用名称:OpenClaw
- 用户支持邮箱:你的邮箱
- 受众:外部
- 添加测试用户(你的邮箱)
-
创建 OAuth 凭据:
- 应用程序类型:桌面应用程序
- 命名后创建
- 下载 JSON 文件
-
返回 Telegram,将 JSON 文件作为附件添加,并说:“我已经为所有 Google Workspace 服务启用了 API 并配置了 OAuth。这是我的客户端密钥 JSON 文件。请连接我的 Google 帐户。”
机器人会引导你完成授权,最终连接成功。
测试:
- 写入测试:“在 3 月 6 日星期五下午 12:00 在我的日历中添加与 John Smith 的会议。”
- 读取测试:“我周三的日程安排是什么?”
现在你的 OpenClaw 可以访问你的 Google Workspace 了。
09 记忆、身份与工作区
OpenClaw 的真正强大之处在于它的 Workspace。与大多数 AI 工具不同,你可以读取和编辑你的机器人所了解的关于你的一切——它们都只是文件夹中的 Markdown 文件。
三个最重要的文件
| 文件 | 作用 |
|---|---|
| Agents.md | 定义机器人的行为规则(“发送邮件前务必确认”、“优先使用简短回复”等) |
| Soul.md | 决定机器人的个性和身份 |
| User.md | 关于你的信息(姓名、时区、工作环境、偏好等) |
简单来说:
- 机器人的行为由 Agents 决定
- 机器人的身份由 Soul 决定
- 你的身份由 User 决定
Memory 文件夹存储长期重要的信息——本质上是一个每日更新的交互日志。
如何读取或编辑这些文件
直接询问机器人:
- “显示 Soul.md 的内容”
- “在 Agents.md 文件中添加一条规则:发送邮件前务必确认”
它会读取文件、编辑并保存——完全不需要任何终端知识。
快速更新:直接告诉机器人你想更改的信息,如“我的时区是 UTC+8”。把较长的对话留给那些难以自我评估的内容,例如“请就我的沟通偏好采访我,并将您了解到的信息更新到 User.md 文件中。”
优化设置
告诉机器人:“启用压缩内存刷新和会话内存。”
- 内存刷新:当长时间的对话达到上下文限制时,机器人会在压缩之前将重要细节保存到磁盘
- 会话记忆:允许上下文在对话之间传递,使机器人能够随着时间的推移不断学习
10 Heartbeat 与 Cron 任务
这是 OpenClaw 从聊天机器人转变为真正助手的关键。
Cron 任务(定时任务)
机器人在设定的时间自动执行某些操作,无需你手动操作。
示例:“创建一个每日任务。每天早上 7:00,查看巴黎天气,查看我当天的 Google 日历,扫描我的 Gmail 邮件,并向我发送一份包含当天重要事项的 Telegram 汇总。”
Heartbeat(心跳机制)
以较短的固定间隔唤醒并检查某些内容。
⚠️ 常见错误:人们把所有东西都放在心跳文件中(检查邮件、查看日历、更新记忆、研究昨天提到的事)。这会疯狂消耗令牌,因为心跳机制每 30 分钟运行一次,每次运行都会加载完整的上下文窗口。
指南:
- 在特定时间运行 → 使用 Cron 任务(每日简报、每周回顾、提醒)
- 需要持续监控 → 使用 Heartbeat(紧急情况通知)
要启用心跳功能,只需输入:“Enable Heartbeat.md”。它会监控即将到来的日历事件和新邮件,仅在需要关注时才提醒。
💡 如果心跳功能每 30 分钟运行一次,并且使用的是昂贵型号,费用会相当可观。请确保日常检查任务使用更经济的型号。
11 模型选择与成本优化
模型层级
| 层级 | 特点 | 示例 |
|---|---|---|
| Tier 1 | 最昂贵但最强大 | Claude Opus、GPT-5.2 Pro |
| Tier 2 | 价格稍低,足够日常任务 | Claude Sonnet、GPT-5.2 普通版 |
| Tier 3 | 最便宜,速度快 | Claude Haiku、GPT-5.2 Mini(价格仅为 Opus 的 1/25) |
| 免费模型 | 速度较慢,或需要本地运行 | Kimi K2.5(NVIDIA 提供)、Ollama 本地模型 |
成本构成
- VPS 费用:每月 5-12 美元(固定、可预见)
- API 费用:取决于使用的模型
- 预算型:5-20 美元/月
- 中档标准型:30-80 美元/月
- 顶级旗舰型:100-300 美元/月或更高
成本陷阱:
- 不要把 Tier 1 模型用在所有事情上——每次提示 2-6 美元,一天很容易花掉 40-120 美元
- 避免重试循环——卡住的任务可能在一夜之间耗尽积分
- 避免在昂贵模型上运行心跳包——每 30 分钟一次,一天约 50 次 API 调用
核心原则:使用功能强大的模型进行思考,使用价格低廉的模型进行执行。
12 添加 API 密钥与智能模型路由
添加 API 密钥
永远不要把 API 密钥粘贴到与机器人的对话中。 相反:
- 前往 Hostinger 控制面板
- 打开 Docker 管理器,打开你的项目
- 滚动到页面底部,打开“环境”下拉菜单
- 点击“+ 环境”,添加新密钥(例如
OPENAI_API_KEY) - 粘贴密钥值,点击“保存并部署”
部署完成后,向机器人确认:“我添加了一个 OpenAI API 密钥。你能看到并使用它吗?” 如果它看不到,可能需要重启网关。
设置智能路由规则
“默认始终使用 Claude Sonnet,如果不可用则回退到 ChatGPT 5.2。 对于编码任务,使用 Opus,并将 ChatGPT 5.1 Codex 作为备用模型。 对于任何常规任务,使用 Haiku,如果不可用则回退到 ChatGPT 5 Mini,然后是 4.1。 使用 Opus 进行规划和复杂推理,然后通过子代理将执行委托给更便宜的模型。 运行任务时,告诉我你正在使用哪个模型。 将此保存为永久规则。”
机器人会更新配置并保存新规则。可能需要重启 OpenClaw 网关才能使更改生效。
切换模型
- 询问机器人:“显示我当前的模型配置”
- 在 Telegram 中运行
/model命令查看当前运行的模型 - 运行
/model命令,点击“浏览提供商”,选择可用的提供商和特定模型
13 免费备用模型
建议至少设置一个免费模型作为最终备用模型,例如:
- Kimi K2.5:通过 NVIDIA 的免费 API 使用
- Ollama 本地模型:如果使用更大的 VPS
如果付费 LLM 积分用完、付费提供商故障或达到速率限制,没有备用模型时机器人会静默失败——你不会收到任何错误消息,它只是停止运行。有了免费备用模型,至少机器人可以告诉你出现了问题。
要设置 Kimi K2.5:从 NVIDIA 获取 API 密钥,将其作为环境变量添加到 Docker 管理器,告诉机器人将其用作最终备用模型。
14 语音模式
启用音频转录
告诉机器人:“请在设置中启用音频转录,这样我就可以给你发送语音消息,你也能听懂。”
机器人会使用 OpenAI Whisper 或 FFmpeg 添加音频转录功能。
启用文本转语音
告诉机器人:“设置 Edge TTS 的语音回复功能,这样当我发送语音备忘录时你就可以回复了。”
Edge TTS 完全免费,支持 74 种语言的 300 多种语音,并且可以在 Docker 容器中运行。
设置完成后,你可以发送语音消息,机器人会用语音回复你。
15 子代理(Subagents)
当你需要同时完成大量工作,或需要按特定顺序完成一系列任务时,可以让 OpenClaw 启动多个子代理来处理工作的不同部分。
示例:“同时研究这三个 AI 助手平台并进行比较:n8n、Zapier、Make.com。分别研究每个平台的功能、定价以及一个主要局限性。然后将所有信息汇总到一个表格中。使用子代理同时研究这三个平台。”
网络搜索权限:要使用子代理进行网络研究,需要设置 Brave Search API:
- 注册 Brave Search API 账号
- 添加付款方式(每月有 5 美元免费额度)
- 生成 API 密钥
- 添加到 Hostinger 环境变量(
BRAVE_API_KEY) - 告诉机器人:“我已经授予您 BRAVE_API_KEY。请继续。”
机器人会生成三个子代理同时运行,完成后向主代理汇报结果。
子代理可以变得更加复杂——例如,一个子代理进行市场调研,将信息传递给另一个子代理进行财务分析,最后传递给第三个子代理撰写报告。
16 更新与恢复
更新 OpenClaw
在 Telegram 中直接告诉机器人“检查更新”。如果找到更新,机器人会询问是否运行更新,你可以直接选择“是”。更新完成后,重启以应用更改。
你也可以通过 Hostinger Docker 管理器直接更新:找到你的 OpenClaw 项目,点击项目旁边的三个点,然后点击“更新”。
恢复
如果机器人开始执行不应该执行的操作:
- 尝试告诉机器人“立即停止所有进程”
- 如果不行,在 Hostinger 中点击项目旁边的三个点,然后点击“停止”
- 如果还不行,在 AI 控制面板中撤销 API 密钥——机器人会立即停止
从备份恢复:
- 在 Hostinger 控制面板中,转到“备份和监控”→“快照和备份”,从自动备份恢复
- 如果知道即将进行的更改可能会破坏配置,建议先创建快照(即时备份)
17 结语
你刚刚从零开始,创建了一个功能齐全的 AI 助手:
- 部署在你自己的服务器上
- 连接到 Telegram
- 集成到 Google 应用
- 具备定时自动化、智能模型路由和完善的安全防护措施
从简单的开始:
- 向它提问
- 给它一些小任务
- 让它了解你
- 一旦你觉得它足够好,再逐步扩展
现在,你的 24/7 全天候 AI 助手已经就绪,它会主动为你做事。
观看完整视频:OpenClaw Ultimate Guide: 24/7 AI Assistant
开始使用 OpenClaw:openclaw.ai
ClawHub 技能市场:clawhub.ai
GitHub:github.com/openclaw/openclaw
—— 本文基于 OpenClaw 终极入门指南视频整理而成。