OpenClaw 新手教程：30 分钟从零搭建你的第一个 AI Agent

大多数 OpenClaw 教程一上来就是一堆理论。这篇直接从终端开始。

读完这篇指南——大约 30 分钟——你会有一个运行中的 OpenClaw Agent，有自己的人格，连着 Telegram，做一件真正有用的事：每天早上给你发一份个性化新闻简报。

不需要 OpenClaw 经验。能 SSH 到服务器、会复制粘贴命令就行。

OpenClaw 是什么？

OpenClaw 是一个开源 AI Agent 平台，把大语言模型（Claude、GPT、Gemini 等）变成运行在你服务器上的自主 Agent。不像聊天机器人对话结束就忘光，OpenClaw Agent 有持久记忆，能读写文件、执行 Shell 命令、浏览网页，还能和其他 Agent 协作。

这么理解：ChatGPT 是一次对话，OpenClaw 是一个员工。它有工作空间，记得昨天发生了什么，按你写在 markdown 文件里的指令行事，能使用各种工具——从发 Telegram 消息到部署代码。它 24/7 运行在你的机器上，所有数据归你。没有供应商锁定，除非你主动，数据不会离开你的服务器。

平台有 285,000+ GitHub stars，ClawHub 上有越来越多的 Skill（插件）。

开始前你需要什么

一台服务器 — VPS（DigitalOcean、Hetzner、AWS）、树莓派或任何 Linux 机器。最低 1GB 内存、10GB 硬盘。推荐 Ubuntu 22.04+。
一个 API Key — 来自 Anthropic（Claude）、OpenAI（GPT）或 Google（Gemini）。推荐 Anthropic Claude。在 console.anthropic.com 注册并充值 $10。
一个 Telegram 账号 — 用来连接你的 Agent（本教程用 Telegram，WhatsApp、Discord、Slack 也支持）。
10–30 分钟 — 取决于你的服务器速度。

总启动成本：第一个月大约 $5–$15（API token + VPS）。

第一步：安装 OpenClaw

SSH 到你的服务器，运行一行命令：

curl -fsSL https://openclaw.ai/install.sh | bash

这个脚本会自动检测 Node.js 版本（没有的话安装 Node 24）、通过 npm 全局安装 OpenClaw、启动引导向导。

如果你更喜欢手动安装：

# 安装 Node.js 24
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo bash -
sudo apt-get install -y nodejs

# 全局安装 OpenClaw
npm install -g openclaw@latest

# 运行引导向导
openclaw onboard --install-daemon

引导向导会问几个问题：

你的名字 — 填名就行
API 提供商 — 选 Anthropic（推荐）、OpenAI 或 Google
API Key — 粘贴你的 Key
默认模型 — Claude Sonnet 对新手来说是速度和质量的最佳平衡

完成后，OpenClaw 在 ~/.openclaw/workspace/ 创建你的工作空间并启动网关守护进程。

验证一切正常：

openclaw gateway status

应该看到类似：

Gateway is running (PID: 12345)

没运行的话启动它：

openclaw gateway start

第二步：配置 Agent 人格（SOUL.md）

这是 OpenClaw 有趣的地方。Agent 的行为由工作空间里的 markdown 文件定义。最重要的是 SOUL.md——它定义了你的 Agent 是谁。

打开文件：

nano ~/.openclaw/workspace/SOUL.md

替换默认内容：

# Soul: 每日简报助手

## 性格

你是一个敏锐、高效的个人助手。沟通清晰简洁。
不废话、不注水——只说重要的信息。

## 价值观

- 准确优先于速度——能查证的绝不猜测
- 简洁——先说关键结论，需要时再展开
- 主动——发现重要的事就提醒

## 沟通风格

- 列表用要点符号
- 加粗最重要的结论
- 除非被要求，回复控制在 300 字以内
- 用大白话——用户不用术语你也别用

## 你的职责

- 每天发送用户关心的话题的新闻简报
- 总结文章和报告
- 追踪和提醒特定话题或关键词
- 回答问题并附上来源

保存退出（nano 里按 Ctrl+X，然后 Y，然后 Enter）。

SOUL.md 的美妙之处在于它就是文本。你可以随时迭代 Agent 的人格——不需要改代码、不需要重新部署。编辑文件，Agent 下次对话就会用新人格。

第三步：连接 Telegram

给你的 Agent 一个和你对话的渠道。Telegram 是最容易设置的。

创建 Telegram Bot：

打开 Telegram，搜索 @BotFather
发送 /newbot
选一个名字（比如 "我的 OpenClaw Agent"）
选一个用户名（比如 my_openclaw_bot）
BotFather 会给你一个 token——复制它

把 Bot 连接到 OpenClaw：

openclaw channel add telegram

向导会要求你输入 bot token，粘贴进去。

