🦞 OpenClaw 使用指南

🧩 使用 Coding Agent 技能

skill: coding-agent

# Codex CLI（需要 git 仓库）
bash pty:true command:"codex exec '编写一个 Python 函数，实现斐波那契数列'"

# Claude Code
bash pty:true command:"claude '重构这段代码，增加错误处理'"

# Pi 编程代理
bash pty:true command:"pi '构建一个 REST API'"

# 带工作目录
bash pty:true workdir:~/project command:"codex --full-auto '修复 bug: #78'"
                

🐛 调试和问题修复

# 启动后台调试会话
bash pty:true workdir:~/myproject background:true command:"codex exec '调试这个错误：Error: Cannot read property x of undefined'"

# 监控进度
process action:log sessionId:<session-id>

# 发送输入（如需要确认）
process action:submit sessionId:<session-id> data:"y"
                

🔍 项目结构分析

# 读取项目文件
read file_path:~/project/package.json
read file_path:~/project/README.md

# 分析目录结构
exec command:"cd ~/project && find . -type f -name "*.js" | head -20"

# 生成分析报告
write file_path:/tmp/analysis.md content:"# 项目分析报告\n\n## 核心功能\n...\n## 技术栈\n..."
                

📋 需求分析与拆分

# 分析需求文档
read file_path:~/docs/requirements.md

# 询问用户确认
message action:send message:"我理解你的需求是：
1. [需求点1]
2. [需求点2]
3. [需求点3]

请确认是否正确？"

# 生成任务拆分
write file_path:/tmp/tasks.md content:"## 任务拆分\n\n### Phase 1: 基础功能\n- [ ] 任务1\n- [ ] 任务2\n\n### Phase 2: 增强功能\n..."
                

⚡ 工作量评估

# 代码行数统计
exec command:"cd ~/project && git diff --stat origin/main"

# 复杂文件分析
exec command:"cd ~/project && find . -name "*.py" -exec wc -l {} + | sort -rn | head -10"

# 输出评估报告
write file_path:/tmp/estimate.md content:"## 工作量评估\n\n### 规模\n- 约 X 行代码\n- Y 个模块\n\n### 风险点\n..."
                

📑 技术方案

# 创建技术设计文档
write file_path:~/docs/TECH_DESIGN.md content:"# 技术设计方案

## 概述
简要描述项目目标和范围

## 架构设计
### 系统架构图
[在此描述架构]

## 核心模块
### 模块1
- 功能描述
- 接口定义

## 技术选型
| 组件 | 选择 | 理由 |
|------|------|------|
| 语言 | Python | ... |
| 框架 | FastAPI | ... |

## 实施计划
### Phase 1
...

## 风险与应对
...
"
                

📊 PPT 大纲 / 演示文稿

# 生成 PPT 内容大纲
write file_path:~/docs/presentation.md content:"# 项目汇报

## 目录
1. 项目背景
2. 核心功能
3. 技术亮点
4. 成果展示
5. 下一步计划

## Slide 1: 项目背景
- 背景介绍
- 痛点分析

## Slide 2: 核心功能
- 功能1
- 功能2

## Slide 3: 技术亮点
...
"
                

📖 README 与文档

# 项目 README
write file_path:~/project/README.md content:"# 项目名称

[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)

## 简介
一句话描述项目

## 特性
- ✨ 特性1
- 🚀 特性2
- 🔧 特性3

## 快速开始

\`\`\`bash
# 安装
npm install

# 运行
npm start
\`\`\`

## 使用方法

## 文档

## 贡献

## 许可证
"
                

使用 ClawHub 安装技能

skill: clawhub

# 搜索技能
clawhub search <关键词>

# 安装技能
clawhub install <skill-name>

# 更新技能
clawhub update

# 发布自己的技能
clawhub publish <path>
                

🔧 配置技能

# 查看技能详情
clawhub info <skill-name>

# 查看已安装技能
clawhub list

# 查看技能配置需求
clawhub config <skill-name>
                

📋 任务分解模式

# 好的任务描述示例：
"创建一个用户认证模块，包括：
1. 注册接口（邮箱+密码）
2. 登录接口（返回 JWT）
3. 密码重置功能
4. 单元测试

技术栈：Node.js + Express + MongoDB"

# 不好的任务描述：
"帮我做个登录功能"
                

📁 文件组织建议

# 工作区结构
~/openclaw-workspace/
├── projects/          # 项目文件
├── docs/             # 文档和方案
├── scripts/          # 常用脚本
├── templates/       # 模板文件
└── memory/          # 记忆文件
    ├── MEMORY.md    # 长期记忆
    └── YYYY-MM-DD.md # 每日笔记
                

🔄 迭代开发流程

# 1. 分析需求
read file_path:~/docs/requirements.md

# 2. 创建任务清单
write file_path:/tmp/todo.md content:"## 待办事项\n- [ ] 任务1\n- [ ] 任务2"

# 3. 逐步执行
bash pty:true command:"codex exec '实现任务1'"

# 4. 验证结果
exec command:"cd ~/project && npm test"

# 5. 更新文档
write file_path:~/docs/progress.md content:"## 进度\n- [x] 任务1\n- [ ] 任务2"
                

Q: 编程代理没有输出/挂起

# ❌ 错误
bash command:"codex exec 'Hello'"

# ✅ 正确
bash pty:true command:"codex exec 'Hello'"
                    

Q: Codex 拒绝运行

# 创建临时 git 仓库
SCRATCH=$(mktemp -d) && cd $SCRATCH && git init && codex exec 'Hello'
                    

Q: 如何使用不同的 AI 模型？

# 配置示例
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "amazon-bedrock/anthropic.claude-opus-4-5-20251101-v1:0"
      }
    }
  }
}
                    

Q: 如何查看 OpenClaw 版本和状态？

# 版本信息
openclaw --version

# 系统状态
openclaw status

# Gateway 状态
openclaw gateway status
                

Q: 需要管理员权限的操作

# 使用 elevated 标志
bash elevated:true command:"sudo npm install -g some-package"

# 查看配置
openclaw config get

# 更新 OpenClaw
openclaw update.run