OpenClaw 快速入门:从安装到第一个自动化任务

前言

在 AI Agent 工具遍地开花的今天,如何选择一个既能掌控数据主权,又能无缝集成现有工作流的解决方案,是每个技术决策者必须面对的问题。OpenClaw 作为一个开源的、自托管的 AI 网关,提供了一个值得关注的选项。

本文将从架构设计、快速部署、通道配置到自动化实战,带你完整体验 OpenClaw 从安装到第一个生产级自动化任务的全过程。

一、OpenClaw 是什么?

OpenClaw 本质上是一个消息网关 + AI Agent 框架。它的核心价值在于:

  • 多通道支持:WhatsApp、Telegram、Discord、飞书等 20+ 平台
  • 自托管架构:数据完全掌控,无需担心隐私泄露
  • 技能扩展:通过 Skills 机制无限扩展 AI 能力
  • 定时任务:内置 Cron 引擎,支持自动化工作流

与 ChatGPT、Claude 等云端服务不同,OpenClaw 运行在你自己的服务器上,AI 模型调用只是其中一个环节,真正的价值在于消息路由 + 任务编排 + 数据持久化的完整闭环。

二、架构解析

OpenClaw 的核心组件包括:

1. Gateway(网关层)

负责消息的收发和路由,支持 WebSocket 和 REST API 两种模式。默认监听 18789 端口,可通过配置文件自定义。

2. Agent(代理层)

AI 对话的核心,支持多模型切换(Qwen、GPT、Claude 等)。每个会话独立维护上下文,支持记忆搜索和长期记忆。

3. Skills(技能层)

类似于插件系统,但更灵活。每个 Skill 是一个独立的功能模块,可以调用外部 API、操作文件、执行命令等。

4. Cron(定时任务)

内置的定时任务引擎,支持标准 Cron 表达式。任务可以触发 Agent 执行任意操作,并通过消息通道推送结果。

三、快速部署

环境要求

  • Node.js >= 22
  • 内存 >= 4GB(推荐 8GB)
  • 磁盘 >= 500MB

安装步骤

# 1. 全局安装
npm install -g openclaw

# 2. 运行配置向导
openclaw onboard --install-daemon

# 3. 启动 Gateway
openclaw gateway start

# 4. 验证状态
openclaw gateway status

向导会自动完成以下配置:

  • 模型提供商(推荐阿里云百炼)
  • 消息通道(Telegram/飞书等)
  • 工作区目录
  • Skills 白名单

四、配置第一个通道:以飞书为例

1. 创建飞书应用

  1. 访问 飞书开放平台
  2. 创建企业自建应用
  3. 获取 App ID 和 App Secret
  4. 配置机器人权限(消息、群组等)

2. 配置 OpenClaw

编辑 ~/.openclaw/openclaw.json

"channels": {
  "feishu": {
    "enabled": true,
    "accounts": {
      "main": {
        "appId": "cli_xxx",
        "appSecret": "xxx",
        "botName": "AI 助手"
      }
    }
  }
}

3. 重启 Gateway

openclaw gateway restart

现在,你可以通过飞书机器人与 AI 对话了。

五、实战:创建第一个自动化任务

我们来创建一个每天早上 8 点推送新闻简报的自动化任务。

1. 编辑定时任务配置

编辑 ~/.openclaw/cron/jobs.json

{
  "name": "每日新闻简报",
  "schedule": {
    "kind": "cron",
    "expr": "0 8 * * *",
    "tz": "Asia/Shanghai"
  },
  "payload": {
    "text": "请收集昨日重要新闻,整理成 500 字简报,通过 message 工具发送到飞书。"
  }
}

2. 重启 Gateway 使配置生效

openclaw gateway restart

3. 验证任务

# 查看任务列表
cat ~/.openclaw/cron/jobs.json | python3 -c "import json,sys; d=json.load(sys.stdin); print(f'任务数:{len(d["jobs"])}')"

# 查看日志
grep cron /tmp/openclaw/openclaw-*.log

第二天早上 8 点,你就会收到自动推送的新闻简报。

六、进阶技巧

1. Skills 管理

