第 13 章：项目配置 ⭐

本章解决什么问题：学会让 AI 管理项目配置文件

学习目标：能够用自然语言让 AI 读取、修改、创建配置文件

版本基准：OpenClaw 3.13 前置条件：已完成第 12 章（调试代码）

---

📋 实测验证说明：本章所有配置示例均经过实测验证，基于真实项目配置。

---

13.1 读取配置文件

让 AI 帮你读取和理解配置文件。

基本用法

发送：

帮我看看 package.json 有哪些配置项

AI 回复（实测）：

好的，读取 package.json：

**项目信息**：
- 名称：my-app
- 版本：1.0.0
- 描述：My Application

**脚本命令**：
- start: 启动应用
- build: 构建项目
- test: 运行测试
- lint: 代码检查

**依赖**：
- express: ^4.18.0
- react: ^18.2.0

**开发依赖**：
- jest: ^29.0.0
- eslint: ^8.0.0

需要我帮你修改某个配置吗？

🔍 实测说明：实测时间 2026-03-20，AI 调用 read 工具读取配置文件

💡 新手建议：让 AI 解释配置文件时，可以问具体项，如"这个脚本是做什么的"。

---

13.2 不同场景的配置管理

场景一：添加依赖

发送：

给 package.json 添加 lodash 依赖

AI 回复（实测）：

好的，添加 lodash 依赖：

**修改内容**：
```json
{
  "dependencies": {
    "express": "^4.18.0",
    "react": "^18.2.0",
    "lodash": "^4.17.21"  // 新增
  }
}

✅ 已更新 package.json。

安装依赖：

npm install

需要我帮你安装吗？

### 场景二：修改配置

**发送**：

把启动端口改成 8080

**AI 回复**（实测）：

好的，修改配置：

文件：config.json

修改前：

{
  "port": 3000,
  "host": "localhost"
}

修改后：

{
  "port": 8080,
  "host": "localhost"
}

✅ 配置已更新。重启应用后生效。

### 场景三：创建配置文件

**发送**：

创建一个 .eslintrc.js 配置文件

**AI 回复**（实测）：

好的，创建 .eslintrc.js：

module.exports = {
    env: {
        browser: true,
        es2021: true,
        node: true
    },
    extends: [
        'eslint:recommended'
    ],
    parserOptions: {
        ecmaVersion: 'latest',
        sourceType: 'module'
    },
    rules: {
        'no-unused-vars': 'warn',
        'no-console': 'off',
        'indent': ['error', 2],
        'quotes': ['error', 'single'],
        'semi': ['error', 'always']
    }
};

✅ 文件已创建。

配置说明：

• 环境：浏览器 + Node.js
• 规则：未使用变量警告、允许 console、2 空格缩进、单引号、必须分号

需要我帮你添加更多规则吗？

### 场景四：环境变量配置

**发送**：

创建一个 .env.example 文件，包含常用的环境变量

**AI 回复**（实测）：

好的，创建 .env.example：

# 应用配置
NODE_ENV=development
PORT=3000

# 数据库
DB_HOST=localhost
DB_PORT=5432
DB_NAME=myapp
DB_USER=admin
DB_PASSWORD=your_password_here

# API 密钥
API_KEY=your_api_key_here
SECRET_KEY=your_secret_key_here

# 第三方服务
REDIS_URL=redis://localhost:6379

✅ 文件已创建。

使用说明：

1. 复制 .env.example 为 .env
2. 修改为实际的值
3. .env 文件不要提交到 Git

需要我帮你创建 .gitignore 吗？

---

## 13.3 高级用法

### 对比配置差异

**发送**：

对比 development 和 production 配置有什么不同

**AI 回复**（实测）：

好的，对比配置文件：

文件：config/development.json vs config/production.json

差异对比：

配置项	development	production
debug	true	false
logLevel	debug	error
cache	false	true
db.pool	5	20

主要区别：

1. production 关闭了 debug 模式
2. production 日志级别为 error（减少日志）
3. production 启用了缓存
4. production 数据库连接池更大

建议：确保 production 配置经过充分测试。

### 验证配置有效性

**发送**：

检查这个配置文件有没有语法错误

**AI 回复**（实测）：

好的，检查配置文件：

文件：config.json

检查结果： ✅ JSON 语法正确 ✅ 所有必需字段存在 ✅ 值类型正确

警告：

• port 值为字符串 "3000"，建议改为数字 3000

建议修复：

{
  "port": 3000  // 改为数字
}

需要我帮你修复吗？

### 批量修改配置

**发送**：

把所有配置文件中的端口号都改成 8080

**AI 回复**（实测）：

好的，批量修改配置：

修改的文件：

1. config/development.json: 3000 → 8080
2. config/production.json: 3000 → 8080
3. docker-compose.yml: 3000 → 8080

✅ 已修改 3 个文件。

验证：

grep -r "8080" config/

需要我帮你重启应用吗？

---

## 13.4 练习时间

### 练习 1：读取配置

**发送**：

帮我看看 tsconfig.json 有哪些配置

观察 AI 如何解释配置文件。

### 练习 2：添加配置

**发送**：

给 package.json 添加一个 lint 脚本

练习让 AI 修改配置。

### 练习 3：创建配置

**发送**：

创建一个简单的配置文件

练习让 AI 创建配置文件。

---

## 13.5 常见问题

### Q1：AI 能理解复杂的配置吗？

**说明**：
- 可以理解常见配置文件
- 如 package.json、tsconfig.json 等
- 复杂配置可能需要解释

### Q2：AI 修改配置安全吗？

**说明**：
- AI 会尽量保持原有结构
- 但建议 review 后再提交
- 重要配置需要人工验证

### Q3：AI 能帮我生成配置模板吗？

**说明**：
- 可以生成常见配置模板
- 如 ESLint、TypeScript、Docker 等
- 根据项目需求定制

### Q4：配置文件有语法错误怎么办？

**说明**：
- AI 可以帮忙检查语法
- 指出错误位置
- 提供修复建议

---

## ✅ 你已解锁能力

| 能力 | 状态 |
|------|------|
| 让 AI 读取配置文件 | ✅ 已掌握 |
| 让 AI 修改配置 | ✅ 已掌握 |
| 让 AI 创建配置文件 | ✅ 已掌握 |
| 让 AI 对比配置差异 | ✅ 已掌握 |

---

## 📊 自测题（3 题）

### 1. 如何让 AI 添加依赖？

**答案**：发送"给 package.json 添加 XXX 依赖"

### 2. 如何让 AI 检查配置语法？

**答案**：发送"检查这个配置文件有没有语法错误"

### 3. 如何让 AI 批量修改配置？

**答案**：说明修改要求，如"把所有配置文件中的端口号都改成 8080"

---

## 🎯 下一章预告

第 14 章：长期记忆

你将学会：
- 让 AI 记住重要信息
- 让 AI 管理记忆文件
- 让 AI 回忆之前的内容

**提前试试**：

记住这个信息：...

> 本文由郭峰主导，基于 GPT-5.4、OpenClaw Agent 完成，并经人工审校定稿。

---

> **课后练习**（可选）
> 1. 让 AI 读取一个配置文件
> 2. 让 AI 修改某个配置项
> 3. 让 AI 创建一个新的配置文件
> 
> 有任何问题，随时在群里提问！ 🚀