OpenClaw：开源 Agent 模板平台

为什么需要 OpenClaw：重复的 Agent 任务不该每次重写

通用 Agent 框架的痛点是「重」。LangChain、LlamaIndex 这类框架以代码编排为核心，每做一个新任务都要写脚本、调依赖、管理状态；但如果只是「每天抓几个网页生成摘要」「发版前检查变更并生成 changelog」这类固定流程，用代码框架的边际成本极高。而这些任务恰恰占日常 Agent 使用的大头，它们不需要复杂的图编排，需要的是「把流程固定下来、可复用、可交接」。

OpenClaw 的解法是把「模板」作为一等公民：不需要写代码，用 Markdown 定义单点技能（Skills），用 YAML 定义多步流程（Procedures），用文件夹把技能和流程打包成可分享的模板包（Recipes）。Claude 模型负责理解和执行，OpenClaw 负责把模板加载进会话、把命令落到终端上。模板文件就是全部资产，写一次、到处用、随时改。

与同类工具的气质差异：相比 LangChain 这类「开发框架」，OpenClaw 更接近「终端里的个人 Agent 工作台」，学习成本低一个量级；相比裸用 Claude Code，它多了一层模板沉淀与分发能力，让 Agent 行为可复现、可交接，而不是只在某次会话里生效。

安装与环境配置：4 步就绪

第一步·安装依赖。OpenClaw 是 Claude Code CLI 的封装，需要 Node.js 环境安装 Claude Code，还需要 jq（JSON 处理）和 gum（终端交互界面）两个命令行工具。macOS 用 Homebrew，Debian/Ubuntu 用 apt。

第二步·安装 OpenClaw。官方提供一键安装脚本，curl 管道执行即可，脚本会安装命令到用户目录并配置 PATH。

第三步·认证 Claude。OpenClaw 本身不含模型，首次使用前必须先完成 Claude Code 的登录认证（使用 Anthropic API Key 或 Claude 订阅授权），否则会话启动时会反复提示认证失败。

第四步·验证。运行 clawdbot --version 确认安装结果，运行 clawdbot 进入会话验证认证是否通过。

# 1. 安装依赖（macOS：brew；Debian/Ubuntu：apt）npm install -g @anthropic-ai/claude-codebrew install jq gum        # macOS# sudo apt install jq gum  # Debian/Ubuntu # 2. 安装 OpenClaw（命令名 clawdbot）curl -fsSL https://clawdbot.com/install.sh | bash # 3. 首次认证 Claude Code（完成登录/授权）claude # 4. 验证安装与配置clawdbot --versionclawdbot

快速上手：5 分钟跑通第一个流程模板

思路：首次启动 OpenClaw 后先完成交互式设置（给助手命名、确认模型等），然后创建第一个 Procedure 模板，再用对话触发它——这是 OpenClaw 的最小可用闭环：模板定义 → 会话加载 → 模型执行。

• 步骤一：运行 clawdbot，按提示完成首次设置，并确认 Claude 认证已通过。

• 步骤二：创建流程模板目录 ~/.clawdbot/procedures，生成一个 YAML 模板文件（见下方代码块）。

• 步骤三：退出当前会话，重新运行 clawdbot 启动新会话。

• 步骤四：在对话中直接输入「执行 changelog 流程」，Claude 会读取模板并按 steps 逐步执行 git 命令、输出每步结果。

结果：模板被加载，Claude 按步骤执行并汇报完成情况。进阶技巧：把模板放入 recipes 文件夹即可打包分享（见核心能力详解）；在 ~/.clawdbot/settings.json 中可设置模型与自定义指令，统一约束 Claude 的输出风格。

# 创建第一个流程模板（Procedures）mkdir -p ~/.clawdbot/procedures cat > ~/.clawdbot/procedures/changelog.yaml <<'EOF'procedure:  description: 生成发布变更摘要  steps:    - 运行 git status 列出所有变更文件    - 运行 git diff 查看关键代码改动    - 汇总为 Markdown 摘要并保存为 CHANGELOG.mdEOF # 启动新会话并触发模板clawdbot

核心能力详解：3 大支柱

支柱一·技能模板（Skills）：单点能力，Markdown 编写。位于 ~/.clawdbot/skills/，每个技能是一个带元信息头部（frontmatter，即文件开头用 --- 包裹的键值区）的 Markdown 文件，其中 name 与 description 字段让 Claude 判断何时调用它。技能可以封装一条本机命令，也可以声明「获取网页内容」——官方文档支持用 curl/playwright（后者是无头浏览器自动化工具）抓取外部页面，把实时信息带进对话。技能让能力模块化：新增能力就是新增一个文件，无需改任何代码。

支柱二·流程模板（Procedures）：多步自动化，YAML 编写。位于 ~/.clawdbot/procedures/，用 YAML 的 steps 列表描述执行顺序。与 Skills 的区别：Skill 定义「会做什么」，Procedure 定义「按什么顺序做完一件事」。适合发版检查、数据汇总、报告生成等重复性多步任务；Claude 会逐步执行并在每步给出结果，用户可以随时叫停。

支柱三·模板包（Recipes）：打包与分发。位于 ~/.clawdbot/recipes/，一个 Recipe 就是一个文件夹，内部可包含 skills/、procedures/ 子目录和描述性的 recipe.yaml 元数据（标题、作者、用途）。分发方式最直接：把文件夹打包 zip 发给同事，对方解压到自己的 recipes 目录即完成「安装」。这解决了 Agent 资产难以共享的问题——模板从个人经验变成团队资产。

---name: website-summarydescription: 获取网页内容并输出要点总结--- 使用 curl 获取页面并提炼要点：curl -sL https://example.com将页面正文整理为 5 条以内的要点列表输出。

生产部署与监控：从上线到运维

部署方式一·模板仓库化（模板即代码）。把 ~/.clawdbot/ 下的 skills/、procedures/、recipes/ 目录纳入 Git 仓库，用分支和 tag 管理模板版本。团队成员 clone 仓库后，用符号链接把模板目录指向仓库，例如 ln -s ~/work/clawdbot-templates/recipes ~/.clawdbot/recipes，之后 git pull 即完成团队模板同步。这是成本最低、最容易回滚的模板管理方式。

部署方式二·定时化执行。OpenClaw 是终端程序，可被 cron 等计划任务调用。将某个 Procedure 的触发脚本封装后写入 cron，即可实现每日自动生成摘要、定时检查发布状态等无人值守任务。正式运行前先用 dry-run 模式预览将要执行的命令，确认无误再放行；输出重定向到日志文件便于回查。

可观测性。终端会话输出可被 tee 记录为日志；模型用量在 Anthropic 控制台查看，用于成本核算与异常检测；在 settings.json 中设置自定义指令，可约束 Claude 的输出格式（如固定 JSON 结构），让机器可解析的输出直接对接下游系统。

<p class="para-label">避坑清单：</p>

<ul class="dash-list"><li>跳过依赖安装直接跑脚本：jq/gum 缺失会让脚本诡异报错，先按官方依赖清单逐一核对；</li><li>以为装完即可用、跳过 Claude 认证：OpenClaw 不含推理，未认证 Claude Code 时会话无法启动，先执行 claude 完成登录；</li><li>在原生 Windows 上运行：官方面向 macOS/Linux，Windows 请先装 WSL，否则终端路径与依赖均异常。</li></ul>

AI 应用场景

常见误区

面试题

参考来源

• webpageClawdbot 官网产品介绍与一键安装入口