OpenClaw + Claude Code 组合开发软件小白教程

本教程专为编程小白打造，核心讲透调度层工具OpenClaw +执行层工具Claude Code 的分层协作逻辑，通过黄金投资资讯爬虫 实战案例，让你快速上手用AI组合工具完成完整项目开发，全程复制命令即可操作，无需复杂编程基础。

核心认知：先搞懂两个工具的分工（小白必看）

很多人混淆两者，本质是上下游协作关系，而非竞争关系，用大白话讲：

• OpenClaw ：项目总指挥 ，开源的多Agent编排框架，负责拆任务、排流程、管协作、做验收，解决「项目该做什么、谁做、按什么顺序做」的问题，本地运行数据更安全。
• Claude Code ：资深程序员 ，Anthropic官方的终端AI编程工具，负责写代码、改文件、跑命令、调程序，解决「怎么把代码写好、跑通」的问题，开箱即用无需复杂配置。
• 组合逻辑：OpenClaw定计划，Claude Code落地执行，一个管「战略」，一个管「战术」，一起用能从「写单个函数」升级到「交付完整项目」。

前置准备：10分钟装好所有工具（复制命令即可）

基础环境（必装，小白无脑装）

所有系统（Windows/Mac/Linux）都需要先装以下基础环境，官网下载傻瓜式安装：

1. Python3.8+：编程基础环境，https://www.python.org/downloads/
2. 终端工具：Windows用CMD/PowerShell，Mac/Linux用自带Terminal
3. Docker+Docker Compose：项目部署工具，https://www.docker.com/get-started/（安装后启动服务）
4. Node.js ：安装OpenClaw需要，https://nodejs.org/（含npm包管理器，装完验证`npm -v`）

步骤1：安装Claude Code（开箱即用，30秒搞定）

Claude Code是终端工具，所有系统命令一致，打开终端直接输入：

# 安装Claude Code
npm install -g @anthropic/claude-code
# 验证安装成功（显示版本号即成功）
claude --version

首次启动输入claude，按提示绑定Anthropic账号（需海外邮箱，免费注册即可），获取Claude API密钥（保存好，后续OpenClaw配置要用）。

步骤2：安装并配置OpenClaw（核心配置对接Claude Code）

OpenClaw是开源框架，先安装再简单配置，让它能调用Claude Code执行代码，全程复制命令/配置：

1. 安装OpenClaw

# 全局安装OpenClaw
npm install -g openclaw
# 初始化配置文件（自动生成配置目录）
openclaw init

2. 配置对接Claude Code （关键步骤）

   • 打开OpenClaw配置文件：Windows路径C:\Users\你的用户名\.openclaw\openclaw.json，Mac/Linux路径~/.openclaw/openclaw.json
   • 清空原有内容，复制以下代码，仅修改apiKey为你的Claude API密钥，保存即可：

   {
    "models": {
      "providers": {
        "clauddy": {
          "baseUrl": "https://clauddy.com",
          "apiKey": "sk-your-clauddy-token", // 替换成你的Claude API密钥
          "auth": "api-key",
          "api": "anthropic-messages",
          "authHeader": true,
          "models": [
            {
              "id": "claude-sonnet-4-6",
              "name": "claude-sonnet-4-6",
              "api": "anthropic-messages",
              "reasoning": true,
              "input": ["text", "image"],
              "contextWindow": 200000,
              "maxTokens": 8192
            }
          ]
        }
      }
    },
    "skills": {},
    "memory": {
      "enable": true
    }
   }

3. 验证配置成功 ：终端输入openclaw start，显示「OpenClaw started successfully」即完成。

核心教程：5步组合开发完整项目（通用流程，所有项目都适用）

以黄金投资资讯爬虫 为例，从「需求描述」到「项目上线」，全程用OpenClaw+Claude Code协作，小白只需输入需求、确认计划、补充配置，其余全由AI完成。

步骤1：OpenClaw做需求梳理&任务拆解（总指挥定计划）

