夜雨聆风关注公众号：私信 “openclaw”
自动发送相关的PDF完整文档
OpenClaw + Claude Code CLI：24小时自动编程完整指南
前言：为什么选择这个组合？
在AI编程领域，OpenClaw和Claude Code CLI的结合堪称“黄金搭档”。OpenClaw作为开源的AI代理平台，擅长任务调度、自动化执行和多平台集成；而Claude Code CLI则是Anthropic官方出品的命令行编程助手，具备深度代码理解和执行能力。将两者结合，你将获得一个真正能够24小时不间断工作的AI程序员。
核心优势
- 持续运行
：OpenClaw的后台守护进程确保系统7×24小时运行 - 深度编程
：Claude Code CLI提供比传统AI工具更强大的代码理解与执行能力 - 自动化工作流
：通过定时任务、心跳监控和Webhook触发，实现真正的无人值守编程 - 成本效益
：相比订阅服务，使用Claude Code CLI配合OpenClaw可节省大量成本
核心架构：理解工作原理
系统架构图
这个架构的核心在于分工明确：
- OpenClaw
：负责任务管理、调度、监控和通信。它像一个项目经理，接收任务、安排执行、跟踪进度、报告结果。 - Claude Code CLI
：负责实际的编程工作。它像一个高级程序员，理解需求、编写代码、运行测试、提交更改。
第一步：安装Claude Code CLI
3.1 系统要求
在开始之前，确保你的系统满足以下要求：
Claude Code CLI需要Claude Max订阅来进行OAuth认证，不能使用API密钥。
3.2 安装Claude Code
步骤1：使用官方安装器（推荐）
2026年起，Claude Code官方推荐使用原生安装器，无需安装Node.js：
# macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash
# Windows (PowerShell)
iwr -useb https://claude.ai/install.ps1 | iex步骤2：验证安装
# 检查版本
claude --version
# 预期输出：Claude Code v2.1.75 或更高版本3.3 认证配置
步骤3：OAuth认证（一次性设置）
Claude Code CLI使用浏览器OAuth认证，需要一个TTY终端：
# 启动认证流程
claude setup-token认证流程：
CLI会显示一个授权URL 在浏览器中打开该URL 使用你的Claude Max账户授权 浏览器会显示授权码 将授权码粘贴回终端
成功后会生成一个长期有效的OAuth令牌（有效期1年），格式为：sk-ant-oat01-xxxxx
步骤4：存储认证令牌
将OAuth令牌存储为环境变量：
# 方法1：添加到shell配置文件（推荐）
echo 'export CLAUDE_CODE_OAUTH_TOKEN=你的令牌' >> ~/.bashrc
source ~/.bashrc
# 方法2：系统级环境变量
sudo bash -c 'echo "CLAUDE_CODE_OAUTH_TOKEN=你的令牌" >> /etc/environment' 永远不要将你的OAuth令牌提交到版本控制系统！添加 .env 到 .gitignore。
3.4 验证安装
步骤5：测试Claude Code
# 创建测试项目
mkdir ~/test-claude-code
cd ~/test-claude-code
# 测试基本功能
claude --print "创建一个Python函数，计算斐波那契数列的第n项"如果一切正常，Claude Code会生成代码并显示在终端中。
第二步：配置OpenClaw集成
4.1 安装OpenClaw核心
步骤6：安装OpenClaw
# 使用官方一键安装脚本
curl -fsSL https://openclaw.ai/install.sh | bash
# 或使用npm全局安装
npm install -g openclaw步骤7：初始化配置
# 运行配置向导（本地机器）
openclaw onboard
# 或手动配置（云服务器）
openclaw setup
openclaw config set gateway.mode local
openclaw daemon install
openclaw daemon start4.2 安装Claude Code技能
步骤8：安装Claude Code技能包
OpenClaw通过技能（Skills）扩展功能。安装官方的Claude Code CLI技能：
# 安装Claude Code CLI技能
npx clawhub install claude-code-cli
# 验证安装
openclaw doctor该技能会教OpenClaw如何调用Claude Code CLI进行编程任务。
4.3 配置OpenClaw
步骤9：配置Claude Code为CLI后端
编辑OpenClaw配置文件，添加Claude Code CLI作为模型选项：
// ~/.openclaw/config.patch
{
"agents": {
"defaults": {
"cliBackends": {
"claude-cli": {
"command": "/usr/bin/claude",
"env": {
"CLAUDE_CODE_OAUTH_TOKEN": "你的令牌"
}
}
},
"models": {
"claude-cli/opus-4.6": {
"alias": "claude-cli-opus"
},
"claude-cli/sonnet-4.6": {
"alias": "claude-cli-sonnet"
}
}
},
"list": [
{
"id": "coding-agent",
"model": {
"primary": "claude-cli/sonnet-4.6",
"fallbacks": [
"claude-cli/opus-4.6"
]
}
}
]
}
}步骤10：应用配置并重启
# 应用配置补丁
openclaw config.patch
# 重启Gateway
openclaw daemon restart
# 验证配置
openclaw gateway status第三步：设置24小时自动化
5.1 配置定时任务
OpenClaw的Cron功能允许你设置定时编程任务：
示例1：每日代码审查
# 每天早上8点自动审查代码
openclaw cron add \
--schedule "0 8 * * 1-5" \
--message "审查昨天的所有代码提交，生成审查报告并发送到我的邮箱" \
--model "claude-cli/sonnet-4.6" \
--channel "email" \
--to "your-email@example.com"示例2：定期测试运行
# 每6小时运行一次测试套件
openclaw cron add \
--schedule "0 */6 * * *" \
--message "运行完整测试套件，如果失败则自动尝试修复简单错误，复杂问题发送告警" \
--model "claude-cli/sonnet-4.6" \
--workspace "/path/to/your/project"5.2 设置心跳监控
心跳机制让OpenClaw定期主动检查任务：
步骤11：创建心跳任务文件
# ~/.openclaw/workspace/HEARTBEAT.md
## 项目健康监控
- 每30分钟检查项目是否有未提交的更改
- 每2小时检查依赖项是否有安全更新
- 每天检查代码覆盖率是否下降
## 自动修复
- 发现简单的lint错误，自动修复
- 发现文档缺失，自动补充
- 发现TODO注释，评估优先级并创建任务5.3 配置Webhook触发
Webhook让外部事件触发编程任务：
步骤12：设置GitHub Webhook
# 配置GitHub仓库的Webhook指向OpenClaw
# 在GitHub仓库设置中添加：
# Payload URL: https://your-server/hooks/github
# Content type: application/json
# Secret: your-webhook-secret
# Events: Pull requests, Issues, Push步骤13：创建Webhook处理脚本
# ~/.openclaw/webhooks/github_handler.py
import json
import subprocess
def handle_pull_request(payload):
"""处理Pull Request事件"""
pr_number = payload['pull_request']['number']
repo = payload['repository']['full_name']
# 让Claude Code审查PR
task = f"审查GitHub仓库 {repo} 的Pull Request #{pr_number}，提供详细的代码审查意见"
result = subprocess.run([
'claude', '--print', task,
'--model', 'claude-cli/sonnet-4.6'
], capture_output=True, text=True)
return result.stdout
# OpenClaw会自动调用这个函数实战案例：构建自动编程工作流
6.1 场景描述
让我们构建一个真实的24小时自动编程系统，它可以：
- 每日自动审查代码
：检查代码质量、发现潜在bug - 响应GitHub事件
：自动审查PR、回复Issue - 持续集成
：自动运行测试、修复简单错误 - 文档维护
：自动更新文档、生成API文档
6.2 实现步骤
步骤14：创建项目配置文件
为你的项目创建CLAUDE.md文件，这是Claude Code的“项目大脑”：
# ~/my-project/CLAUDE.md
## 项目概述
这是一个电商网站后端API项目，使用Python Flask框架。
## 技术栈
- 语言: Python 3.10
- 框架: Flask 2.0
- 数据库: PostgreSQL
- 缓存: Redis
- 测试: pytest
## 目录结构
- app/ - 主应用代码
- tests/ - 测试文件
- docs/ - 文档
- migrations/ - 数据库迁移
## 编码规范
- 遵循PEP 8
- 所有函数必须有docstring
- 使用类型注解
- 测试覆盖率至少80%
## 重要规则
- 永远不要直接提交到main分支
- 所有更改必须通过Pull Request
- 运行 `pytest` 确保测试通过
- 运行 `flake8` 检查代码风格
## 部署
- 平台: AWS EC2
- CI/CD: GitHub Actions
- 部署命令: `./deploy.sh`步骤15：设置自动化任务
# 创建自动化配置脚本
cat > ~/setup-automation.sh << 'EOF'
#!/bin/bash
# 1. 每日代码审查（早上8点）
openclaw cron add \
--schedule "0 8 * * 1-5" \
--message "审查my-project项目昨天的所有代码更改，生成审查报告" \
--model "claude-cli/sonnet-4.6" \
--workspace "/home/user/my-project"
# 2. 每小时测试运行
openclaw cron add \
--schedule "0 * * * *" \
--message "运行my-project的测试套件，如果失败尝试自动修复简单错误" \
--model "claude-cli/sonnet-4.6" \
--workspace "/home/user/my-project"
# 3. 每日依赖检查（凌晨2点）
openclaw cron add \
--schedule "0 2 * * *" \
--message "检查my-project的依赖项是否有安全漏洞或新版本，生成报告" \
--model "claude-cli/sonnet-4.6" \
--workspace "/home/user/my-project"
# 4. 每周文档更新（周日晚10点）
openclaw cron add \
--schedule "0 22 * * 0" \
--message "更新my-project的API文档，确保文档与代码同步" \
--model "claude-cli/opus-4.6" \
--workspace "/home/user/my-project"
EOF
chmod +x ~/setup-automation.sh
~/setup-automation.sh步骤16：创建GitHub集成脚本
# ~/.openclaw/skills/github-integration/skill.py
import subprocess
import json
def handle_new_issue(repo, issue_number, issue_title, issue_body):
"""处理新的GitHub Issue"""
task = f"""
分析GitHub仓库 {repo} 的新Issue #{issue_number}:
标题: {issue_title}
内容: {issue_body}
任务：
1. 判断Issue类型（bug/feature/question）
2. 如果是bug，尝试复现并提供修复建议
3. 如果是feature，提供实现方案
4. 生成回复并自动发布
"""
result = subprocess.run([
'claude', '--print', task,
'--model', 'claude-cli/sonnet-4.6',
'--workspace', f'/path/to/{repo}'
], capture_output=True, text=True)
return result.stdout
def handle_pull_request(repo, pr_number, pr_diff):
"""处理新的Pull Request"""
task = f"""
审查GitHub仓库 {repo} 的Pull Request #{pr_number}:
代码差异:
{pr_diff}
任务：
1. 分析代码质量和潜在问题
2. 检查是否遵循项目编码规范
3. 提供详细的审查意见
4. 给出批准或修改建议
"""
result = subprocess.run([
'claude', '--print', task,
'--model', 'claude-cli/opus-4.6'
], capture_output=True, text=True)
return result.stdout步骤17：启动24小时服务
# 确保OpenClaw守护进程在运行
openclaw daemon start
# 检查服务状态
openclaw gateway status
# 查看任务队列
openclaw cron list
# 监控日志
tail -f ~/.openclaw/logs/gateway.log恭喜！你的24小时自动编程系统已经启动。现在OpenClaw会持续监控你的项目，自动执行编程任务，而你可以在任何地方通过Telegram或Web界面查看进度。
进阶技巧与最佳实践
技巧1：使用Agent Teams协同工作
OpenClaw支持创建多个Agent协同工作，每个Agent专注于不同任务：
{
"agentTeams": [
{
"name": "coding-team",
"members": [
{
"role": "architect",
"model": "claude-cli/opus-4.6",
"responsibilities": ["设计架构", "代码审查"]
},
{
"role": "developer",
"model": "claude-cli/sonnet-4.6",
"responsibilities": ["编写代码", "修复bug"]
},
{
"role": "tester",
"model": "claude-cli/sonnet-4.6",
"responsibilities": ["运行测试", "质量保证"]
}
]
}
]
}技巧2：优化成本
- 任务分层
：简单任务用Sonnet，复杂任务用Opus - 缓存结果
：对重复任务使用OpenClaw的内存缓存 - 批量处理
：将小任务合并成批量任务 - 智能调度
：在低峰期运行资源密集型任务
技巧3：安全最佳实践
- 权限控制
：使用Git分支和Pull Request，不要让AI直接提交到main分支 - 敏感信息
：永远不要在代码或CLAUDE.md中存储API密钥、密码等 - 审查机制
：重要更改必须人工审查 - 备份策略
：定期备份项目，使用版本控制
故障排查与优化
问题1：Claude Code认证失败
症状：claude setup-token 失败或OAuth令牌无效
解决方案：
# 检查Claude Max订阅状态
claude --version
# 重新认证
claude setup-token
# 验证令牌
echo $CLAUDE_CODE_OAUTH_TOKEN问题2：OpenClaw无法调用Claude Code
症状：任务执行失败，日志显示"command not found"
解决方案：
# 检查Claude Code路径
which claude
# 更新OpenClaw配置
openclaw config set cliBackends.claude-cli.command $(which claude)
# 重启服务
openclaw daemon restart问题3：任务执行超时
症状：长时间运行的任务被中断
解决方案：
# 增加超时时间
openclaw config set task.timeout 600 # 10分钟
# 或在任务中指定
claude --timeout 600 "你的任务"性能优化建议
总结：从想法到实现
通过本文的指导，你已经成功构建了一个真正的24小时AI编程系统。这个系统不仅能够自动编写代码，还能：
- 持续监控
：通过心跳机制定期检查项目状态 - 自动响应
：通过Webhook实时处理GitHub事件 - 智能调度
：通过Cron任务定时执行编程工作 - 协同工作
：通过Agent Teams实现多Agent协作
关键要点回顾
- 架构清晰
：OpenClaw负责调度，Claude Code负责执行 - 认证正确
：使用Claude Max订阅的OAuth认证 - 配置完善
：CLAUDE.md提供项目上下文 - 自动化全面
：结合Cron、Heartbeat和Webhook - 安全可控
：使用Git分支、人工审查、敏感信息隔离
现在，你的AI编程助手已经准备就绪。它可以在你睡觉时修复bug、在你开会时审查代码、在你度假时运行测试。这不再是科幻小说，而是你已经掌握的现实技术。
下一步：开始实践！从简单的任务开始，逐步构建你的自动化编程帝国。记住，最好的学习方式是动手实践。
关注公众号：私信 “openclaw”
自动发送相关的PDF完整文档
