> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/docs/en-us/advanced-basic/openclaw.md). # OpenClaw **OpenClaw is an independent open-source AI agent tool**and provides highly customizable Agent runtime and interaction services, developed by an independent open-source team. For ordinary users who want to experience OpenClaw's powerful capabilities, Cherry Studio provides **a one-click integration interface**. You don't need to tinker with complex low-level commands, runtime dependencies, and proxies yourself; you can directly reuse the preconfigured model service (Provider) inside Cherry Studio to start the OpenClaw hosted service with one click. {% hint style="info" %} **Do I need OpenClaw?** * **General users**: If you only use agents daily in the Cherry Studio client GUI, just refer to [**agents**](/docs/en-us/cherry-studio/preview/agent.md) that's all,**does not require** to enable OpenClaw. * **Try it out / power users**: If you want to experience the OpenClaw project in a terminal or standalone workflow, you can use this module to quickly start the Gateway service. {% endhint %} ### Install OpenClaw Click `+` ➡️ **Launcher** ➡️ Click **OpenClaw** the icon in the top tab bar. When you enter for the first time, you will see:

OpenClaw is not installed

* Click **Install OpenClaw** ➡️ Cherry Studio will automatically download from the official source and install the latest OpenClaw runtime binary package. * After installation, the page will switch to the "Running / Stopped" status, and you can one-click here **Start** or **stop** the local OpenClaw Gateway. ### Configure Provider and model In the OpenClaw configuration panel: 1. Select the **Provider service**(must be a platform already configured in `Settings → Model Services` the platform). 2. Select the specific **Model**. 3. Click **Start** button, and the OpenClaw Gateway will listen on a local port and start serving. ### Use in the OpenClaw CLI After one-click startup, run `openclaw` directly in your terminal to call the compute power and models hosted and started in Cherry Studio. * For a detailed CLI usage guide, please read the official documentation: * You can also directly click the **Documentation** Go directly there. ### and [agents](/docs/en-us/cherry-studio/preview/agent.md) fundamental positioning difference The two are not simply divided into "command line vs. graphical interface"; their positioning in Cherry Studio is completely different: | Dimension | Cherry Agent (built-in agent) | OpenClaw | | ------------------------- | --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Running location** | Runs natively inside the client (Cherry Studio) | Independent external process Gateway | | **Product positioning** | Tools and workflow agents deeply and natively integrated with the client UI | For users who want to try it out **Greatly reduces the underlying dependencies, proxies, and environment configuration costs of the OpenClaw project** | | **Interaction interface** | Cherry Studio graphical chat window | Terminal CLI interaction or other clients that support the OpenClaw API | | **Runtime dependencies** | Must rely on the [**API server**](/docs/en-us/advanced-basic/api-server.md) | independent Gateway, with one-click environment hosting provided by Cherry Studio | ### Tips and tricks * OpenClaw and the built-in Cherry Agent can be used in parallel in the system without interfering with each other. * After OpenClaw Gateway starts on a machine, it will occupy its specific local port (see the OpenClaw documentation for details), and the built-in Cherry Studio [**API server**](/docs/en-us/advanced-basic/api-server.md) default listening `23333` ports are completely separate and do not interfere with each other. * When the Cherry Studio software is closed, the hosted and started OpenClaw Gateway service will stop automatically; if you need it to run persistently in the background for a long time, it is recommended to use OpenClaw's official built-in daemon mode. *** ### 💡 Get help and submit feedback If you encounter any questions, bugs, or have suggestions for feature improvements during configuration or use, please refer to [Feedback and Suggestions](/docs/en-us/question-contact/suggestions.md) the official channel provided in [OpenClaw official repository](https://github.com/openclaw) participate in open-source discussions. --- # 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, and the optional `goal` query parameter: ``` GET https://docs.cherryai.com.cn/docs/en-us/advanced-basic/openclaw.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.