OpenClaw 深度使用指南：从 0 到 1 构建个人 AI Agent

📅 2026-03-14 ⏱️ 12 min read
AI OpenClaw Agent 自动化

引言

为什么选择 OpenClaw

在尝试了多种 AI Agent 框架后，我最终选择了 OpenClaw，原因很简单：

  • 本地优先：所有数据在本地，隐私安全
  • 成本极低：使用免费额度的 API，月成本几乎为零
  • 生态强大：技能系统、定时任务、子 Agent 协作
  • 可玩性高：深度定制，想怎么玩就怎么玩

我能用 OpenClaw 做什么

  • 📅 定时任务自动化：晨间简报、健康提醒、项目汇报
  • 🤖 子 Agent 协作：让更专业的模型处理特定任务
  • 🧠 长期记忆管理：自动归档对话，提取关键信息
  • 🔧 技能系统：安装/开发技能，无限扩展能力

快速开始

安装配置（5 分钟上手）

# 安装 OpenClaw
npm install -g openclaw@latest

# 配置向导
openclaw configure

# 启动
openclaw gateway start

核心概念

  • Gateway：后台服务，管理所有连接
  • Agent：AI 助手实例（默认是 main）
  • Session：每次对话的会话
  • Skill：功能插件（如天气、GitHub、浏览器自动化）

第一个对话

安装完成后，直接在 Discord/Telegram 或 TUI 中与 Agent 对话即可。

核心功能实战

1. 定时任务（Cron）

OpenClaw 内置 cron 系统，可以定时执行任务。

示例：每天 8:30 发送晨间简报

# 添加定时任务
cron add '{
  "name": "晨间简报",
  "schedule": {"kind": "cron", "expr": "0 8:30 * * *"},
  "payload": {"kind": "agentTurn", "message": "发送晨间简报"},
  "sessionTarget": "isolated"
}'

我的晨间简报包含：

  • 地理知识卡片
  • AI 行业要闻
  • 项目状态
  • 天气信息

2. 子 Agent 协作

当需要专业模型处理特定任务时，可以 spawn 子 Agent。

示例：让小马（glm-5）处理开发任务

{
  runtime: "subagent",
  agentId: "bailian/glm-5",  // 小马，擅长编程
  task: "开发一个 XXX 功能",
  cwd: "/root/.openclaw/workspace/nook"
}

我的工作流程：

  1. 在 #小马-dev 频道收到开发任务
  2. spawn 小马 sub-agent
  3. 小马执行并汇报结果
  4. 我追踪进度，必要时协调

3. 技能系统

安装现有技能：

# 从 ClawHub 安装
openclaw skill install <skill-name>

我的主力技能：

  • agent-browser：浏览器自动化
  • github：GitHub 操作（gh CLI）
  • senior-fullstack：全栈开发脚手架
  • remind-me：自然语言提醒
  • healthcheck：系统安全审计

4. 记忆管理

MEMORY.md - 长期记忆

  • 记录用户教学、共同决策、配置变更
  • 会话重启后自动加载
  • 避免重复问题

memory/ 目录 - 每日日记

  • 每日自动归档对话
  • 18:00 整理高优先级内容
  • 低优先级内容自动过滤

高级技巧

配置优化（config.patch 安全修改）

优先使用 config.patch（部分更新，安全）：

openclaw config.patch {
  "agents": {
    "defaults": {
      "thinkingDefault": "high"
    }
  }
}

避免使用 config.apply（替换整个配置，风险高）

会话管理（避免上下文爆炸）

阈值：超过 12 个会话文件时清理

方法：

openclaw gateway restart

重启后自动清理超过 7 天不活跃的会话。

安全配置

exec 安全模式：

{
  "tools": {
    "exec": {
      "security": "allowlist",
      "allowlist": ["read", "cat", "ls", "grep", "git status"]
    }
  }
}

secrets.json 存储敏感信息：

{
  "providers": {
    "bailian": {
      "apiKey": "sk-xxx"
    }
  }
}

我的配置分享

模型选择

主模型：bailian/qwen3.5-plus

  • 阿里百炼，免费额度
  • 启用 reasoning: true（深度思考）
  • 1M tokens 上下文

备选模型：

  • bailian/glm-5（小马，编程开发）
  • bailian/kimi-k2.5
  • bailian/MiniMax-M2.5

图片模型：bailian/qwen-vl-max

Discord 集成

配置要点：

  • 服务器白名单
  • 频道白名单
  • DM 仅允许指定用户
  • #小马-dev 频道：开发任务专用

语音功能

TTS：Edge TTS（zh-CN-XiaoxiaoNeural）
STT：faster-whisper（small 模型）
模式：inbound（仅收到语音消息时才语音回复）

踩坑记录

GitHub 推送问题

问题：SSH 被 GitHub 拒绝
解决：改用 HTTPS + Token

git config --global credential.helper store
git remote set-url origin https://github.com/zzdbilly/仓库名.git

会话数超标

问题：会话文件超过阈值（12 个）
解决：定期执行 openclaw gateway restart

配置修改导致重启

教训：写错配置字段会导致 Gateway 反复重启
最佳实践：

  1. 先用 config.patch 小范围修改
  2. 备份配置：cp openclaw.json openclaw.json.bak
  3. 验证语法：openclaw config.validate

总结

OpenClaw 适合谁

✅ 想要本地化 AI 助手的用户
✅ 喜欢折腾、深度定制的技术爱好者
✅ 需要自动化工作流的开发者
✅ 注重隐私、不想依赖云端服务的人

❌ 想要开箱即用、不想配置的用户
❌ 对命令行完全陌生的小白

下一步学习路径

  1. 基础：完成官方文档阅读
  2. 进阶：安装 3-5 个实用技能
  3. 高级：开发自定义技能
  4. 专家：贡献开源、优化核心

参考资源

最后更新：2026-03-14
作者：张小猛