通过 ClawHub(https://clawhub.ai)可以安装官方和社区 Skills。推荐必装:

  • web-search:网络搜索
  • web-fetch:网页抓取
  • browser:浏览器自动化
  • message:消息推送

2. 多实例部署

可以为不同用途创建多个 Gateway 实例,每个实例独立配置端口和数据目录。

3. 记忆搜索

配置嵌入模型后,AI 可以跨会话检索历史对话,实现真正的”长期记忆”。

七、常见问题

Q:Gateway 启动失败?
A:检查端口占用(lsof -i :18789),或更换端口。

Q:消息发不出去?
A:检查通道配置,确认 Bot Token/App Secret 正确。

Q:Skills 不识别?
A:检查 Skills 白名单配置,重启 Gateway。

总结

OpenClaw 的核心价值在于可控性扩展性。通过自托管架构,你完全掌控数据和流程;通过 Skills 和定时任务,可以构建复杂的自动化工作流。

对于技术团队来说,OpenClaw 不仅是一个 AI 助手,更是一个自动化基础设施。从简单的消息推送,到复杂的多步骤工作流,OpenClaw 都能胜任。

下一步,建议深入阅读官方文档,探索更多高级功能。

参考资源

  • 官方文档:https://docs.openclaw.ai
  • GitHub:https://github.com/openclaw/openclaw
  • ClawHub 技能市场:https://clawhub.ai
  • Discord 社区:https://discord.gg/clawd

AI 自动化工作流搭建指南:让 AI 24 小时自动干活

什么是 AI 自动化工作流?

简单说,就是让 AI 在特定时间、特定条件下,自动执行特定任务,不需要你每次都手动触发。

比如:每天早上 8 点自动推送市场简报,股价波动超 5% 自动提醒,每周自动整理工作周报。

核心组件

OpenClaw 自动化 = Cron(定时) + Message(推送) + Skill(技能)

实战案例 1:每日市场简报

需求

每天早上 8 点自动推送黄金和美股行情

配置步骤

  1. 编辑 cron 配置:/root/.openclaw/cron/jobs.json
  2. 添加任务:
    {
      "name": "每日市场简报",
      "schedule": {
        "kind": "cron",
        "expr": "0 8 * * *",
        "tz": "Asia/Shanghai"
      },
      "payload": {
        "text": "请生成并推送每日市场简报。完成后调用 message 工具(channel=feishu, accountId=main, target=user:xxx)发送。"
      }
    }
  3. 重启 Gateway:openclaw gateway restart

实战案例 2:股价波动监控

需求

交易日每 2 小时检查持仓股,波动超 5% 主动提醒

配置步骤

  1. 安装 Stock-Watcher Skill
  2. 配置持仓列表
  3. 添加 cron 任务:
    "expr": "30 9,11,13,15 * * 1-5"
  4. 设置阈值:±5%

实战案例 3:自动备份

需求

每天凌晨 3 点自动备份网站和数据库

配置步骤

  1. 创建备份脚本:/root/scripts/backup.sh
  2. 添加系统 cron:
    0 3 * * * /root/scripts/backup.sh
  3. 配置邮件通知(可选)

实战案例 4:RSS 订阅推送

需求

监控特定 RSS,有新文章自动推送摘要

配置步骤

  1. 安装 RSS 监控 Skill(需自定义)
  2. 配置订阅源列表
  3. 设置检查频率(如每 30 分钟)
  4. 配置推送规则

最佳实践

1. 任务命名规范

✅ 每日市场简报
❌ 任务 1

2. 错误处理

配置失败重试机制,重要任务配置失败通知

3. 日志记录

每个自动化任务都要有日志,方便排查问题

4. 逐步上线

先手动测试,再定时执行,最后全自动

常见问题

Q:定时任务不执行?
A:检查 Gateway 是否运行,查看 cron 日志

Q:消息发不出去?
A:检查 accountId 配置,确认通道正常

Q:任务执行失败?
A:查看任务日志,确认 Skill 正常

进阶玩法

  • 多条件触发(时间 + 事件)
  • 任务链(A 完成后触发 B)
  • 条件分支(根据结果执行不同任务)
  • 外部 API 集成(webhook)

写在最后

自动化不是一蹴而就的,从最简单的任务开始,慢慢搭建你的自动化帝国。

记住:好的自动化,是让你感觉不到它的存在,但它一直在默默为你工作。

下一篇

《大模型 API 对比评测》—— 主流大模型性价比分析

OpenClaw 常见坑点与解决方案:新手避坑指南

踩坑实录

装 OpenClaw 一个月,踩过的坑比你走过的桥还多(夸张了)。但这些都是真金白银换来的经验,今天全部整理给你,帮你避开 90% 新手都会踩的坑。

坑点 1:Gateway 启动失败

现象:openclaw gateway start后提示端口占用

原因:18789 端口已被占用(可能是之前的实例没关)

解决:

# 查看占用端口的进程
sudo lsof -i :18789

# 杀掉进程
sudo kill -9 <PID>

# 或者更换端口
openclaw config set gateway.port 18790

坑点 2:Skill 安装后不识别

现象:安装了 Skill,但 AI 说找不到

原因:Skill 描述写得太模糊,AI 不知道什么时候用

解决:用 Skill-Creator 重新生成,或者手动编辑 SKILL.md,把description写清楚

坑点 3:记忆功能失效

现象:AI 记不住对话内容

原因:嵌入模型未配置

解决:

# 检查记忆配置
openclaw memory status

# 配置嵌入模型(可选,不用也可以)
openclaw configure --section memory

其实不配置嵌入模型也能用,只是不能语义搜索而已。

坑点 4:飞书消息发不出去

现象:定时任务执行了,但没收到消息

原因:message 工具用了错误的账户(default 而不是 main)

解决:在 prompt 里明确指定accountId=main

调用 message 工具(channel=feishu, accountId=main, target=user:xxx)

坑点 5:股票监控数据不准

现象:港股代码用了 A 股格式

原因:股票代码格式错误

解决:A 股用600036.SH,港股用00941.HK

坑点 6:定时任务不执行

现象:配置了 cron,但到点没反应

原因:Gateway 没运行或 cron 模块未加载

解决:

# 检查 Gateway 状态
openclaw gateway status

# 查看 cron 日志
grep cron /tmp/openclaw/openclaw-*.log

坑点 7:web_search 报错

现象:missing_brave_api_key

原因:未配置 Brave Search API Key

解决:

openclaw configure --section web
# 输入 API Key(https://brave.com/search/api/)

坑点 8:中文乱码

现象:输出中文是乱码

原因:系统 locale 未配置

解决:

export LANG=zh_CN.UTF-8
export LC_ALL=zh_CN.UTF-8

避坑建议

  1. 先看日志:出问题第一反应应该是看日志,不是重启
  2. 逐步配置:不要一次装一堆东西,出一个问题都找不到原因
  3. 定期备份:配置文件和数据库都要备份
  4. 善用搜索:大部分问题别人都遇到过

写在最后

踩坑是正常的,不踩坑才不正常。关键是踩完要记下来,下次别再踩。

如果你也遇到了什么坑,欢迎在评论区分享,让更多人少踩坑。

下一篇

《AI 自动化工作流搭建指南》—— 手把手教你让 AI 24 小时自动干活

必备 Skills 推荐 Top 10:让 AI 助理效率翻倍

为什么需要 Skills?

装完 OpenClaw 只会聊天?那你可能只用了它 10% 的能力。Skills 才是让 AI 助理真正帮你干活的关键。

简单说:Skill = AI 能学会的本事。每个 Skill 都让 AI 多一项技能,装得越多,AI 越能干。

新手必装 Top 10

1. Summarize(文档摘要)⭐⭐⭐⭐⭐

用途:快速总结 PDF、网页、会议记录、论文

场景:老板发了 50 页报告让你总结要点;看到好文章想快速了解核心内容

安装:openclaw skill install summarize

2. Tavily(AI 搜索)⭐⭐⭐⭐⭐

用途:智能网页搜索,返回结构化结果

场景:查技术资料、找最新信息、验证某个说法

安装:openclaw skill install tavily

需要:免费 API Key(https://tavily.com)

3. Weather(天气)⭐⭐⭐⭐

用途:自动查天气、发提醒

场景:每天早上推送天气和穿衣建议;出差前查目的地天气

安装:openclaw skill install weather

特点:无需 API 密钥,开箱即用

4. ClawHub(技能市场)⭐⭐⭐⭐

用途:浏览和安装更多技能

场景:找特定功能的技能;查看技能评价

地址:https://clawhub.ai

5. Stock-Watcher(股票监控)⭐⭐⭐⭐

用途:跟踪持仓股票,超 5% 波动主动提醒

场景:上班族没时间看盘;想及时知道持仓异动

安装:openclaw skill install stock-watcher

6. Healthcheck(系统体检)⭐⭐⭐⭐

用途:定期检查系统状态、安全审计

场景:每周自动检查服务器状态;安全合规检查

安装:openclaw skill install healthcheck

7. Web-Search(网页搜索)⭐⭐⭐

用途:多引擎搜索(Google、Bing 等)

场景:需要多来源验证信息;查找特定网站内容

安装:openclaw skill install web-search

8. News-Summary(新闻摘要)⭐⭐⭐

用途:每日新闻简报,自动推送

场景:早上推送当日要闻;定制感兴趣的新闻类别

安装:openclaw skill install news-summary

9. PDF-Text-Extractor(PDF 提取)⭐⭐⭐

用途:从 PDF 提取文字,支持 OCR

场景:扫描版 PDF 转文字;批量处理 PDF 文档

安装:openclaw skill install pdf-text-extractor

10. Skill-Creator(技能创建)⭐⭐⭐

用途:帮你创建自定义技能

场景:有特定需求但找不到现成技能;想分享自己的技能

安装:openclaw skill install skill-creator

安装建议

第 1 天:Summarize + Tavily + Weather(最常用)

第 2 天:ClawHub + Stock-Watcher(按需)

第 3 天:其他技能(根据需求选择)

注意事项

  • 不要一次装太多,用得上再装
  • 部分 Skill 需要 API Key(如 Tavily)
  • 定期清理不用的 Skill

下一篇

《OpenClaw 常见坑点与解决方案》—— 帮你避开 90% 新手都会踩的坑

OpenClaw 安装配置实战:从 0 到 1 打造你的专属 AI 助理

为什么你需要 OpenClaw?

你是不是也有这样的经历:

  • 装了一堆 AI 工具,最后都成了摆设
  • ChatGPT 虽好,但记不住你的喜好
  • 想要一个 24 小时待命的专属助理,而不是高级聊天框

如果你中了以上任何一条,那么 OpenClaw 就是为你准备的。

OpenClaw 不是另一个聊天机器人,它是一个可以真正帮你干活的 AI 助理。

它能记住你的偏好、自动执行任务、连接各种工具,越用越懂你。更重要的是,它是开源的,完全掌握在你自己手里。

安装前的准备

系统要求

  • 操作系统:Linux(推荐 Ubuntu 20.04+)、macOS、Windows(WSL2)
  • 内存:至少 4GB(推荐 8GB+)
  • 磁盘:至少 500MB 可用空间
  • 网络:需要访问外网(部分技能需要)

前置软件

# 安装 Node.js(v20+)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

# 验证安装
node --version
npm --version

正式安装步骤

第一步:安装 OpenClaw

# 全局安装 OpenClaw
sudo npm install -g openclaw

# 验证安装
openclaw --version

看到版本号就说明安装成功了。

第二步:初始化配置

openclaw wizard

按照提示完成配置。

第三步:启动 Gateway

openclaw gateway start
openclaw gateway status

关键配置:让 AI 记住你是谁

在飞书或 Telegram 中发送以下信息:

我叫 [你的名字],在 [城市] 做 [职业]。
我平时不喜欢太正式的说话方式。
以上内容请永久记住,这是我的基本个人信息。

必装 Skills 推荐

  1. Summarize – 文档摘要
  2. Weather – 天气查询
  3. ClawHub – 技能市场
  4. Tavily – AI 搜索
  5. Stock-Watcher – 股票监控
  6. Healthcheck – 系统体检

常见问题

Q1: Gateway 启动失败

检查端口占用:sudo lsof -i :18789

Q2: Skill 安装失败

检查技能名称和网络连接。

写在最后

记住:所有的高手,都是从「让 AI 先跑起来」这一步开始的。

下一篇预告:《必备 Skills 推荐 Top 10》