# AI龙虾 · 常用工具安装指南

> 本文档介绍AI龙虾体系下常用工具的功能定位、适用场景和安装步骤。
> 零基础同事请按「推荐顺序」安装，不要一次全装。

---

## 目录

1. [工具定位总览](#工具定位总览)
2. [安装顺序建议](#安装顺序建议)
3. [WorkBuddy](#workbuddy)
4. [CodeBuddy](#codebuddy)
5. [OpenClaw](#openclaw)
6. [Codex](#codex)
7. [OpenCode](#opencode)
8. [QClaw](#qclaw)
9. [常见问题](#常见问题)

---

## 工具定位总览

| 工具 | 定位 | 适合人群 | 难度 |
|------|------|----------|------|
| **WorkBuddy** | 桌面AI助手，日常任务执行 | 所有人 | ⭐ |
| **CodeBuddy** | IDE内AI编程助手 | 开发人员 | ⭐⭐ |
| **OpenClaw** | 龙虾团自动化框架，任务编排 | 进阶用户 | ⭐⭐⭐ |
| **Codex** | OpenAI代码生成工具 | 开发人员 | ⭐⭐ |
| **OpenCode** | 开源代码助手 | 开发人员 | ⭐⭐ |
| **QClaw** | 腾讯内部龙虾工具集 | 腾讯员工 | ⭐⭐ |

---

## 安装顺序建议

```
第一次接触AI龙虾的用户，推荐按这个顺序：

第1步：WorkBuddy（最快上手，5分钟能用）
   ↓
第2步：CodeBuddy（写代码用，配合WorkBuddy效果更好）
   ↓
第3步：OpenClaw（需要自动化任务时再装）
   ↓
其他工具按需安装
```

---

## WorkBuddy

### 是什么

WorkBuddy 是AI龙虾的**桌面主入口**，装在电脑上，像一个有记忆、能执行任务的AI同事。

- 支持对话、执行任务、读写文件、运行自动化
- 有记忆系统（跨会话记住你的偏好）
- 支持Skill扩展（安装新能力包）
- 支持微信小程序配套使用

### 适用场景

- ✅ 写文章、PPT、报告
- ✅ 处理Excel/数据分析
- ✅ 整理资料、生成工具页
- ✅ 定时自动化任务
- ❌ 不适合：需要深度编程的场景（用CodeBuddy）

### 安装步骤

**Windows / macOS 通用**

1. 访问官网：https://www.workbuddy.cn
2. 点击「下载」→ 选择对应系统版本
3. 安装完成后打开，按引导完成初始化
4. 登录账号（微信扫码或手机号）
5. 验证：在对话框输入「你好」，收到回复即成功

**首次配置建议**

```
设置 → 偏好设置 →
  ☑ 允许读写本地文件
  ☑ 允许执行自动化任务
  ☑ 开启记忆系统
```

### 验证安装成功

在WorkBuddy对话框输入：

```
请介绍一下你自己，并告诉我你当前的工作目录在哪里。
```

能正常回复并显示路径，说明安装成功。

---

## CodeBuddy

### 是什么

CodeBuddy 是**IDE内的AI编程助手**，装在VS Code / JetBrains等编辑器里，写代码时实时辅助。

- 代码补全、解释、重构
- Bug定位和修复建议
- 支持多种编程语言
- 与WorkBuddy共享记忆（需配置）

### 适用场景

- ✅ 写代码时实时辅助
- ✅ 代码审查和优化建议
- ✅ 自动生成单元测试
- ✅ 代码注释和文档生成

### 安装步骤（VS Code）

1. 打开 VS Code
2. 扩展商店搜索 `CodeBuddy`
3. 点击安装
4. 安装完成后，右侧会出现CodeBuddy图标
5. 登录账号（与WorkBuddy同一账号）
6. 验证：在代码文件中按 `Ctrl+Shift+P` → 输入 `CodeBuddy: 开始对话`

**JetBrains 系列（IntelliJ / PyCharm 等）**

1. `Settings` → `Plugins` → 搜索 `CodeBuddy`
2. 安装并重启IDE
3. 右侧工具栏找到CodeBuddy面板

### 与WorkBuddy联动配置

```
CodeBuddy 设置 → 高级 →
  勾选「与WorkBuddy共享记忆」
  设置WorkBuddy安装路径（自动检测，如失败需手动填写）
```

---

## OpenClaw

### 是什么

OpenClaw 是AI龙虾的**自动化任务框架**，让AI能够自主规划、执行多步骤任务，是「龙虾团」的底层引擎。

- 支持多Agent协作（龙虾团各角色）
- 支持定时任务、条件触发
- 与WorkBuddy深度集成
- 开源，可自行扩展

### 适用场景

- ✅ 需要AI自动完成多步骤任务
- ✅ 定时生成报告/同步数据
- ✅ 多Agent协作完成复杂项目
- ⚠️ 建议先熟悉WorkBuddy后再使用

### 安装步骤

**方式一：通过WorkBuddy安装（推荐）**

1. 打开WorkBuddy
2. `设置` → `Skill管理` → `浏览市场`
3. 搜索 `openclaw` → 点击安装
4. 安装完成后重启WorkBuddy

**方式二：手动安装**

```bash
# 要求：已安装 Node.js 18+
npm install -g openclaw

# 验证
openclaw --version
```

### 基础配置

安装完成后，在WorkBuddy中测试：

```
请帮我创建一个自动化任务：
每天上午9点，读取我的日程并生成今日待办清单。
```

AI会引导你完成配置，无需手动写配置。

---

## Codex

### 是什么

Codex 是 OpenAI 推出的**代码生成模型**的命令行工具，可通过API调用，也可本地部署。

- 基于GPT系列模型
- 支持多种编程语言
- 可通过API调用（需API Key）
- 本地部署版本可选

### 适用场景

- ✅ 批量生成代码片段
- ✅ 代码翻译（一种语言转另一种）
- ✅ 与自有系统集成的代码生成需求
- ⚠️ 需要API Key或有本地部署资源

### 安装步骤

**API方式（最简单）**

1. 注册 OpenAI 账号：https://platform.openai.com
2. 生成 API Key：`API Keys` → `Create new secret key`
3. 安装 OpenAI CLI：

```bash
pip install openai
```

4. 配置API Key：

```bash
export OPENAI_API_KEY="your-api-key-here"
```

5. 测试：

```python
import openai
response = openai.ChatCompletion.create(
  model="gpt-4",
  messages=[{"role": "user", "content": "写一个Python快排"}]
)
print(response.choices[0].message.content)
```

**本地部署（高级用户）**

参考官方文档：https://github.com/openai/codex

---

## OpenCode

### 是什么

OpenCode 是一个**开源的AI代码助手**，类似CodeBuddy但完全开源，可自行部署和定制。

- 开源免费
- 支持多种开源模型（CodeLlama、DeepSeek Coder等）
- 可自行部署，数据不出内网
- 支持VS Code插件和Web界面

### 适用场景

- ✅ 对数据隐私有要求（不能外传代码）
- ✅ 需要定制化AI能力
- ✅ 希望降低成本（使用开源模型）
- ⚠️ 需要一定技术能力部署

### 安装步骤

**快速启动（Docker方式，推荐）**

```bash
# 要求：已安装Docker
git clone https://github.com/opencode-ai/opencode.git
cd opencode
docker-compose up -d
```

访问 `http://localhost:8080` 即可使用。

**VS Code 插件方式**

1. 扩展商店搜索 `OpenCode`
2. 安装后配置模型地址（默认连接本地部署的模型）
3. 如无本地模型，可配置兼容OpenAI API的云端模型

---

## QClaw

### 是什么

QClaw 是**腾讯内部**的龙虾工具集，集成了腾讯内部系统和数据源，仅供腾讯员工使用。

- 集成腾讯文档、腾讯会议、企业微信等
- 接入内部数据源（OA、HR系统等）
- 与OpenClaw兼容，额外增加腾讯生态能力
- 需要通过腾讯内网或VPN访问

### 适用场景

- ✅ 腾讯内部员工自动化办公
- ✅ 操作腾讯文档/会议/邮件
- ✅ 读取内部系统数据进行分析
- ❌ 外部用户无法使用

### 安装步骤（腾讯内网）

1. 访问腾讯内部插件市场（OA → 应用中心 → AI工具）
2. 搜索 `QClaw` → 点击安装
3. 安装完成后需要权限申请（首次使用会引导）
4. 验证：在WorkBuddy中输入 `QClaw状态`

> ⚠️ 非腾讯员工可跳过此工具。

---

## 常见问题

### Q1：这些工具之间是什么关系？

```
WorkBuddy  ← 主入口，日常使用
    ↓ 联动
CodeBuddy  ← 写代码时用
    ↓ 联动
OpenClaw   ← 自动化任务框架（WorkBuddy内置）
    ↓ 可选扩展
Codex / OpenCode ← 代码生成引擎（可切换）
    ↓ 腾讯内部专属
QClaw      ← 腾讯生态集成
```

### Q2：我需要全部安装吗？

**不需要。** 建议：

- 非开发人员：只装 **WorkBuddy**
- 开发人员：WorkBuddy + **CodeBuddy**
- 需要自动化：再加 **OpenClaw**
- 其他按需

### Q3：安装后AI没有响应？

按这个顺序排查：

1. 检查网络连接（能否访问 workbuddy.cn）
2. 检查账号登录状态
3. 重启应用
4. 查看 `设置 → 关于` 是否有更新

### Q4：这些工具收费吗？

| 工具 | 费用 |
|------|------|
| WorkBuddy | 基础版免费，高级功能订阅 |
| CodeBuddy | 与WorkBuddy套餐绑定 |
| OpenClaw | 开源免费 |
| Codex | 按API调用量收费 |
| OpenCode | 开源免费（模型费用另计） |
| QClaw | 腾讯内部免费 |

### Q5：公司电脑限制安装软件怎么办？

1. 先尝试**绿色版/便携版**（WorkBuddy提供）
2. 联系IT部门申请白名单
3. 使用**Web版**（如可用）：https://app.workbuddy.cn

---

## 下一步

工具安装完成后，回到培训讲义：

- 第1讲：用 WorkBuddy 完成第一个任务
- 第2讲：练习给AI下指令（COSTAR Pro / 四要素公式）
- 第3讲：配置记忆系统和自动化任务

---

*最后更新：2026-06-11 · 由2号八戒整理*