操作工具 ：OpenClaw
核心作用 ：把模糊的需求拆成可执行的小任务，并制定执行顺序，无需自己想流程。

1. 终端启动OpenClaw：openclaw start

2. 输入你的原始需求（小白直接复制以下内容）：

   帮我开发一个黄金投资资讯爬虫项目，要求：每天爬取几百条金投网、东方财富的黄金资讯，提取标题、时间、内容，去重后通过飞书定时推送，1周内上线MVP，用Docker部署，只做飞书交互不做Web后台。

3. OpenClaw会自动生成任务清单+执行顺序 ，并输出待确认细节，你只需简单回复（如「按这个计划执行」），示例输出：

   黄金爬虫项目任务拆解（共5步）：
   1. 需求调研：确认数据源站点规则、飞书推送接口
   2. 技术方案：搭建Scrapy爬虫框架，选用MongoDB存储+Redis去重
   3. 编码开发：写站点爬虫、飞书推送、定时调度模块
   4. 本地测试：验证爬取、去重、推送功能正常
   5. Docker部署：编写Dockerfile，实现一键启动
   执行角色：Claude Code负责步骤2-5的编码与运行，我负责流程监控与验收

步骤2：OpenClaw派工&流程编排（总指挥分配任务）

操作工具 ：OpenClaw
核心作用 ：将拆解后的任务定向派给Claude Code，并设定任务验收标准，AI自动衔接，无需人工干预。

1. 在OpenClaw终端输入指令，让它向Claude Code派工：

   请将上述黄金爬虫项目的编码开发任务派给Claude Code，要求按Scrapy框架开发，输出完整项目代码，包含Docker配置文件。

2. OpenClaw会自动生成任务指令，并复制到剪贴板，同时提示「请在Claude Code终端执行该指令」。

步骤3：Claude Code落地编码（程序员写代码，全程自动）

操作工具 ：Claude Code
核心作用 ：读取OpenClaw的任务指令，自动写完整代码、生成项目结构、配置依赖，无需一行行写代码。

1. 新开一个终端，启动Claude Code：claude

2. 粘贴OpenClaw生成的任务指令，回车执行，Claude Code会自动完成以下工作：

   • 初始化Scrapy爬虫项目骨架
   • 编写金投网/东方财富爬虫代码（cngold.py/eastmoney.py）
   • 实现MongoDB存储+Redis去重（pipelines.py）
   • 开发飞书推送模块（feishu.py）
   • 配置定时调度器（scheduler.py）
   • 生成Dockerfile、docker-compose.yml、requirements.txt等部署文件

3. 执行完成后，终端会显示项目代码结构 ，并提示「代码已生成，保存在当前目录的gold_crawler文件夹中」，生成的结构如下（和专业程序员写的一致）：

   gold_crawler/
   ├── crawler/（核心代码）
   │   ├── spiders/（站点爬虫）
   │   ├── items.py（数据模型）
   │   ├── pipelines.py（存储+去重）
   │   ├── feishu.py（飞书推送）
   │   ├── scheduler.py（定时调度）
   │   └── settings.py（配置文件）
   ├── docker-compose.yml（Docker编排）
   ├── Dockerfile（镜像构建）
   ├── requirements.txt（Python依赖）
   └── README.md（使用说明）

步骤4：Claude Code本地测试&问题修复（程序员调程序）

操作工具 ：Claude Code
核心作用 ：自动运行代码，检测并修复bug（如爬虫反爬、推送失败、去重失效），小白只需看结果。

1. 在Claude Code终端输入测试指令：

   请运行gold_crawler项目，测试爬取、去重、飞书推送功能，修复所有出现的问题。

2. Claude Code会自动执行以下操作：

   • 安装项目依赖：pip install -r requirements.txt
   • 启动MongoDB/Redis服务（通过Docker）
   • 运行爬虫，测试数据爬取
   • 调用飞书接口，测试推送
   • 检测bug并自动修改代码（如添加请求头避反爬、优化去重逻辑）

