---
read_when:
    - 你想在穩定版/測試版/開發版之間切換
    - 您想要固定特定版本、標籤或 SHA
    - 你正在標記或發布預發行版本
sidebarTitle: Release Channels
summary: stable、beta 和 dev 通道：語意、切換、固定版本和標記
title: 發布通道
x-i18n:
    generated_at: "2026-05-07T13:20:56Z"
    model: gpt-5.5
    provider: openai
    source_hash: d2516165635eb8fbaddf19e07fbb591b659479b5226c2bf467e29247552ababb
    source_path: install/development-channels.md
    workflow: 16
---

OpenClaw 提供三個更新通道：

- **stable**：npm dist-tag `latest`。建議大多數使用者使用。
- **beta**：npm dist-tag `beta`，若目前存在且為最新；如果 beta 缺少或比
  最新穩定版本更舊，更新流程會退回使用 `latest`。
- **dev**：`main` 的移動最新狀態（git）。npm dist-tag：`dev`（發布時）。
  `main` 分支用於實驗與積極開發。它可能包含
  未完成的功能或破壞性變更。請勿將其用於生產環境 gateways。

我們通常會先將穩定建置發布到 **beta**，在該通道測試後，再執行
明確的提升步驟，將已驗證的建置移至 `latest`，且不
變更版本號。維護者也可以在需要時將穩定版本
直接發布到 `latest`。Dist-tags 是 npm
安裝的事實來源。

## 切換通道

```bash
openclaw update --channel stable
openclaw update --channel beta
openclaw update --channel dev
```

`--channel` 會將你的選擇保存在 config（`update.channel`）中，並對齊
安裝方式：

- **`stable`**（套件安裝）：透過 npm dist-tag `latest` 更新。
- **`beta`**（套件安裝）：優先使用 npm dist-tag `beta`，但當 `beta` 缺少或比
  目前穩定標籤更舊時，會退回使用 `latest`。
- **`stable`**（git 安裝）：checkout 最新的穩定 git 標籤。
- **`beta`**（git 安裝）：優先使用最新的 beta git 標籤，但當 beta 缺少或更舊時，會退回使用
  最新的穩定 git 標籤。
- **`dev`**：確保有 git checkout（預設 `~/openclaw`，可用
  `OPENCLAW_GIT_DIR` 覆寫）、切換到 `main`、在 upstream 上 rebase、建置，並從該 checkout
  安裝全域 CLI。

<Tip>
如果你想並行使用 stable 與 dev，請保留兩個 clones，並讓你的 gateway 指向 stable 的那個。
</Tip>

## 一次性指定版本或標籤

使用 `--tag` 針對特定 dist-tag、版本或套件規格執行單次
更新，且**不會**變更你已保存的通道：

```bash
# Install a specific version
openclaw update --tag 2026.4.1-beta.1

# Install from the beta dist-tag (one-off, does not persist)
openclaw update --tag beta

# Install from GitHub main branch (npm tarball)
openclaw update --tag main

# Install a specific npm package spec
openclaw update --tag openclaw@2026.4.1-beta.1
```

注意事項：

- `--tag` **僅適用於套件（npm）安裝**。Git 安裝會忽略它。
- 標籤不會被保存。下一次 `openclaw update` 會照常使用你設定的
  通道。
- 降級保護：如果目標版本比你目前的版本更舊，
  OpenClaw 會提示確認（可用 `--yes` 跳過）。
- `--channel beta` 與 `--tag beta` 不同：通道流程在 beta 缺少或更舊時，可能退回到
  stable/latest；而 `--tag beta` 只會在該次執行中指定原始的
  `beta` dist-tag。

## Dry run

預覽 `openclaw update` 會做什麼，而不實際變更：

```bash
openclaw update --dry-run
openclaw update --channel beta --dry-run
openclaw update --tag 2026.4.1-beta.1 --dry-run
openclaw update --dry-run --json
```

Dry run 會顯示有效通道、目標版本、計畫動作，以及
是否需要降級確認。

## Plugins 與通道

當你使用 `openclaw update` 切換通道時，OpenClaw 也會同步 Plugin
來源：

- `dev` 優先使用 git checkout 中的 bundled plugins。
- `stable` 與 `beta` 會還原 npm 安裝的 Plugin 套件。
- npm 安裝的 plugins 會在核心更新完成後更新。

## 檢查目前狀態

```bash
openclaw update status
```

顯示作用中的通道、安裝種類（git 或套件）、目前版本，以及
來源（config、git tag、git branch 或 default）。

## 標記最佳實務

- 為你希望 git checkout 落到的版本加上標籤（stable 使用 `vYYYY.M.D`，
  beta 使用 `vYYYY.M.D-beta.N`）。
- `vYYYY.M.D.beta.N` 也會被辨識以保持相容性，但建議使用 `-beta.N`。
- 舊版 `vYYYY.M.D-<patch>` 標籤仍會被辨識為 stable（非 beta）。
- 保持標籤不可變：絕不要移動或重複使用標籤。
- npm dist-tags 仍是 npm 安裝的事實來源：
  - `latest` -> stable
  - `beta` -> candidate build 或 beta-first stable build
  - `dev` -> main snapshot（可選）

## macOS app 可用性

Beta 與 dev 建置可能**不**包含 macOS app 發布。這沒問題：

- git tag 與 npm dist-tag 仍然可以發布。
- 在 release notes 或 changelog 中註明「此 beta 沒有 macOS build」。

## 相關

- [更新](/zh-TW/install/updating)
- [安裝程式內部機制](/zh-TW/install/installer)