npm package: @superyan/openclaw-config
Description: 一键配置 OpenClaw 使用 InsCode AI - 只需提供 API Key
Author: yanhui
Latest version: 1.0.3

# OpenClaw InsCode Config

一键配置 OpenClaw 使用 InsCode AI - 只需提供 API Key!

## ✨ 特点

- ✅ **极简配置** - 只需提供 API Key
- ✅ **写死配置** - Base URL 和默认模型已预配置
- ✅ **npx 运行** - 无需安装,直接使用
- ✅ **多模型支持** - 支持 5 种 InsCode AI 模型
- ✅ **自动备份** - 配置前自动备份

## 🚀 快速开始

### 一键配置(推荐)

```bash
npx @superyan/openclaw-config your-api-key-here
```

就这么简单! 🎉

### 指定模型

```bash
npx @superyan/openclaw-config your-api-key --model Deepseek-V3
```

## 📋 使用方法

### 方式1: 直接传递 API Key

```bash
npx @superyan/openclaw-config sk-xxxxxxxxxxxxxxxx
```

### 方式2: 使用选项

```bash
npx @superyan/openclaw-config -k sk-xxxxxxxxxxxxxxxx
```

### 方式3: 指定模型和别名

```bash
npx @superyan/openclaw-config \
  -k sk-xxxxxxxxxxxxxxxx \
  -m Deepseek-V3 \
  -a DeepSeek3
```

## 📦 可用模型

| 模型 | 说明 |
|------|------|
| **Deepseek-R1** ⭐ | 深度推理模型 (默认) |
| **Deepseek-V3** | 第三代深度模型 |
| **QwQ-32B** | QwQ 32B 参数模型 |
| **Qwen2.5-72B** | 通义千问 2.5 大模型 |
| **DeepSeek-R1-Distill-Qwen-32B** | DeepSeek-R1 蒸馏版本 |

查看所有模型:
```bash
npx @superyan/openclaw-config models
```

## 🔍 查看配置

```bash
# 查看当前配置(隐藏 API Key)
npx @superyan/openclaw-config show

# 显示完整 API Key
npx @superyan/openclaw-config show -s
```

## 📖 命令参考

| 命令 | 说明 |
|------|------|
| `npx @superyan/openclaw-config <key>` | 配置 API Key |
| `npx @superyan/openclaw-config show` | 查看配置 |
| `npx @superyan/openclaw-config models` | 列出可用模型 |
| `npx @superyan/openclaw-config --help` | 查看帮助 |

### 选项

| 选项 | 说明 | 示例 |
|------|------|------|
| `-k, --api-key <key>` | InsCode AI API Key | `-k sk-xxxxx` |
| `-m, --model <model>` | 模型名称 | `-m Deepseek-V3` |
| `-a, --alias <alias>` | 模型别名 | `-a DeepSeek` |

## 💡 使用示例

### 示例1: 使用默认模型 (Deepseek-R1)

```bash
npx @superyan/openclaw-config sk-xxxxxxxxxxxxxxxx
```

输出:
```
🚀 配置 OpenClaw 使用 InsCode AI

📦 配置备份: /Users/xxx/.openclaw/openclaw.json.backup.2024-03-09...
✅ 配置已更新
✓ InsCode AI 配置完成!

📋 配置详情:
   提供商: inscode
   Base URL: https://models.csdn.net/v1
   模型: Deepseek-R1
   别名: InsCode
   API Key: sk-xxxxxxxx...xxxx

✨ 配置成功!

💡 提示: 重启 OpenClaw 以加载新配置
   openclaw restart
```

### 示例2: 使用 Deepseek-V3 模型

```bash
npx @superyan/openclaw-config \
  -k sk-xxxxxxxxxxxxxxxx \
  -m Deepseek-V3 \
  -a DeepSeek3
```

### 示例3: 使用通义千问

```bash
npx @superyan/openclaw-config \
  -k sk-xxxxxxxxxxxxxxxx \
  -m Qwen2.5-72B \
  -a Qwen
```

### 示例4: 查看配置

```bash
npx @superyan/openclaw-config show
```

输出:
```
📋 当前 InsCode AI 配置:

🤖 当前模型:
   Deepseek-R1
   别名: InsCode

🔑 API 配置:
   提供商: inscode
   Base URL: https://models.csdn.net/v1
   API Key: sk-xxxxxxxx...xxxx

📦 可用模型:
   ● Deepseek-R1 (当前)
   ○ Deepseek-V3
   ○ QwQ-32B
   ○ Qwen2.5-72B
   ○ DeepSeek-R1-Distill-Qwen-32B
```

## 🔧 配置信息

### 自动配置内容

执行命令后,工具会自动配置:

- **Base URL**: `https://models.csdn.net/v1`
- **Provider**: `inscode`
- **Model**: `Deepseek-R1` (默认,可修改)
- **API Key**: 您提供的密钥
- **Profile**: `inscode:default`

### 配置文件

配置保存在: `~/.openclaw/openclaw.json`

备份文件: `~/.openclaw/openclaw.json.backup.YYYY-MM-DDTHH-MM-SS-mmmZ`

## 🎯 获取 API Key

1. 访问 [InsCode AI](https://models.csdn.net/)
2. 注册/登录账号
3. 获取 API Key
4. 运行配置命令

## 🆚 与通用版本的区别

| 特性 | 通用版 | InsCode 专用版 |
|------|--------|----------------|
| **参数数量** | 5个参数 | 1个参数(API Key) |
| **Base URL** | 需要输入 | 自动配置 |
| **模型名称** | 需要输入 | 可选(有默认值) |
| **配置复杂度** | 中等 | 极简 |
| **适用场景** | 多平台 | InsCode AI 专用 |

## ⚠️ 常见问题

### Q: 如何获取 InsCode AI API Key?

A: 访问 https://models.csdn.net/ 注册并获取

### Q: 支持哪些模型?

A: 运行 `npx @superyan/openclaw-config models` 查看

### Q: 配置后需要重启吗?

A: 是的,运行 `openclaw restart` 重启

### Q: 如何切换模型?

A: 重新运行配置命令并指定不同的模型:
```bash
npx @superyan/openclaw-config -k your-key -m Deepseek-V3
```

### Q: 配置文件在哪里?

A: `~/.openclaw/openclaw.json`

### Q: 如何恢复之前的配置?

A: 查看备份文件:
```bash
ls -lt ~/.openclaw/*.backup.*
cp ~/.openclaw/openclaw.json.backup.xxxx ~/.openclaw/openclaw.json
```

## 🔗 相关链接

- **InsCode AI 文档**: https://inscode-ai-doc.inscode.cc/
- **InsCode AI 官网**: https://models.csdn.net/
- **OpenClaw**: https://openclaw.ai/

## 📝 许可证

MIT

---

**快速开始:**

```bash
npx @superyan/openclaw-config your-api-key
```

就这么简单! 🚀