3. 测试成功后，终端会显示「测试通过，爬取到XX条黄金资讯，已成功推送到飞书」。

步骤5：OpenClaw验收+Claude Code部署上线（联合完成交付）

操作工具 ：OpenClaw+Claude Code
核心作用 ：OpenClaw验证项目是否符合需求，Claude Code完成一键部署，项目正式上线运行。

1. OpenClaw验收 ：在OpenClaw终端输入，AI自动校验项目是否达标：

   验收gold_crawler项目，检查是否满足「每天爬取、去重、飞书定时推送、Docker部署」的需求。

2. Claude Code部署上线 ：验收通过后，在Claude Code终端输入部署指令，一键启动项目 ：

   请用Docker Compose部署gold_crawler项目，设置每天上午9点自动爬取并推送飞书。

3. 部署成功后，终端显示「项目已上线，Docker容器运行中，定时任务已创建」，此后每天会自动爬取资讯并推送到你的飞书，全程无需人工操作。

实战补充：小白必看的2个关键细节

细节1：如何获取飞书Webhook（推送必备，30秒搞定）

飞书推送需要Webhook地址，小白按以下步骤获取，无需开发：

1. 打开飞书群→设置→群机器人→添加机器人→选择「自定义机器人」
2. 输入机器人名称（如黄金爬虫），勾选「自定义消息」，点击「创建」
3. 复制生成的Webhook地址 ，粘贴到gold_crawler/crawler/settings.py文件的FEISHU_WEBHOOK字段中即可。

细节2：如何查看项目运行状态（小白监控必备）

1. 查看Docker容器状态：docker ps（显示gold_crawler相关容器为Up即正常）

2. 查看爬取日志：docker logs gold_crawler_crawler_1

3. 停止/重启项目：

   # 停止项目
   docker-compose down
   # 重启项目
   docker-compose up -d

小白避坑：常见问题及解决办法

问题现象	原因	解决办法
安装OpenClaw提示「npm命令不存在」	未装Node.js或未配置环境变量	重新安装Node.js，安装后重启终端
Claude Code提示「API密钥错误」	API密钥输入错误或过期	重新在Anthropic官网获取密钥，修改OpenClaw配置文件
爬虫爬取不到数据	网站反爬，未加请求头	在Claude Code终端输入「给爬虫添加请求头，避开反爬」，AI自动修复
飞书推送失败	Webhook地址错误或飞书机器人被禁用	重新获取Webhook，检查飞书群机器人状态
Docker启动失败	Docker服务未启动	打开Docker软件，启动后台服务

快速判断：什么时候用组合？什么时候单独用？

小白不用死记，按以下简单原则选择，效率最高：

1. 单独用Claude Code：任务一句话能说清（如「写一个Python加法函数」「修复这段代码的bug」「重构Scrapy爬虫」），适合日常小编程任务。
2. 组合用OpenClaw+Claude Code：任务需要画流程图（如「开发一个完整的爬虫项目」「做一个电商商品比价系统」「搭建自动化数据统计工作流」），适合完整项目交付。
3. 单独用OpenClaw：有数据隐私要求（如公司内部项目），搭配本地模型（Ollama），适合做任务编排和流程自动化。

总结

OpenClaw+Claude Code的核心价值，是让小白跳过「学习编程细节」 ，直接掌握「项目开发逻辑」------你只需要说清**「想要什么」，OpenClaw帮你拆成 「该做什么」，Claude Code帮你落地「怎么做好」**。

这套组合的本质是AI分层协作，而非单纯的「代码工具」，掌握后你能从「写代码的程序员」升级为「管项目的产品经理」，用AI完成原本需要专业开发团队才能做的事，这也是未来AI开发的核心趋势。

后续只需把本教程的「黄金爬虫项目」替换成你的需求（如天气提醒、电商比价、数据统计），按5步流程操作，就能快速交付自己的AI项目。