Skip to content
Published at:

OpenClaw

好的,基于我对 OpenClaw 的了解和你的环境,给你一份循序渐进的教程:


OpenClaw 研发工作流教程

第一阶段:认识 OpenClaw(1-2 天)

1.1 OpenClaw 是什么

OpenClaw 是一个 AI Agent 网关,核心思路是:一个 AI 助手连接你的所有工具(终端、消息、文件、日历等),通过自然语言执行任务。

1.2 核心概念

概念说明
Gateway后台服务,管理所有连接和 Agent 运行
Session一次对话,可以是 Web、Discord、飞书等
WorkspaceAgent 的工作目录,存放文件和记忆
Skill专门技能(如 coding-agent、weather)
Cron定时任务(提醒、定期检查)
HeartbeatAgent 主动轮询检查的机制

1.3 常用命令

bash
openclaw status          # 查看整体状态
openclaw gateway status  # Gateway 是否在跑
openclaw doctor          # 健康检查
openclaw dashboard       # 打开 Web 控制台(就是你现在用的)
openclaw configure       # 交互式配置

第二阶段:基础对话与工具使用(2-3 天)

2.1 直接在 Web UI 对话

你现在已经在做了。试试这些:

  • "帮我查一下今天的天气"
  • "读取当前目录下的文件列表"
  • "帮我搜索一下 xxx 的信息"

2.2 理解 Workspace

Agent 的工作目录是 ~/.openclaw/workspace/,关键文件:

文件作用
SOUL.mdAgent 的人格和行为准则
AGENTS.mdAgent 的工作规范
MEMORY.md长期记忆(重要决策、偏好)
memory/YYYY-MM-DD.md每日笔记
TOOLS.md工具配置备忘
IDENTITY.mdAgent 身份信息

2.3 练习:让 Agent 管理文件

"帮我在 workspace 里创建一个 notes/ 文件夹,写一个项目计划"
"把今天的会议记录整理到 memory/2026-04-22.md"

第三阶段:连接外部工具与平台(3-5 天)

3.1 配置聊天渠道

你已经连了飞书。可以再连:

bash
openclaw configure   # 选择 channels 配置

支持:飞书、Discord、Telegram、Slack、WhatsApp 等

3.2 练习:多平台联动

  • 从飞书给 Agent 发消息,让它在 Web 端处理任务
  • 让 Agent 帮你读飞书文档(feishu-doc skill)

3.3 Cron 定时任务

"每天早上 9 点提醒我看邮件"
"每周五下午 5 点提醒我写周报"

Agent 会用 cron 工具创建定时任务。


第四阶段:Coding Agent 研发工作流(1-2 周)🔥

这是你最关心的部分。

4.1 Coding Agent 是什么

OpenClaw 可以把编码任务委托给专业编程 Agent(Codex、Claude Code 等),Agent 会在你的项目目录里直接读代码、写代码、跑命令。

4.2 基础用法

直接告诉我:

"帮我在 ~/projects/my-app 里添加一个用户登录功能"
"帮我看一下 ~/projects/api 这个项目的 bug,最近 CI 挂了"
"重构 ~/projects/frontend/src/utils.ts,提取公共函数"

我会启动一个 coding agent 子进程来完成任务。

4.3 高级用法:自动化研发流程

① 代码审查

"帮我 review 这个 PR 的改动:git diff main...feature-branch"

② Git 工作流

"帮我把当前分支的改动 commit 并 push 到 origin"
"创建一个新分支 feature/xxx 并切换过去"

③ 调试与修复

"跑一下测试看看哪里挂了:cd ~/projects/app && npm test"
"帮我分析这个报错日志:/tmp/error.log"

④ 文档生成

"帮这个项目生成 README.md"
"把 src/ 下的代码生成 API 文档"

4.4 搭建自动化流水线

用 Cron + Coding Agent 组合:

"每天早上 10 点检查 ~/projects/main 的 CI 状态,如果有失败的告诉我"
"每次 push 到 main 后自动跑测试"

第五阶段:Skill 开发与定制(进阶)

5.1 现成 Skills

你已经有很多可用技能:

  • coding-agent — 编程任务
  • github — GitHub 操作(Issue、PR)
  • feishu-doc/wiki — 飞书文档
  • weather — 天气查询
  • healthcheck — 安全审计
  • taskflow — 持久化工作流

5.2 自定义 Skill

如果现有技能不够用,可以创建自己的 Skill:

"帮我创建一个 skill,用于自动化我们的部署流程"

Skill 本质上是一个 SKILL.md 指令文件 + 可选的脚本。


第六阶段:实战案例 — 研发工作流

案例 1:需求 → 开发 → 测试 → 部署

你: "我需要给项目添加一个导出 CSV 功能"
Agent: [启动 coding agent] 分析项目 → 写代码 → 跑测试 → 提交 PR

案例 2:日常研发辅助

"帮我看看今天有哪些 GitHub Issue 需要处理"
"帮我把这个 Jira ticket 的需求翻译成技术方案"
"分析一下最近一周的代码提交频率"

案例 3:知识管理

"把今天学到的技术点记录到 memory/"
"帮我整理一下项目架构文档"

推荐学习路径总结

第 1 天: 熟悉 Web UI,尝试基本对话
第 2-3 天: 让 Agent 操作文件、管理记忆
第 4-5 天: 配置飞书/Discord,体验多平台
第 1 周:  用 Coding Agent 完成实际编码任务
第 2 周:  搭建自动化 Cron 任务(CI 检查、日报提醒等)
第 3 周+: 学习自定义 Skill,深度定制工作流

有任何阶段想深入,直接告诉我,我可以手把手带你操作。比如现在就可以试试:"帮我看看 ~/projects/ 下面有什么项目,挑一个做点实际的。"

Updated at: