引言

不知道你在写代码时有没有这样的经历：明明记得某个语法，但就是写不出来；或者写注释比写代码还费时间。如今，嵌入到编辑器中的AI模型正在彻底改变这一现状。本文将详细介绍OpenClaw（龙虾）和Codex的使用方法，涵盖全平台部署、核心功能、实战案例和避坑指南，帮助你提升编程效率。

1. 什么是OpenClaw和Codex？

• OpenClaw：一个开源的AI代理框架，昵称“小龙虾”。它不仅可以作为AI助手，还能通过“技能”（Skills）进行扩展，实现从代码生成到自动化运维的各种功能。OpenClaw的核心价值在于编排——它可以调度不同的AI模型（如Claude、GPT-4）完成复杂任务，例如“口述修Bug”或“自动提交PR”。

• Codex：是OpenAI开发的早期AI代码生成模型（GPT-3的后代），它是GitHub Copilot的内核。你只需写注释或函数名，它就能自动补全代码。在现代工作流中，我们通常使用更先进的GPT-4级别模型来完成Codex风格的编码任务。

2. 部署方案对比与选型

部署方案	核心优势	适用场景	配置要求	维护成本	插件适配性
阿里云部署	7×24小时运行、多设备访问、支持团队协作	团队项目、长期开发任务	最低2vCPU+4GiB内存	低（阿里云自带运维）	完美适配，支持远程提交PR
本地部署	零费用、数据隐私可控、低延迟	个人开发、短期项目	内存≥8GiB，Node.js 22.x+	中（需自行处理依赖）	支持所有核心功能

3. 本地全平台部署教程（Win/Mac/Linux）

3.1 前置依赖安装

Windows 11（管理员模式）：

powershell

# 安装Node.js 22.x（国内镜像加速）
iwr -useb https://npmmirror.com/mirrors/node/v22.10.0/node-v22.10.0-x64.msi -OutFile node-install.msi
Start-Process .\node-install.msi -Wait

# 安装Git
winget install Git.Git

# 配置Git凭证
git config --global user.name "你的GitHub用户名"
git config --global user.email "你的GitHub邮箱"

# 配置npm国内镜像
npm config set registry https://registry.npmmirror.com

# 验证安装
node --version  # 需显示v22.x.x
git --version

MacOS 12+：

bash

# 安装Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装依赖
brew install node@22 git

# 配置环境变量
echo 'export PATH="/usr/local/opt/node@22/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# 配置Git
git config --global user.name "你的GitHub用户名"
git config --global user.email "你的GitHub邮箱"

# 配置npm镜像
npm config set registry https://registry.npmmirror.com

Linux (Ubuntu 20.04+)：

bash

# 安装Node.js 22.x
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash
sudo apt install -y nodejs git

# 配置Git
git config --global user.name "你的GitHub用户名"
git config --global user.email "你的GitHub邮箱"

# 配置npm镜像
npm config set registry https://registry.npmmirror.com

# 解决权限问题
sudo chmod -R 777 /usr/local/lib/node_modules

3.2 OpenClaw核心安装

bash

# 全局安装OpenClaw
npm install -g openclaw@latest

# 创建工作目录
mkdir -p ~/OpenClaw-Dev/{projects,config} && cd ~/OpenClaw-Dev

# 初始化配置
openclaw init

# 启动Gateway服务
openclaw gateway start

# 验证服务（浏览器访问 http://localhost:18789）

4. Codex的三种使用方式

4.1 终端（CLI）中使用Codex

Codex风格的CLI允许你通过自然语言直接操作代码库：

bash

# 安装CLI工具（示例）
npm install -g codex-cli

# 设置API密钥
export OPENAI_API_KEY=your_api_key_here

# 启动交互式会话
codex

# 在提示符下输入需求，例如：
# "扫描当前repo，总结架构，并找出两个低风险的重构点"
# "为src/utils/date.ts编写单元测试，覆盖边缘情况"

4.2 VS Code中使用Codex（通过GitHub Copilot）

1. 安装插件：在VS Code扩展商店搜索“GitHub Copilot”并安装

2. 登录验证：使用GitHub账号登录，开通Copilot服务

