claw

# OpenClaw 安装与渠道接入

完成 OpenClaw 安装配置，并引导接入指定渠道。

---

## 参数解析

从命令参数中提取渠道名称（`$ARGUMENTS`）：

- 有效渠道：`feishu`、`weixin`、`wecom`、`qq`
- 若参数不在上述列表中（且不为空），输出错误：**「未知渠道：<参数>，支持的渠道为 feishu / weixin / wecom / qq」**，然后停止执行
- 若参数为空，暂不处理，等安装完成后提示

---

## Step 1：检测并安装 OpenClaw

检查是否已安装：

```bash
openclaw --version
```

若未安装，执行下面命令安装：

```bash
npm install -g openclaw --registry=https://registry.npmmirror.com
```

安装后验证：

```bash
openclaw --version
```

---

## Step 1.5：检查新手引导配置状态

使用 Read 工具读取 `~/.openclaw/openclaw.json`。

**判断逻辑：**

- 若文件**不存在**或读取失败 → 继续执行 Step 2 和 Step 3（新手引导）
- 若文件**存在**，检查以下条件是否**同时满足**：
  1. `models.providers` 数组非空（已配置模型提供者）
  2. `gateway.port` 存在（网关已配置）

若以上条件**全部满足** → 提示用户「检测到新手引导已完成，跳过新手配置」，然后**直接跳至渠道选择步骤**。

否则 → 继续执行 Step 2 和 Step 3。

---

## Step 2：读取用户凭据

1. 读取 `~/.coder/config.json`（注意：是 `.coder` 目录，不是 `.codev`）
2. 提取 `auth.ak` 和 `auth.sk` 字段的**原始值**，不做任何修改
3. 构造 `API_KEY = {auth.ak}.{auth.sk}`（直接拼接，中间加一个英文句点），记录备用
4. 向用户确认构造结果：输出 `API_KEY 前缀为：{auth.ak}` 以便核对

---

## Step 3：运行新手引导

```bash
openclaw onboard --non-interactive --accept-risk \
  --auth-choice custom-api-key \
  --custom-base-url "https://makecoder.com/bigapis/codev/v1/claude" \
  --custom-model-id "Claude Sonnet 4.6" \
  --custom-api-key "<Step 2 中的 API_KEY>" \
  --secret-input-mode plaintext \
  --custom-compatibility anthropic \
  --gateway-port 18789 \
  --gateway-bind loopback \
  --install-daemon \
  --daemon-runtime node \
  --skip-skills
```

命令完成后，修改 `~/.openclaw/openclaw.json`，对 `models.providers.models` 数组中**每一个**模型对象，设置或覆盖以下字段（已存在则覆盖为 18000，不存在则新增）：

```json
"contextWindow": 18000,
"maxTokens": 18000
```

---

## 渠道选择

OpenClaw 安装配置完成后，根据参数决定下一步：

### 若参数已提供（feishu / weixin / wecom / qq）

直接跳转执行对应渠道的安装流程（见下方各渠道章节）。

### 若参数未提供

调用 `AskUserQuestion` 工具询问用户选择渠道，问题和选项如下：

- **question**：`OpenClaw 已安装配置完成！请选择要接入的渠道：`
- **header**：`渠道选择`
- **options**：
  - `{ label: "feishu（飞书）", description: "飞书智能机器人" }`
  - `{ label: "weixin（微信）", description: "微信 ClawBot" }`
  - `{ label: "wecom（企业微信）", description: "企业微信智能机器人" }`
  - `{ label: "qq（QQ）", description: "QQ 机器人" }`

根据用户所选选项的 label 前缀（feishu / weixin / wecom / qq）执行对应渠道流程。

---

## 渠道安装流程

根据选定渠道，读取并执行 `references/` 目录下对应渠道文件中的步骤：

- **feishu**：执行 `references/feishu.md` 中的全部步骤
- **weixin**：执行 `references/weixin.md` 中的全部步骤
- **wecom**：执行 `references/wecom.md` 中的全部步骤
- **qq**：执行 `references/qq.md` 中的全部步骤