> For the complete documentation index, see [llms.txt](https://docs.cherry-ai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherry-ai.com/docs/zhong-wen-fan-ti/advanced-basic/openclaw.md).

# OpenClaw

**OpenClaw 係一款獨立嘅開源 AI 智能體工具**，提供高度可自訂嘅 Agent 運行同互動服務，由獨立開源團隊開發。

對於想體驗 OpenClaw 強大能力嘅普通用戶，Cherry Studio 提供咗 **一鍵式整合介面**。你唔使自己搞掂複雜嘅底層命令、運行依賴同代理，直接喺 Cherry Studio 入面就可以重用已配置好嘅模型服務（Provider）一鍵開啟 OpenClaw 託管服務。

{% hint style="info" %}
**我使唔使需要 OpenClaw？**

* **普通用戶**：如果你只係喺 Cherry Studio 客戶端嘅圖形介面入面日常使用智能體，直接參考 [**智能體**](/docs/zhong-wen-fan-ti/cherry-studio/preview/agent.md) 就得，**唔需要** 啟用 OpenClaw。
* **嘗試體驗／深度用戶**：如果你希望喺終端或獨立工作流入面體驗 OpenClaw 項目，可以用本模組快速啟動 Gateway 服務。
  {% endhint %}

### 安裝 OpenClaw

喺頂部 Tab 欄撳 `+` ➡️ **啟動台** ➡️ 撳 **OpenClaw** 圖示。第一次入嚟會見到：

<figure><img src="/files/0b4f0cf8a283ddfe79d5ac7a295526782017d28f" alt=""><figcaption><p>OpenClaw 未安裝狀態</p></figcaption></figure>

* 撳 **安裝 OpenClaw** ➡️ Cherry Studio 會自動由官方來源下載並安裝 OpenClaw 最新嘅運行二進制包。
* 安裝完成之後，頁面會轉為「運行中／已停止」狀態，你可以喺呢度一鍵 **啟動** 或者 **停止** 本地 OpenClaw Gateway。

### 配置 Provider 同模型

喺 OpenClaw 配置面板入面：

1. 揀要分配俾 OpenClaw 使用嘅 **Provider 服務商**（必須係已喺 `設定 → 模型服務` 入面配置完成嘅平台）。
2. 揀具體嘅 **模型**。
3. 撳 **啟動** 按鈕，OpenClaw Gateway 就會喺本地監聽端口並開始提供服務。

### 喺 OpenClaw CLI 入面使用

一鍵啟動之後，喺你嘅終端入面直接執行 `openclaw` 就可以調用你喺 Cherry Studio 託管啟動嘅算力同模型。

* 詳細 CLI 使用手冊請睇官方文件：<https://docs.openclaw.ai/>
* 亦可以直接撳 OpenClaw 控制面板左下角嘅 **文件** 直達。

### 同 [智能體](/docs/zhong-wen-fan-ti/cherry-studio/preview/agent.md) 嘅根本定位分別

兩者唔係簡單嘅「命令列同圖形介面」劃分，佢哋喺 Cherry Studio 入面嘅定位完全唔同：

| 維度       | Cherry Agent（內置智能體）                                                           | OpenClaw                                    |
| -------- | ----------------------------------------------------------------------------- | ------------------------------------------- |
| **運行位置** | 客戶端（Cherry Studio）原生內部運行                                                      | 獨立嘅外部進程 Gateway                             |
| **產品定位** | 同客戶端 UI 原生深度綁定嘅工具同流程型智能體                                                      | 為想試新嘅用戶 **大幅降低 OpenClaw 項目嘅底層依賴、代理同環境配置成本** |
| **互動介面** | Cherry Studio 圖形對話視窗                                                          | 終端 CLI 互動或者其他支援 OpenClaw 介面嘅客戶端             |
| **運行依賴** | 必須依賴客戶端入面嘅 [**API 伺服器**](/docs/zhong-wen-fan-ti/advanced-basic/api-server.md) | 獨立 Gateway，由 Cherry Studio 提供一鍵環境託管         |

### 提示同技巧

* OpenClaw 同內置嘅 Cherry Agent 可以喺系統入面並行使用，互不衝突。
* 喺一台機器上，OpenClaw Gateway 啟動之後會佔用佢指定嘅本地端口（具體見 OpenClaw 文件說明），同 Cherry Studio 內置 [**API 伺服器**](/docs/zhong-wen-fan-ti/advanced-basic/api-server.md) 預設監聽嘅 `23333` 端口完全獨立、互不干擾。
* 當關閉 Cherry Studio 軟件時，被託管啟動嘅 OpenClaw Gateway 服務會自動停止；如果需要喺後台長期常駐運行，建議使用 OpenClaw 官方自帶嘅守護進程（Daemon）模式。

***

### 💡 獲取幫助同提交反饋

如果您喺配置或使用過程中遇到任何疑問、Bug 或有功能改進建議，請參考 [反饋同建議](/docs/zhong-wen-fan-ti/question-contact/suggestions.md) 入面提供嘅官方渠道，或者前往 [OpenClaw 官方倉庫](https://github.com/openclaw) 參與開源討論。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cherry-ai.com/docs/zhong-wen-fan-ti/advanced-basic/openclaw.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