3. 核心用法：

   • 代码补全：输入函数名或注释，Copilot会自动显示建议代码，按Tab接受

   • 选择代码重构：选中代码块，右键选择“Ask Copilot”，输入“重构此函数，添加错误处理”

   • 生成测试：在测试文件中输入“// 测试上面的函数”，Copilot会自动生成测试用例

4.3 JetBrains IDE中使用Codex

在IntelliJ IDEA、PyCharm等IDE中，Codex的用法类似：

• 选择代码后使用：选中要修改的代码，打开AI助手聊天窗口（右上角小部件），被选中的代码会自动作为上下文附加

• 光标位置插入：将光标放在想要插入新代码的位置，打开聊天窗口，当Codex提供代码片段时，点击“Insert at caret”按钮即可在当前位置插入

5. OpenClaw高级功能：自定义技能开发

OpenClaw的强大之处在于其可扩展性。ClawHub社区已提供超过700个社区技能。你也可以创建自定义技能。

5.1 创建简单的SKILL.md技能

创建一个weather-skill/SKILL.md文件：

markdown

---
name: weather-alert
description: 获取天气预警信息
triggers:
  - "天气"
  - "天气预警"
  - "今天天气怎么样"
requires:
  - location
actions:
  - name: get_weather
    api: https://api.weather.com/v3
    params:
      location: "{location}"
---

# 天气预警技能

此技能提供您所在位置的天气预警和预报信息。

## 配置

在技能配置中设置您的位置：
- city: 您的城市名称
- units: metric 或 imperial

5.2 创建TypeScript技能（高级）

对于更复杂的集成，TypeScript技能提供完全控制：

typescript

// src/index.ts
import { Skill, SkillContext, SkillResult } from '@openclaw/skill-sdk';
import axios from 'axios';

export default class GitHubSkill implements Skill {
  name = 'github';
  description = '与GitHub仓库交互';

  async execute(context: SkillContext): Promise<SkillResult> {
    const { userMessage, config } = context;
    const message = userMessage.content.toLowerCase();

    if (message.includes('list repos')) {
      return this.listRepositories(config);
    }

    return {
      message: '我可以帮助列出仓库、创建issue等操作。',
      actions: []
    };
  }

  private async listRepositories(config: any): Promise<SkillResult> {
    const response = await axios.get('https://api.github.com/user/repos', {
      headers: { Authorization: `token ${config.githubToken}` }
    });
    
    const repos = response.data.slice(0, 5).map((r: any) => r.name).join('\n');
    return {
      message: `您最近的仓库：\n${repos}`,
      actions: []
    };
  }
}

6. 实战案例：口述修Bug全流程

OpenClaw最惊艳的功能是“口述修Bug”——你只需用自然语言描述问题，AI会自动完成定位、修复、测试和提交PR的全流程。

步骤示例：

1. 发现问题：在项目运行时发现一个按钮点击无效的Bug

2. 口述需求：对OpenClaw说“修复登录页面的按钮点击无效问题”

3. AI自动执行：

   • 扫描代码库，定位到相关组件

   • 分析可能的错误原因（事件绑定错误、状态未更新等）

   • 生成修复代码

   • 启动测试服务器验证

   • 创建新分支，提交更改，生成PR描述

4. 人工审查：审查AI生成的代码，确认无误后合并

整个过程从传统的30分钟缩短到5-10分钟，极大提升了开发效率。

7. 避坑指南与最佳实践

7.1 提示词工程技巧

生成UI代码时，好的提示词能显著提升输出质量：

• 糟糕的提示：“做一个按钮”

• 好的提示：“一个主要按钮，16px内边距，蓝色背景#3B82F6，白色文字，圆角8px，悬停状态变深至#2563EB，使用语义化的<button>标签”

7.2 安全与隐私

• 绝不粘贴密钥：永远不要在提示中包含API密钥、密码或客户数据

• 审查生成代码：将AI建议视为初级工程师的输出，需要审查、测试关键路径

• 记录AI辅助的更改：在PR中注明哪些部分由AI生成，便于审计

8. 未来展望

未来的编程范式将是“人机协作”：

• 程序员：负责架构设计、逻辑拆解、代码审查

• AI：负责快速原型生成、重复代码编写、测试用例补全、Bug修复建议

通过OpenClaw这样的编排工具，我们甚至可以让AI集群帮我们完成一整个模块的开发，我们只需做最终的决策者。拥抱新技术，你才能始终站在效率的前沿。