用 OpenClaw 搭建个人 AI 助手：实战和避坑指南

技能名称：blog-manager# 功能：博客文章创建、编辑、发布## 能力1. create-post: 创建新文章2. update-post: 更新文章3. publish-post: 发布到 GitHub4. list-posts: 列出所有文章## 使用示例"title": "新文章标题","category": "技术分享",}'# 技能名称：code-reviewer# 功能：自动

davepython

376人浏览 · 2026-04-27 13:57:15

davepython · 2026-04-27 13:57:15 发布

2026 年 2 月开始接触 OpenClaw，用它搭建了自己的 AI 助手。这篇文章记录从零到一的完整过程。

🎯 项目背景

为什么需要 AI 助手

作为一名测试开发工程师，我每天需要处理：

重复性工作：测试报告整理、数据收集
信息管理：技术文章、待办事项、会议记录
学习追踪：新技术、新工具、新论文

人工处理效率低，容易遗漏。我想打造一个7x24 小时在线的 AI 助手。

为什么选择 OpenClaw

对比了几个方案后选择 OpenClaw：

方案	优点	缺点
Zapier	简单	贵，国内访问慢
n8n	开源	需要自己部署
OpenClaw	AI 原生，支持本地部署	学习曲线稍陡

🛠️ 环境搭建

1. 服务器准备

我选择了阿里云 SWAS 服务器：

配置：2 核 4G 40GB SSD
系统：Ubuntu 22.04
费用：约 200+ 元/年

2. 安装 OpenClaw

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

# 安装 OpenClaw
sudo npm install -g openclaw

# 启动服务
openclaw gateway start

3. 配置模型

我使用的是阿里云模型服务：

# 配置模型 API Key
openclaw config set modelstudio.api.key <your-api-key>

# 验证配置
openclaw status

📋 核心功能实现

功能 1：博客自动部署

需求：写完 markdown 后自动推送到 GitHub Pages

实现：

// cron 定时任务
{
  "name": "博客自动部署",
  "schedule": {
    "kind": "cron",
    "expr": "0 */6 * * *"  // 每 6 小时检查一次
  },
  "payload": {
    "kind": "agentTurn",
    "message": "检查博客源码更新，如有新文章则构建并推送"
  }
}

效果：写完文章后，6 小时内自动部署上线

功能 2：技术资讯聚合

需求：每天自动收集 AI 和测试领域的最新资讯

实现：

// 每日早 8 点执行
{
  "name": "技术早报",
  "schedule": {
    "kind": "cron",
    "expr": "0 8 * * *",
    "tz": "Asia/Shanghai"
  },
  "payload": {
    "kind": "agentTurn",
    "message": `
      收集以下来源的最新资讯：
      1. HackerNews AI 标签
      2. arXiv cs.SE 分类
      3. GitHub Trending
      整理成早报格式发送到我的微信
    `
  }
}

效果：每天早上 8 点收到技术早报

功能 3：待办事项管理

需求：自动追踪待办，定时提醒

实现：

// 使用企业微信待办技能
wecom_mcp call todo create '{
  "content": " review 测试框架代码",
  "remindTime": "2026-03-20T10:00:00+08:00"
}'

效果：待办事项自动同步到企业微信

功能 4：会议记录整理

需求：会议后自动整理纪要

实现：

// 会议结束后触发
{
  "name": "会议整理",
  "trigger": "manual",
  "payload": {
    "kind": "agentTurn",
    "message": `
      根据以下会议录音转录文本，整理会议纪要：
      1. 提取关键决策
      2. 列出待办事项
      3. 标注责任人
      4. 发送到项目群
    `
  }
}

🔧 技能开发

自定义技能：博客管理

# 技能名称：blog-manager
# 功能：博客文章创建、编辑、发布

## 能力
1. create-post: 创建新文章
2. update-post: 更新文章
3. publish-post: 发布到 GitHub
4. list-posts: 列出所有文章

## 使用示例
blog-manager create-post '{
  "title": "新文章标题",
  "category": "技术分享",
  "tags": ["AI", "OpenClaw"]
}'

自定义技能：代码审查

# 技能名称：code-reviewer
# 功能：自动代码审查

## 能力
1. review-pr: 审查 Pull Request
2. check-style: 代码风格检查
3. suggest-fix: 提供修复建议

## 使用示例
code-reviewer review-pr '{
  "repo": "sunrong1/test-framework",
  "prNumber": 42
}'

📊 使用效果

效率提升

任务	之前	现在	提升
博客部署	手动 30 分钟	自动 0 分钟	100%
资讯收集	每天 1 小时	自动 0 分钟	100%
会议整理	每次 30 分钟	自动 5 分钟	83%
待办追踪	经常遗漏	100% 提醒	-

时间节省

每周节省时间：约 8-10 小时
每月节省时间：约 30-40 小时

💡 经验总结

成功经验

从小处着手：先实现一个功能，再逐步扩展
充分利用现有技能：不要重复造轮子
定期优化：根据使用情况调整配置

踩过的坑

API 限流：注意各平台的调用频率限制
错误处理：一定要加重试机制
日志记录：方便排查问题