然后重启网关：

openclaw gateway restart

现在打开 Telegram，找到你的 bot，发一条消息：

你好！你是谁？

Agent 应该会根据你在 SOUL.md 里定义的人格回复。如果回复了——恭喜，你有了一个运行中的 AI Agent。

第四步：搭建第一个实用功能——每日新闻简报

能回消息的聊天机器人不错，但让它主动做点有用的事更好。

我们来设置一个每天早上 8 点自动发送的新闻简报。

创建心跳配置：

nano ~/.openclaw/workspace/HEARTBEAT.md

添加内容：

# 早间简报（8:00 AM）

如果现在是本地时间 7:50 到 8:10 之间，且今天的简报还没发：

1. 搜索以下话题的最新新闻：
   - AI 和机器学习最新进展
   - 开源软件动态
   - 科技行业商业新闻

2. 从过去 24 小时中选出 5 条最重要的

3. 每条写：
   - 一行标题
   - 2-3 句摘要
   - 为什么重要

4. 通过 Telegram 发给我

5. 发送后在 memory/heartbeat-state.json 记录今天已发送

如果不是简报时间，回复 HEARTBEAT_OK。

配置心跳定时：

openclaw cron add --schedule "*/30 * * * *" --task "heartbeat"

Agent 每 30 分钟检查一次。到了 8 点的窗口，它会搜索新闻、编写简报、发到你的 Telegram。

自定义话题——编辑 HEARTBEAT.md，把示例话题换成你真正关心的：加密货币、行业新闻、竞品动态、体育比分，随你。

第五步：验证一切正常

# 检查网关运行状态
openclaw gateway status

# 检查渠道
openclaw channel list

# 检查定时任务
openclaw cron list

在 Telegram 上给 Agent 发条测试消息：

给我总结一下今天 AI 领域的最新动态。

如果它搜索了网页并返回摘要，你的设置就完成了。明天早上简报就会自动到达。

快速排错

Agent 在 Telegram 上不回复：

检查 openclaw gateway status——需要的话重启
用 openclaw channel list 验证 bot token
查日志：openclaw gateway logs --tail 50

"API key invalid" 错误：

重新运行 openclaw onboard 更新 API key
确认 API 账户有余额

Agent 回复但很泛泛：

确认 SOUL.md 保存正确
检查文件：cat ~/.openclaw/workspace/SOUL.md
Agent 在每次会话开始时读取 SOUL.md

API 费用太高：

日常任务换小模型（Claude Haiku 做每日简报）
在配置中设置 token 限制
监控用量：openclaw status

接下来做什么？

你现在有了一个运行中的 OpenClaw Agent——有人格、连着 Telegram、每天发新闻简报。这是基础，接下来可以：

从 ClawHub 安装 Skill — 浏览 clawhub.com 获取预置能力
开发自己的 Skill — 阅读我们的 Skill 创建指南
添加更多渠道 — 在 Telegram 之外连接 WhatsApp、Discord 或 Slack
搭建多 Agent 团队 — 创建专业化 Agent 协作处理复杂任务
探索变现 — 看我们的 OpenClaw 赚钱指南

OpenClaw 文档在 docs.openclaw.ai，Discord 社区也非常活跃。

欢迎来到 OpenClaw 生态。你的 Agent 准备好了，现在让它干活吧。

常见问题

运行 OpenClaw 每月要花多少钱？

OpenClaw 本身免费开源。你付 API token（AI 模型）和主机费用。典型配置每月 $20–$50——基础 VPS $5–$15，API token $15–$35。轻度使用（每日简报 + 偶尔提问）API 费用大约 $10–$15/月。

该用哪个 AI 模型？

新手推荐 Claude Sonnet（Anthropic），质量、速度和成本的最佳平衡。Claude Haiku 更便宜，适合简单任务。GPT-4o（OpenAI）也不错。随时可以换模型，不需要重装。

能在树莓派上跑吗？

可以。树莓派 4 或 5（4GB+ 内存）跑 OpenClaw 没问题。比 VPS 稍慢，但完全够用。很多人用它做 24/7 个人 Agent。

数据安全吗？

OpenClaw 跑在你的服务器上。对话、文件和记忆都在你的机器上。唯一的外部通信是和你选的 AI 提供商（Anthropic、OpenAI 等）的模型推理。没有数据发送到 OpenClaw 的服务器。

不用 VPS 能跑吗？

可以——任何保持开机的电脑都行。Mac Mini、旧笔记本、树莓派都可以。关键是机器需要运行着 Agent 才可用。要 24/7 可用，推荐 VPS 或专用设备。

想从 Telegram 换到 WhatsApp 怎么办？

可以同时运行多个渠道。用 openclaw channel add whatsapp 添加 WhatsApp，Agent 在两个渠道都可用，共享同一个人格和记忆。