想象一下:有一个 AI 助手,24/7 在线,能帮你查邮件、看日历、发推特、甚至帮你写代码。不是 ChatGPT,不是 Claude,而是一个真正属于你的 AI Agent。

这不是科幻。这是 OpenClaw。

今天,我们用 5 分钟搭建你的第一个 AI Agent。


什么是 OpenClaw?

OpenClaw 是一个开源的个人 AI 网关。把它跑在你的服务器上,它就能:

  • 📧 自动检查 Gmail
  • 📅 管理 Google Calendar
  • 🐦 发布 Twitter 动态
  • 💬 整合 Telegram/WhatsApp/Signal
  • 🔍 网页搜索、浏览器自动化
  • 🤖 部署自定义 Agent 技能

核心区别:

  • ChatGPT/Claude:别人家的 AI,每次都要重新说背景
  • OpenClaw:你的 AI,长期记忆,自动化任务

准备工作

需要什么?

  1. 一台服务器(VPS 即可)

    • 最低配置:1 核 1G 内存
    • 推荐:2 核 2G(跑多个 Agent)
    • 系统支持:Linux/macOS
  2. 一个域名(可选,但推荐)

    • 用于 Webhook 回调
    • 没有 IP 也行,但功能会受限
  3. API 密钥

    • OpenAI API Key(或 Anthropic/其他模型)
    • 需要的第三方服务(Gmail/Calendar/Twitter 等)

服务器推荐

如果你没有 VPS,可以参考:

  • 搬瓦工 BWGECN2:CN2 线路,国内速度快
  • LocVPS:性价比高,适合入门
  • 完整 VPS 推荐:见我们的《最佳 VPS 推荐 2026》

安装 OpenClaw

1. 安装 Node.js

OpenClaw 需要 Node.js 18+:

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证
node --version  # 应该显示 v20.x.x
npm --version

2. 安装 OpenClaw

# 安装 OpenClaw
npm install -g openclaw

# 初始化配置
openclaw init

初始化会问你:

  • 工作目录(默认 ~/clawd)
  • 域名(如果你有)
  • 默认模型(推荐 gpt-4o 或 claude-3-5-sonnet)

3. 配置 API 密钥

编辑配置文件:

cd ~/clawd
nano .env

添加你的 API Key:

# OpenAI API
OPENAI_API_KEY=sk-your-key-here

# 或 Anthropic
ANTHROPIC_API_KEY=sk-ant-your-key-here

4. 启动 Gateway

# 启动服务
openclaw gateway start

# 查看状态
openclaw status

✅ 恭喜!OpenClaw 已经在跑了。


配置你的第一个 Agent

5. 连接聊天渠道

OpenClaw 支持多个聊天平台。我们以 Telegram 为例:

# 创建 Telegram Bot
# 1. 在 Telegram 找 @BotFather
# 2. /newbot 创建你的 Bot
# 3. 复制 Token

# 编辑配置
nano ~/clawd/.env

添加:

# Telegram Bot Token
TELEGRAM_BOT_TOKEN=your-bot-token-here

# 允许的用户(你的 Telegram ID)
TELEGRAM_ALLOWLIST=123456789

重启 Gateway:

openclaw gateway restart

现在去 Telegram 找你的 Bot,发个 “Hi” 试试!


给 Agent 添加超能力

6. 启用 Gmail 集成

让 Agent 帮你检查邮件:

cd ~/clawd
openclaw channel add gmail

按提示完成 OAuth 认证。

现在你可以对 Agent 说:

  • “查下我的未读邮件”
  • “有来自 Jack 的邮件吗?“

7. 启用日历管理

openclaw channel add calendar

现在你可以:

  • “今天有什么安排?”
  • “明天下午 3 点提醒我开会”

8. 启用 Twitter 集成

openclaw channel add twitter

认证后,你可以:

  • “发推:今天天气真好”
  • “我最近 5 条推文是什么?“

自动化任务:设置 Heartbeat

想让 Agent 主动帮你做事?设置 Heartbeat:

创建 ~/clawd/HEARTBEAT.md:

# Heartbeat 任务

每 30 分钟检查一次:
- Gmail 未读邮件
- Google Calendar 未来 2 小时的事件
- Twitter 提及

如果发现重要事情,通知我。

OpenClaw 会在每次 Heartbeat 时读取这个文件,自己判断是否需要提醒你。

这就是 Agent 和聊天机器人的区别:

  • 聊天机器人:你问,它答
  • Agent:自己判断,主动行动

自定义 Agent 技能

OpenClaw 的真正威力:可编程的 Agent 技能(Skills)。

创建你的第一个 Skill

cd ~/clawd/skills
mkdir my-first-skill
cd my-first-skill

创建 SKILL.md:

# 每日新闻 Skill

每天早上 9 点,发送今日科技新闻摘要。

## 工具

- web_search: 搜索新闻

## 工作流

1. 搜索 "科技新闻 今日"
2. 总结前 5 条
3. 通过 Telegram 发送给用户

创建 script.sh:

#!/bin/bash
# 搜索今日科技新闻
openclaw web_search "科技新闻 $(date +%Y-%m-%d)" --count 5

重启 Gateway,Agent 就学会新技能了!


进阶:部署你的 Agent 应用

OpenClaw 可以部署成 Web 应用:

cd ~/clawd
openclaw deploy

这会:

  1. 打包你的 Agent
  2. 生成 Web UI
  3. 配置 Nginx 反向代理

你的 Agent 就有了自己的网页界面!


常见问题

Q: 需要编程基础吗?

A: 不需要。基础功能都是配置,高级功能需要简单脚本。

Q: 安全吗?

A: OpenClaw 开源,代码透明。API 密钥存在本地,不经过第三方服务器。

Q: 能跑在 Raspberry Pi 上吗?

A: 可以!4B 及以上型号都能跑。

Q: 支持哪些模型?

A: OpenAI、Anthropic、Google Gemini、xAI Grok、本地模型(Ollama)等。


下一步

现在你已经有了:

  • ✅ 运行中的 OpenClaw Gateway
  • ✅ 连接的 Telegram Bot
  • ✅ Gmail/Calendar 集成
  • ✅ 自动化 Heartbeat

接下来做什么?

  1. 深入学习:OpenClaw 技能开发实战:从零到一
  2. 生产部署:OpenClaw 生产环境部署指南
  3. 对比其他框架:OpenClaw vs LangChain:哪个更适合 Agent 开发?

总结

5 分钟,你做到了什么?

  • 🚀 部署了个人 AI 网关
  • 💬 创建了专属 AI 助手
  • 📧 整合了邮件/日历
  • 🤖 设置了自动化任务
  • 🔮 为未来扩展打下了基础

这只是开始。

OpenClaw 的真正威力在于:

  • 长期记忆:Agent 记得你所有对话
  • 多任务协作:多个 Agent 协同工作
  • 无限扩展:用 JavaScript/Python 写自己的技能

你想要什么样的 AI 助手?现在,你可以自己造一个。


开始你的 AI Agent 之旅:

npm install -g openclaw
openclaw init
openclaw gateway start

有问题?查看文档 或加入 Discord 社区。