🔴 实战避坑经验（2026年4月补充）

坑1：Session Label 每天消失

问题现象：设置的 session label 第二天不见了

根本原因：OpenClaw 默认每天 4:00 AM 会重置会话（daily reset），label 跟着 session 走，session 重置后 label 就丢了

解决方案：禁用每日重置，改为闲置 1 个月后重置

# 错误配置（默认）
# session.reset.mode: "daily"  → 每天4点重置

# 正确配置
openclaw config set session.reset.mode idle
openclaw config set session.reset.idleMinutes 43200  # 30天

效果：✅ Session 闲置 1 个月才重置，label 持久保存

坑2：无法查看历史会话记录

问题现象：sessions_history 报错 Session history visibility is restricted

根本原因：tools.sessions.visibility 默认为 tree，只能访问当前 session 树

解决方案：修改为 all

openclaw config set tools.sessions.visibility all
openclaw gateway restart

效果：✅ 可以查看所有会话历史

坑3：Cron Job 报 “Channel is required”

问题现象：多个 cron job 报错 Channel is required when multiple channels are configured: openclaw-weixin, wecom

根本原因：配置了多个 channel（个人微信 + 企业微信），isolated 类型的 cron job 必须显式指定 delivery.channel

解决方案：给所有 isolated cron job 添加 channel 配置

# 示例：更新 job 配置
# delivery: {
#   mode: "announce",
#   channel: "wecom"  # 指定企业微信
# }

易出错的 job 类型：

AI Agent 每日学习提醒
AI Agent 资讯推送
AI Agent 复习提醒
每日自我提升复盘

坑4：Cron Job 执行超时

问题现象：cron: job execution timed out

根本原因：

默认超时只有 60 秒
任务内容太重（读取文件 + 分析 + 生成摘要）
网络请求慢（搜索 API）

解决方案：按需增加超时时间

# 简单任务：60-120 秒足够
# 搜索+分析任务：建议 180-300 秒
# 复杂任务：考虑拆分成多个步骤

坑5：web_search 搜索不稳定

问题现象：使用 shad代理搜索超时

根本原因：网络不稳定，DuckDuckGo 等服务国内访问慢

解决方案：使用 Tavily 搜索服务（国内可访问）

# 1. 安装 tavily-search skill
cd ~/.openclaw/extensions/tavily-search
npm install

# 2. 配置 API Key
# 文件：~/.openclaw/extensions/tavily-search/.env
TAVILY_API_KEY=tvly-xxx

# 3. 测试
node examples.js

Tavily 优势：

国内可直接访问
支持 includeAnswer: true 返回 AI 总结
免费额度 1000 次/月

坑6：Gateway 重启失败

问题现象：openclaw gateway restart 返回 exit code 1

根本原因：systemd service 停止和启动之间存在时序问题

解决方案：分开执行

# 错误方式
openclaw gateway restart  # 可能失败

# 正确方式
openclaw gateway stop
openclaw gateway start

坑7：Heartbeat 提醒太频繁

问题现象：收到太多 heartbeat 提醒

根本原因：cron job 配置了太多重复的定时任务

解决方案：统一规划，避免重复

时间	任务	类型
7:30	早上学习提醒	systemEvent
12:00	AI Agent 资讯推送	agentTurn + wecom
21:00	晚间学习总结	systemEvent
22:00	每日自我提升复盘	agentTurn + wecom

注意：工作日和休息日任务要分开，避免休息日收到工作提醒

📊 配置速查表

# Session 配置
openclaw config set session.reset.mode idle
openclaw config set session.reset.idleMinutes 43200

# 工具权限配置
openclaw config set tools.sessions.visibility all
openclaw config set tools.profile full

# 查看当前配置
openclaw config get session.reset
openclaw config get tools.sessions.visibility

# 查看 cron job 状态
openclaw cron list
openclaw cron runs <job-id>

改进方向

更多集成：接入更多工具（日历、邮件等）
更智能：用 AI 做更多决策
更稳定：增加监控和告警

🆕 新增配置（2026年4月）

定时任务配置

// AI Agent 资讯推送 - 每天 12:00
{
  "name": "AI Agent 资讯推送",
  "schedule": { "kind": "cron", "expr": "0 12 * * *", "tz": "Asia/Shanghai" },
  "sessionTarget": "isolated",
  "payload": {
    "kind": "agentTurn",
    "message": "搜索最新 AI Agent 资讯，推荐 2-3 篇有价值的文章",
    "timeoutSeconds": 300
  },
  "delivery": { "mode": "announce", "channel": "wecom" }
}

// 每日自我提升复盘 - 每天 22:00
{
  "name": "每日自我提升复盘",
  "schedule": { "kind": "cron", "expr": "0 22 * * *", "tz": "Asia/Shanghai" },
  "sessionTarget": "isolated",
  "payload": {
    "kind": "agentTurn",
    "message": "执行自我提升复盘流程...",
    "timeoutSeconds": 300
  },
  "delivery": { "mode": "announce", "channel": "wecom" }
}