docs: update docs and readme

2026-06-02 00:57:41 +08:00 · 2026-05-24 18:29:57 +08:00
parent 29af855ecd
commit 91d427c8f9
32 changed files with 618 additions and 264 deletions
--- a/README.md
+++ b/README.md
@@ -7,9 +7,9 @@
  [English] | [<a href="docs/zh/README.md">中文</a>] | [<a href="docs/ja/README.md">日本語</a>]
 </p>

-**CowAgent** is an open-source super AI assistant that proactively plans tasks, operates your computer and external services, creates and runs Skills, and grows alongside you with a personal knowledge base and long-term memory — a reference implementation of Agent Harness engineering.
+**CowAgent** is an open-source super AI assistant that proactively plans tasks, controls your computer and external services, creates and runs Skills, and grows alongside you through a personal knowledge base and long-term memory — a reference implementation of Agent Harness engineering.

-CowAgent is lightweight, easy to deploy, and built to extend. Plug in any major LLM provider, run it across Web and major IM platforms, 24/7 on a personal computer or server.
+CowAgent is lightweight, easy to deploy, and built to extend. Plug in any major LLM provider and run it 24/7 on a personal computer or server, across the web and all major IM platforms.

 <p align="center">
  <a href="https://cowagent.ai/">🌐 Website</a> &nbsp;·&nbsp;
@@ -25,15 +25,15 @@ CowAgent is lightweight, easy to deploy, and built to extend. Plug in any major

 | Capability | Description |
 | :--- | :--- |
-| 🤖 [Autonomous Task Planning](https://docs.cowagent.ai/en/intro/architecture) | Decomposes complex tasks and executes them step by step, looping over tools until the goal is reached |
-| 🧠 [Long-term Memory](https://docs.cowagent.ai/en/memory/index) | Three-tier architecture (context → daily → core), automatic Deep Dream distillation, hybrid keyword + vector retrieval |
-| 📚 [Personal Knowledge Base](https://docs.cowagent.ai/en/knowledge/index) | Auto-curates structured knowledge into a Markdown wiki, builds an evolving knowledge graph with visual browsing |
-| 🧩 [Skills System](https://docs.cowagent.ai/en/skills/index) | One-click install from [Skill Hub](https://skills.cowagent.ai/), GitHub, ClawHub; or create custom skills via natural-language conversation |
-| 🔧 [Tool System](https://docs.cowagent.ai/en/tools/index) | Built-in file I/O, terminal, browser, scheduler, memory retrieval, web search, and 10+ more tools — with native MCP integration |
-| 💬 [Multi-channel Integration](https://docs.cowagent.ai/en/channels/index) | A single Agent simultaneously serves Web, WeChat, Feishu, DingTalk, WeCom, QQ, and Official Accounts |
-| 🎨 Multimodal Messaging | First-class support for text, images, voice, and files — recognition, generation, and delivery |
-| ⚙️ [Pluggable Models](https://docs.cowagent.ai/en/models/index) | Claude, GPT, Gemini, DeepSeek, Qwen, GLM, Kimi, MiniMax, Doubao, and more — swap providers from the Web console with one click |
-| 📦 [Batteries Included](https://docs.cowagent.ai/en/guide/quick-start) | One-line installer, unified Web console, multiple deployment modes (local, Docker, server) |
+| 🤖 [Planning](https://docs.cowagent.ai/en/intro/architecture) | Decomposes complex tasks and executes them step by step, looping over tools until the goal is reached |
+| 🧠 [Memory](https://docs.cowagent.ai/en/memory/index) | Three-tier architecture (context → daily → core), automatic Deep Dream distillation, hybrid keyword + vector retrieval |
+| 📚 [Knowledge](https://docs.cowagent.ai/en/knowledge/index) | Auto-curates structured knowledge into a Markdown wiki, builds an evolving knowledge graph with visual browsing |
+| 🧩 [Skills](https://docs.cowagent.ai/en/skills/index) | One-click install from [Skill Hub](https://skills.cowagent.ai/), GitHub, ClawHub; or create custom skills via natural-language conversation |
+| 🔧 [Tools](https://docs.cowagent.ai/en/tools/index) | Built-in file I/O, terminal, browser, scheduler, memory retrieval, web search, and 10+ more tools — with native MCP integration |
+| 💬 [Channels](https://docs.cowagent.ai/en/channels/index) | Integrates with Web, WeChat, Feishu, DingTalk, WeCom, QQ, and Official Accounts |
+| 🎨 Multimodal | First-class support for text, images, voice, and files — recognition, generation, and delivery |
+| ⚙️ [Models](https://docs.cowagent.ai/en/models/index) | Claude, GPT, Gemini, DeepSeek, Qwen, GLM, Kimi, MiniMax, Doubao, and more — swap providers from the Web console with one click |
+| 📦 [Quick Start](https://docs.cowagent.ai/en/guide/quick-start) | One-line installer, unified Web console, multiple deployment modes (local, Docker, server) |

 <br/>

@@ -41,7 +41,7 @@ CowAgent is lightweight, easy to deploy, and built to extend. Plug in any major

 <img src="https://cdn.jsdelivr.net/gh/zhayujie/cowagent-assets@main/architecture/en/architecture.jpg" alt="CowAgent Architecture" width="750"/>

-CowAgent is a complete **Agent Harness**: messages flow in through **Channels**; the **Agent Core** plans and decides using memory, knowledge, and the available tools/skills; **Models** generate the response; results are sent back through the originating channel. Every layer is decoupled and independently extensible.
+CowAgent is a complete **Agent Harness**: messages flow in through **Channels**; the **Agent Core** plans and reasons over memory, knowledge, and the available tools and skills; **Models** generate the response, which is sent back through the originating channel. Every layer is decoupled and independently extensible.

 Read more in [Architecture](https://docs.cowagent.ai/en/intro/architecture).

@@ -49,7 +49,7 @@ Read more in [Architecture](https://docs.cowagent.ai/en/intro/architecture).

 ## 🚀 Quick Start

-The project ships with a one-line installer that handles dependencies, configuration, and startup automatically:
+A one-line installer takes care of dependencies, configuration, and startup:

 **Linux / macOS:**

@@ -70,11 +70,11 @@ curl -O https://cdn.link-ai.tech/code/cow/docker-compose.yml
 docker compose up -d
 ```

-Once started, open `http://localhost:9899` to access the **Web console** — a single place to configure models, connect channels, and install skills.
+Once started, open `http://localhost:9899` to access the **Web console** — your one-stop hub to chat with the Agent, configure models, connect channels, and install skills.

-> 📖 Detailed guides: [One-line Installer](https://docs.cowagent.ai/en/guide/quick-start) · [Manual Install from Source](https://docs.cowagent.ai/en/guide/manual-install) · [Upgrade](https://docs.cowagent.ai/en/guide/upgrade)
+> 📖 Detailed guides: [Quick Start](https://docs.cowagent.ai/en/guide/quick-start) · [Install from Source](https://docs.cowagent.ai/en/guide/manual-install) · [Upgrade](https://docs.cowagent.ai/en/guide/upgrade)

-After installation, manage the service with the [`cow` CLI](https://docs.cowagent.ai/en/cli/index):
+After installation, manage the service with the [cow CLI](https://docs.cowagent.ai/en/cli/index):

 ```bash
 cow start | stop | restart        # service control
@@ -88,7 +88,7 @@ cow install-browser                # install browser automation

 ## 🤖 Models

-CowAgent supports all mainstream LLM providers. **Chat, vision, image generation, ASR/TTS, and embeddings** can each be configured against a different vendor.
+CowAgent supports all mainstream LLM providers. **Chat, vision, image generation, ASR/TTS, and embeddings** can each be routed to a different vendor.

 | Provider | Featured Models | Chat | Vision | Image Gen | ASR | TTS | Embedding |
 | --- | --- | :-: | :-: | :-: | :-: | :-: | :-: |
@@ -101,7 +101,7 @@ CowAgent supports all mainstream LLM providers. **Chat, vision, image generation
 | [Doubao](https://docs.cowagent.ai/en/models/doubao) | doubao-seed-2.0 series | ✅ | ✅ | ✅ | | | ✅ |
 | [Kimi](https://docs.cowagent.ai/en/models/kimi) | kimi-k2.6 | ✅ | ✅ | | | | |
 | [MiniMax](https://docs.cowagent.ai/en/models/minimax) | MiniMax-M2.7 | ✅ | ✅ | ✅ | | ✅ | |
-| [Qianfan](https://docs.cowagent.ai/en/models/qianfan) | ernie-5.1 | ✅ | ✅ | | | | |
+| [ERNIE](https://docs.cowagent.ai/en/models/qianfan) | ernie-5.1 | ✅ | ✅ | | | | |
 | [LinkAI](https://docs.cowagent.ai/en/models/linkai) | 100+ models, unified gateway | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
 | [Custom](https://docs.cowagent.ai/en/models/custom) | Local models / third-party proxy | ✅ | | | | | |

@@ -111,7 +111,7 @@ CowAgent supports all mainstream LLM providers. **Chat, vision, image generation

 ## 💬 Channels

-A single Agent instance can serve multiple channels at once. Switch with the `channel_type` config or run several channels in parallel.
+A single Agent instance can serve multiple channels at once — set `channel_type` to switch between them, or run several channels in parallel.

 | Channel | Text | Image | File | Voice | Group |
 | --- | :-: | :-: | :-: | :-: | :-: |
@@ -159,7 +159,7 @@ A single Agent instance can serve multiple channels at once. Switch with the `ch

 ### Tool System

-**Built-in tools** cover file I/O (`read` / `write` / `edit` / `ls`), terminal (`bash`), file delivery (`send`), memory retrieval (`memory`), environment variables (`env_config`), web fetching (`web_fetch`), scheduling (`scheduler`), web search (`web_search`), vision (`vision`), and browser automation (`browser`).
+**Built-in tools** cover file I/O (`read` / `write` / `edit` / `ls`), terminal (`bash`), file sending (`send`), memory retrieval (`memory`), environment variables (`env_config`), web fetching (`web_fetch`), scheduling (`scheduler`), web search (`web_search`), vision (`vision`), and browser automation (`browser`).

 **MCP protocol** integrates the open ecosystem of [Model Context Protocol](https://modelcontextprotocol.io) servers. A single `mcp.json` is enough — supports stdio / SSE transports, hot reload, and zero-code integration.

@@ -217,6 +217,18 @@ Scan the WeChat QR code to join the open-source community group:

 <br/>

+## 🏢 Enterprise Services
+
+[**LinkAI**](https://link-ai.tech/) is an all-in-one AI Agent platform for enterprises and developers, offering managed hosting and enterprise-grade support for CowAgent:
+
+- **🚀 Zero-deployment hosted runtime** — spin up a [CowAgent online assistant](https://link-ai.tech/cowagent/create) in under a minute, no server required
+- **🧠 Aggregated models & skill marketplace** — unified access to mainstream LLMs and an official skill marketplace, extending CowAgent's reach
+- **🏢 Team & enterprise features** — workspaces, role-based access, audit logs, and private deployment for production use cases
+
+For enterprise inquiries: sales@simple-future.tech or [scan the QR code](https://cdn.link-ai.tech/consultant.jpg) to reach our team on WeChat.
+
+<br/>
+
 ## 🛠️ Development & Contributing

 Contributions are welcome — add a new channel by following the [Feishu channel reference](https://github.com/zhayujie/CowAgent/blob/master/channel/feishu/feishu_channel.py), or contribute new skills to [Skill Hub](https://skills.cowagent.ai/submit).
@@ -229,22 +241,10 @@ Contributions are welcome — add a new channel by following the [Feishu channel

 <br/>

-## 🏢 Enterprise Services
-
-[**LinkAI**](https://link-ai.tech/) is a one-stop AI Agent platform for enterprises and developers, offering managed hosting and enterprise-grade support for CowAgent:
-
- **🚀 Zero-deployment hosted runtime** — spin up a [CowAgent online assistant](https://link-ai.tech/cowagent/create) in under a minute, no server required
- **🧠 Aggregated models & skill marketplace** — unified access to mainstream LLMs and an official skill marketplace, extending CowAgent's reach
- **🏢 Team & enterprise features** — workspaces, role-based access, audit logs, and private deployment for production use cases
-
-For enterprise inquiries: sales@simple-future.tech or [scan the QR code](https://cdn.link-ai.tech/consultant.jpg) to reach our team on WeChat.
-
-<br/>
-
 ## ⚠️ Disclaimer

 1. This project is licensed under the [MIT License](/LICENSE) and is intended for technical research and learning. You are responsible for complying with applicable laws and regulations in your jurisdiction; the maintainers assume no liability for any consequences arising from use of this project.
-2. **Cost & safety:** Agent mode consumes substantially more tokens than plain chat — pick models that balance quality and cost. The Agent has access to your local operating system; deploy only in trusted environments.
+2. **Cost & safety:** Agent mode consumes substantially more tokens than regular chat — pick models that balance quality and cost. The Agent has access to your local operating system, so only deploy it in trusted environments.
 3. CowAgent is a pure open-source project and does not participate in, authorize, or issue any cryptocurrency.

 <br/>
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -255,7 +255,8 @@
                "group": "Installation",
                "pages": [
                  "en/guide/quick-start",
-                  "en/guide/manual-install"
+                  "en/guide/manual-install",
+                  "en/guide/upgrade"
                ]
              }
            ]
@@ -332,6 +333,7 @@
                "pages": [
                  "en/skills/index",
                  "en/skills/install",
+                  "en/skills/create",
                  "en/skills/hub"
                ]
              },
@@ -398,7 +400,7 @@
                  "en/cli/process",
                  "en/cli/skill",
                  "en/cli/memory-knowledge",
-                  "en/cli/chat"
+                  "en/cli/general"
                ]
              }
            ]
--- a/docs/en/channels/feishu.mdx
+++ b/docs/en/channels/feishu.mdx
@@ -15,8 +15,11 @@ description: Integrate CowAgent into Feishu via a custom enterprise app

 No need to manually create an app on the Feishu Developer Platform. Start the Cow project, open the web console (default `http://127.0.0.1:9899/`), go to **Channels**, click **Add Channel**, choose **Feishu**, then under the **Scan QR** tab click **One-click Create Feishu App** and scan with the **Feishu App** to complete app creation and connection automatically.

+<img src="https://cdn.link-ai.tech/doc/20260505181126.png" width="800"/>
+
 <Note>
-  The created app comes with all required permissions (messaging, card read/write, group events, etc.) and event subscriptions pre-configured. Currently only the Feishu mainland version is supported (Lark international not yet supported).
+  1. Requires `lark-oapi` ≥ 1.5.5.
+  2. The created app comes with all required permissions (messaging, card read/write, group events, etc.) and event subscriptions pre-configured — no manual setup on the developer console needed. Currently only the Feishu mainland version is supported (Lark international not yet supported).
 </Note>

 When starting from CLI without `feishu_app_id` configured, the QR code is also printed to the terminal.
--- a/docs/en/channels/index.mdx
+++ b/docs/en/channels/index.mdx
@@ -11,29 +11,29 @@ The table below summarizes the inbound message types, bot reply types, and group

 | Channel | Text | Image | File | Voice | Group Chat |
 | --- | :-: | :-: | :-: | :-: | :-: |
-| [WeChat](/channels/weixin) | ✅ | ✅ | ✅ | ✅ |  |
-| [Web Console](/channels/web) | ✅ | ✅ | ✅ | ✅ | |
-| [Feishu](/channels/feishu) | ✅ | ✅ | ✅ | ✅ | ✅ |
-| [DingTalk](/channels/dingtalk) | ✅ | ✅ | ✅ | ✅ | ✅ |
-| [WeCom Smart Bot](/channels/wecom-bot) | ✅ | ✅ | ✅ | ✅ | ✅ |
-| [QQ](/channels/qq) | ✅ | ✅ | ✅ | | ✅ |
-| [WeCom App](/channels/wecom) | ✅ | ✅ | ✅ | ✅ | |
-| [Official Account](/channels/wechatmp) | ✅ | ✅ | | ✅ | |
+| [WeChat](/en/channels/weixin) | ✅ | ✅ | ✅ | ✅ |  |
+| [Web Console](/en/channels/web) | ✅ | ✅ | ✅ | ✅ | |
+| [Feishu](/en/channels/feishu) | ✅ | ✅ | ✅ | ✅ | ✅ |
+| [DingTalk](/en/channels/dingtalk) | ✅ | ✅ | ✅ | ✅ | ✅ |
+| [WeCom Bot](/en/channels/wecom-bot) | ✅ | ✅ | ✅ | ✅ | ✅ |
+| [QQ](/en/channels/qq) | ✅ | ✅ | ✅ | | ✅ |
+| [WeCom App](/en/channels/wecom) | ✅ | ✅ | ✅ | ✅ | |
+| [Official Account](/en/channels/wechatmp) | ✅ | ✅ | | ✅ | |

 - The **Image / File / Voice** columns indicate that the channel can send and receive the corresponding message types; see each channel's docs for details
 - The **Group Chat** column indicates the ability to recognize and respond to group messages

 <Tip>
-  The voice / image capabilities of each channel depend on the configuration of the corresponding model provider. See [Models Overview](/models) for details.
+  The voice / image capabilities of each channel depend on the configuration of the corresponding model provider. See [Models Overview](/en/models/index) for details.
 </Tip>

 ## Channel List

- [Web Console](/channels/web) — built-in browser-based chat and management panel, enabled by default
- [WeChat](/channels/weixin) — log in via personal WeChat QR scan
- [Feishu](/channels/feishu) — Feishu custom bot
- [DingTalk](/channels/dingtalk) — DingTalk custom bot
- [WeCom Smart Bot](/channels/wecom-bot) — WeCom smart robot
- [QQ](/channels/qq) — QQ official bot open platform
- [WeCom App](/channels/wecom) — WeCom custom app integration
- [Official Account](/channels/wechatmp) — WeChat Official Account (subscription / service account)
+- [Web Console](/en/channels/web) — built-in browser-based chat and management panel, enabled by default
+- [WeChat](/en/channels/weixin) — log in via personal WeChat QR scan
+- [Feishu](/en/channels/feishu) — Feishu custom bot
+- [DingTalk](/en/channels/dingtalk) — DingTalk custom bot
+- [WeCom Bot](/en/channels/wecom-bot) — WeCom AI Bot via WebSocket long connection
+- [QQ](/en/channels/qq) — QQ Official Bot open platform
+- [WeCom App](/en/channels/wecom) — WeCom custom app integration
+- [Official Account](/en/channels/wechatmp) — WeChat Official Account (subscription / service)
--- a/docs/en/channels/wecom-bot.mdx
+++ b/docs/en/channels/wecom-bot.mdx
@@ -3,39 +3,54 @@ title: WeCom Bot
 description: Connect CowAgent to WeCom AI Bot (WebSocket long connection)
 ---

-Connect CowAgent via WeCom AI Bot, supporting both direct messages and group chats. No public IP required — uses WebSocket long connection with Markdown rendering and streaming output.
+> Connect CowAgent via WeCom AI Bot, supporting both internal direct messages and group chats. No public IP required — uses a WebSocket long connection, with Markdown rendering and streaming output.

 <Note>
-  WeCom Bot and WeCom App are two different integration methods. WeCom Bot uses WebSocket long connection, requiring no public IP or domain, making it easier to set up.
+  WeCom Bot and WeCom App are two different integration methods. WeCom Bot uses a WebSocket long connection and requires no public IP or domain, making setup much simpler.
 </Note>

-## 1. Create an AI Bot
+## 1. Connection methods
+
+### Option A: One-click QR scan (recommended)
+
+No need to create the bot ahead of time. Start CowAgent and open the Web console (local URL: http://127.0.0.1:9899/), go to the **Channels** tab, click **Connect Channel**, choose **WeCom Bot**, switch to **QR scan** mode, and scan the QR code with **WeCom** — bot creation and connection complete automatically.
+
+<img src="https://cdn.link-ai.tech/doc/20260401121213.png" width="800"/>
+
+<Note>
+  After a successful scan, you can further configure the bot (name, avatar, visibility scope, etc.) in **WeCom Workbench → AI Bot**.
+</Note>
+
+### Option B: Manual creation
+
+Create the AI Bot in WeCom and obtain the Bot ID and Secret, then connect via the Web console or config file.
+
+**Step 1: Create the AI Bot**

 1. Open the WeCom client, go to **Workbench**, and click **AI Bot**:

 <img src="https://cdn.link-ai.tech/doc/20260316180959.png" width="800"/>

-2. Click **Create Bot** → **Manual Creation**:
+2. Click **Create Bot → Manual Creation**:

-<img src="https://cdn.link-ai.tech/doc/20260316181118.png" width="600"/>
+<img src="https://cdn.link-ai.tech/doc/20260316181118.png" width="800"/>

 3. Scroll to the bottom of the right panel and select **API Mode**:

-<img src="https://cdn.link-ai.tech/doc/20260316181215.png" width="600"/>
+<img src="https://cdn.link-ai.tech/doc/20260316181215.png" width="800"/>

-4. Set the bot name, avatar, and visibility scope. Select **Long Connection** mode, note down the **Bot ID** and **Secret**, then click Save.
+4. Set the bot name, avatar, and visibility scope. Choose **Long Connection** mode, save the **Bot ID** and **Secret**, then click Save.

-## 2. Configuration
+**Step 2: Connect to CowAgent**

-### Option A: Web Console
+<Tabs>
+  <Tab title="Web Console">
+    Open the Web console, go to the **Channels** tab, click **Connect Channel**, choose **WeCom Bot**, switch to **Manual** mode, enter the Bot ID and Secret, and click Connect.

-Start the program and open the Web console (local access: http://127.0.0.1:9899). Go to the **Channels** tab, click **Connect Channel**, select **WeCom Bot**, fill in the Bot ID and Secret from the previous step, and click Connect.
-
-<img src="https://cdn.link-ai.tech/doc/20260316181711.png" width="600"/>
-
-### Option B: Config File
-
-Add the following to your `config.json`:
+    <img src="https://cdn.link-ai.tech/doc/20260316181711.png" width="800"/>
+  </Tab>
+  <Tab title="Config File">
+    Add the following to `config.json`, then start CowAgent:

    ```json
    {
@@ -48,26 +63,28 @@ Add the following to your `config.json`:
    | Parameter | Description |
    | --- | --- |
    | `wecom_bot_id` | Bot ID of the AI Bot |
-| `wecom_bot_secret` | Secret for the AI Bot |
+    | `wecom_bot_secret` | Secret of the AI Bot |
+  </Tab>
+</Tabs>

-After configuration, start the program. The log message `[WecomBot] Subscribe success` indicates a successful connection.
+The log line `[WecomBot] Subscribe success` confirms the connection is established.

-## 3. Supported Features
+## 2. Supported features

 | Feature | Status |
 | --- | --- |
-| Direct Messages | ✅ |
-| Group Chat (@bot) | ✅ |
-| Text Messages | ✅ Send & Receive |
-| Image Messages | ✅ Send & Receive |
-| File Messages | ✅ Send & Receive |
-| Streaming Reply | ✅ |
-| Scheduled Push | ✅ |
+| Direct chat | ✅ |
+| Group chat (@bot) | ✅ |
+| Text messages | ✅ Send / Receive |
+| Image messages | ✅ Send / Receive |
+| File messages | ✅ Send / Receive |
+| Streaming replies | ✅ |
+| Scheduled push messages | ✅ |

-## 4. Usage
+## 3. Usage

-Search for the bot name in WeCom to start a direct conversation.
+Search for the bot's name inside WeCom to start a direct chat.

-To use in group chats, add the bot to a group and @mention it to send messages.
+To use the bot in an internal group chat, add it to the group and @-mention it.

 <img src="https://cdn.link-ai.tech/doc/20260316182902.png" width="800"/>
--- a/docs/en/channels/weixin.mdx
+++ b/docs/en/channels/weixin.mdx
@@ -1,19 +1,21 @@
 ---
 title: WeChat
-description: Connect CowAgent to personal WeChat
+description: Connect CowAgent to personal WeChat (via the official API)
 ---

-> Connect CowAgent to your personal WeChat. Simply scan a QR code to log in — no public IP required. Supports text, image, voice, file, and video messages.
+> Connect CowAgent to your personal WeChat — scan to log in, no public IP required. Supports text, image, voice, file, and video messages in 1-on-1 chats. Backed by WeChat's official API; safe to use. After connecting, a bot assistant is added to your conversation list without affecting normal account usage.

-## 1. Configuration
+## 1. Setup and run

-### Option A: Web Console
+### Option A: Web console

-Start the program and open the Web console (local access: http://127.0.0.1:9899). Go to the **Channels** tab, click **Connect Channel**, select **WeChat**, and follow the prompts to scan the QR code.
+Start CowAgent and open the Web console (local URL: http://127.0.0.1:9899/). Go to the **Channels** tab, click **Connect Channel**, select **WeChat**, and follow the prompts to scan in.

-### Option B: Config File
+<img src="https://cdn.link-ai.tech/doc/20260322195114.png" width="800" />

-Set `channel_type` to `weixin` in your `config.json`:
+### Option B: Config file
+
+Set `channel_type` to `weixin` in `config.json`:

 ```json
 {
@@ -21,52 +23,49 @@ Set `channel_type` to `weixin` in your `config.json`:
 }
 ```

-After starting the program, a QR code will be displayed in the terminal. Scan it with WeChat and confirm on your phone to complete login.
+After starting CowAgent, a QR code is displayed in the terminal. Scan it with WeChat to complete login.
+
+<img src="https://cdn.link-ai.tech/doc/20260322195509.png" width="800" />

 <Note>
-  For backward compatibility, setting `channel_type` to `wx` also activates the WeChat channel.
+  1. For backward compatibility, setting `channel_type` to `wx` also activates the WeChat channel.
+  2. The WeChat client must be on version **8.0.69** or higher.
 </Note>

-## 2. Parameters
+## 2. Usage

-| Parameter | Description | Default |
-| --- | --- | --- |
-| `channel_type` | Set to `weixin` or `wx` | — |
+Once authorized, the integration completes and you can start chatting. A bot assistant is created in your WeChat conversation list, leaving normal account usage unaffected.

-Login credentials are automatically saved to `~/.weixin_cow_credentials.json`. To force a re-login, delete this file and restart.
+> You can find the bot at any time by searching for **"微信ClawBot"**. You may also rename it, change its avatar, pin it to the top of your conversation list, and so on.
+
+<img src="https://cdn.link-ai.tech/doc/83ae8251d896219fde4803f4205205be.jpg" width="250" />

 ## 3. Login

-### QR Code Login
+### QR code login

-On first startup, a QR code is displayed in the terminal (valid for approximately 2 minutes). Scan it with WeChat and confirm on your phone.
+On first startup, a QR code appears in the terminal (valid for around 2 minutes). Scan it with WeChat and confirm on your phone to log in.

- The QR code automatically refreshes when it expires
- The `qrcode` dependency is already included in `requirements.txt`, enabling QR code rendering directly in the terminal
+- The QR code refreshes automatically when it expires
+- The `qrcode` dependency is already included in `requirements.txt`, so the QR code renders directly in the terminal after install

-### Credential Persistence
+### Credential persistence

-After successful login, credentials are saved to `~/.weixin_cow_credentials.json`. Subsequent startups will reuse the saved credentials without requiring a new scan.
+After a successful login, credentials are saved to `~/.weixin_cow_credentials.json`. Subsequent startups reuse the saved credentials with no need to re-scan.

-To force a re-login, delete the credentials file and restart the program.
+To force a re-login, delete the credentials file and restart.

-### Session Expiry
+### Session expiry

-When the WeChat session expires (errcode -14), the program automatically clears old credentials and initiates a new QR login — no manual intervention required.
+When the WeChat session expires (errcode `-14`), CowAgent automatically clears old credentials and initiates a new QR login — no manual intervention required.

-## 4. Supported Features
+## 4. Supported features

 | Feature | Status |
 | --- | --- |
-| Direct Messages | ✅ |
-| Text Messages | ✅ Send & Receive |
-| Image Messages | ✅ Send & Receive |
-| File Messages | ✅ Send & Receive |
-| Video Messages | ✅ Send & Receive |
-| Voice Messages | ✅ Receive |
-
-## 5. Notes
-
-1. Ensure network access to `ilinkai.weixin.qq.com`.
-2. Media files (images, files, videos) are transferred via CDN with AES-128-ECB encryption, handled automatically by the program.
-3. A stable network connection is recommended to avoid frequent disconnections that would require re-scanning.
+| Direct messages | ✅ |
+| Text messages | ✅ Send & Receive |
+| Image messages | ✅ Send & Receive |
+| File messages | ✅ Send & Receive |
+| Video messages | ✅ Send & Receive |
+| Voice messages | ✅ Receive (built-in speech recognition) |
--- a/docs/en/cli/skill.mdx
+++ b/docs/en/cli/skill.mdx
@@ -19,6 +19,24 @@ cow skill list
 ```
 </CodeGroup>

+Example output:
+
+```
+📦 Installed skills (3/4)
+
+✅ pptx
+   Use this skill any time a .pptx file is involved…
+   Source: cowhub
+
+✅ skill-creator
+   Create, install, or update skills…
+   Source: builtin
+
+⏸️ image-vision (disabled)
+   Image understanding and visual analysis
+   Source: builtin
+```
+
 **Browse the Skill Hub** (view all available skills):

 <CodeGroup>
--- a/docs/en/guide/upgrade.mdx
+++ b/docs/en/guide/upgrade.mdx
@@ -0,0 +1,61 @@
+---
+title: Upgrade
+description: How to upgrade CowAgent
+---
+
+## Recommended: One-line upgrade
+
+Use `cow update` to pull the latest code and restart the service in one step:
+
+```bash
+cow update
+```
+
+The command runs the following automatically:
+
+1. Pull the latest code (`git pull`)
+2. Stop the running service
+3. Update Python dependencies
+4. Reinstall the CLI
+5. Start the service
+
+<Note>
+  If the Cow CLI is not installed, `./run.sh update` performs the same operations.
+</Note>
+
+## Manual upgrade
+
+Run the following inside the project root:
+
+```bash
+git pull
+pip3 install -r requirements.txt
+pip3 install -e .
+```
+
+Then restart the service:
+
+```bash
+# Using Cow CLI (recommended)
+cow restart
+
+# Or using run.sh
+./run.sh restart
+
+# Or restart manually with nohup
+kill $(ps -ef | grep app.py | grep -v grep | awk '{print $2}')
+nohup python3 app.py & tail -f nohup.out
+```
+
+## Docker upgrade
+
+Run the following in the directory containing `docker-compose.yml`:
+
+```bash
+sudo docker compose pull
+sudo docker compose up -d
+```
+
+<Tip>
+  Back up `config.json` before upgrading. For Docker deployments, mount the workspace directory as a volume to persist data across upgrades.
+</Tip>
--- a/docs/en/intro/architecture.mdx
+++ b/docs/en/intro/architecture.mdx
@@ -39,8 +39,8 @@ The Agent workspace is located at `~/cow` by default and stores system prompts,

 ```
 ~/cow/
-├── system.md          # Agent system prompt
-├── user.md            # User profile
+├── SYSTEM.md          # Agent system prompt
+├── USER.md            # User profile
 ├── MEMORY.md          # Core memory
 ├── memory/            # Long-term memory storage
 │   └── YYYY-MM-DD.md  # Daily memory
@@ -67,9 +67,10 @@ Configure Agent mode parameters in `config.json`:
 {
  "agent": true,
  "agent_workspace": "~/cow",
-  "agent_max_context_tokens": 40000,
-  "agent_max_context_turns": 30,
-  "agent_max_steps": 15
+  "agent_max_context_tokens": 50000,
+  "agent_max_context_turns": 20,
+  "agent_max_steps": 20,
+  "enable_thinking": false
 }
 ```

@@ -77,7 +78,9 @@ Configure Agent mode parameters in `config.json`:
 | --- | --- | --- |
 | `agent` | Enable Agent mode | `true` |
 | `agent_workspace` | Workspace path | `~/cow` |
-| `agent_max_context_tokens` | Max context tokens | `40000` |
-| `agent_max_context_turns` | Max context turns | `30` |
-| `agent_max_steps` | Max decision steps per task | `15` |
+| `agent_max_context_tokens` | Max context tokens | `50000` |
+| `agent_max_context_turns` | Max context turns | `20` |
+| `agent_max_steps` | Max decision steps per task | `20` |
+| `enable_thinking` | Enable deep-thinking mode | `false` |
+| `knowledge` | Enable personal knowledge base | `true` |
 | `knowledge` | Enable personal knowledge base | `true` |
--- a/docs/en/intro/index.mdx
+++ b/docs/en/intro/index.mdx
@@ -1,53 +1,60 @@
 ---
 title: Introduction
-description: CowAgent - AI Super Assistant powered by LLMs
+description: CowAgent - Open-source super AI assistant and Agent Harness
 ---

-<img src="https://cdn.link-ai.tech/doc/78c5dd674e2c828642ecc0406669fed7.png" alt="CowAgent" width="600px"/>
+<div align="center">
+  <img src="https://cdn.link-ai.tech/doc/78c5dd674e2c828642ecc0406669fed7.png" alt="CowAgent" width="450px"/>
+</div>

-**CowAgent** is an AI super assistant powered by LLMs with autonomous task planning, long-term memory, skills system, multimodal messages, multiple model support, and multi-platform deployment.
+**CowAgent** is an open-source super AI assistant and Agent Harness. It proactively plans tasks, runs tools and skills, and autonomously grows with memory and knowledge.

-CowAgent can proactively think and plan tasks, operate computers and external resources, create and execute Skills, and continuously grow with long-term memory. It supports flexible switching between multiple models, handles text, voice, images, files and other multimodal messages, and can be integrated into WeChat, web, Feishu, DingTalk, WeCom, and WeChat Official Account. It runs 7x24 hours on your personal computer or server.
+CowAgent is lightweight, easy to deploy, and built to extend. Plug in any major LLM provider, run it across Web and major IM platforms, 24/7 on a personal computer or server.

+<CardGroup cols={2}>
  <Card title="GitHub" icon="github" href="https://github.com/zhayujie/CowAgent">
-  github.com/zhayujie/CowAgent
+    Open-source repository — Star and contribute
  </Card>
+  <Card title="Try Online" icon="cloud" href="https://link-ai.tech/cowagent/create">
+    No setup required — experience CowAgent instantly
+  </Card>
+</CardGroup>

 ## Core Capabilities

 <CardGroup cols={2}>
  <Card title="Autonomous Task Planning" icon="brain" href="/en/intro/architecture">
-    Understands complex tasks and autonomously plans execution, continuously thinking and invoking tools until goals are achieved. Supports accessing file systems, terminals, browsers, schedulers, and other system resources through tools.
+    Decomposes complex tasks and executes them step by step, looping over tools and skills until the goal is reached.
  </Card>
-  <Card title="Long-term Memory" icon="database" href="/en/memory">
-    Three-tier memory flow (context → daily memory → global memory) with daily Deep Dream distillation, keyword and vector retrieval support.
+  <Card title="Long-term Memory" icon="database" href="/en/memory/index">
+    Three-tier architecture (context → daily → core), automatic Deep Dream distillation, hybrid keyword + vector retrieval.
  </Card>
-  <Card title="Knowledge Base" icon="book" href="/en/knowledge">
-    Automatically organizes structured knowledge with knowledge graph visualization, building a continuously growing knowledge network through cross-references.
+  <Card title="Personal Knowledge Base" icon="book" href="/en/knowledge/index">
+    Auto-curates structured knowledge into a Markdown wiki, builds an evolving knowledge graph with visual browsing.
  </Card>
  <Card title="Skills System" icon="puzzle-piece" href="/en/skills/index">
-    Implements a Skills creation and execution engine with built-in skills, and supports custom Skills development through natural language conversation.
+    A complete skill creation and execution engine. Install from Skill Hub or generate custom skills via natural-language conversation.
  </Card>
-  <Card title="Multimodal Messages" icon="image" href="/en/channels/web">
-    Supports parsing, processing, generating, and sending text, images, voice, files, and other message types.
+  <Card title="Multimodal Messaging" icon="image" href="/en/channels/web">
+    First-class support for text, images, voice, and files — recognition, generation, and delivery.
  </Card>
  <Card title="Tool System" icon="wrench" href="/en/tools/index">
-    Built-in tools for file I/O, terminal execution, browser automation, scheduled tasks, messaging, and more. The Agent autonomously invokes tools to accomplish complex tasks.
+    Built-in file I/O, terminal, browser, scheduler, memory retrieval, web search, and more — with native MCP integration.
  </Card>
  <Card title="Command System" icon="terminal" href="/en/cli/index">
-    Provides terminal CLI and in-chat commands for process management, skill installation, configuration, context inspection, and other common operations.
+    Terminal CLI and in-chat commands for process management, skill installation, configuration, and context inspection.
  </Card>
-  <Card title="Multiple Model Support" icon="microchip" href="/en/models/index">
-    Supports mainstream model providers including OpenAI, Claude, Gemini, DeepSeek, MiniMax, GLM, Qwen, Kimi, Doubao, and more.
+  <Card title="Pluggable Models" icon="microchip" href="/en/models/index">
+    Claude, GPT, Gemini, DeepSeek, Qwen, GLM, Kimi, MiniMax, Doubao, and more — swap providers from the Web console with one click.
  </Card>
-  <Card title="Multi-platform Deployment" icon="server" href="/en/channels/weixin">
-    Runs on local computers or servers, integrable into WeChat, web, Feishu, DingTalk, WeChat Official Account, and WeCom applications.
+  <Card title="Multi-channel Integration" icon="server" href="/en/channels/index">
+    A single Agent simultaneously serves Web, WeChat, Feishu, DingTalk, WeCom, QQ, and Official Accounts.
  </Card>
 </CardGroup>

-## Quick Experience
+## Quick Start

-Run the following command in your terminal for one-click install, configuration, and startup:
+Run one of the commands below to install, configure, and start CowAgent in a single step:

 <Tabs>
  <Tab title="Linux / macOS">
@@ -62,25 +69,25 @@ Run the following command in your terminal for one-click install, configuration,
  </Tab>
 </Tabs>

-By default, the Web service starts after running. Access `http://localhost:9899/chat` to chat in the web interface.
+Once started, open `http://localhost:9899` to access the **Web console** — the unified place to chat, configure providers, connect channels, and install skills.

 <CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/en/guide/quick-start">
    Complete installation and run guide
  </Card>
  <Card title="Architecture" icon="sitemap" href="/en/intro/architecture">
-    CowAgent system architecture design
+    CowAgent system architecture
  </Card>
 </CardGroup>

 ## Disclaimer

-1. This project follows the [MIT License](https://github.com/zhayujie/CowAgent/blob/master/LICENSE) and is intended for technical research and learning. Users must comply with local laws, regulations, policies, and corporate bylaws. Any illegal or rights-infringing use is prohibited.
-2. Agent mode consumes more tokens than normal chat mode. Choose models based on effectiveness and cost. Agent has access to the host operating system — deploy with caution.
-3. CowAgent focuses on open-source development and does not participate in, authorize, or issue any cryptocurrency.
+1. This project is licensed under the [MIT License](https://github.com/zhayujie/CowAgent/blob/master/LICENSE) and is intended for technical research and learning. You are responsible for complying with applicable laws and regulations in your jurisdiction; the maintainers assume no liability for any consequences arising from use of this project.
+2. **Cost & safety:** Agent mode consumes substantially more tokens than plain chat — pick models that balance quality and cost. The Agent has access to your local operating system; deploy only in trusted environments.
+3. CowAgent is a pure open-source project and does not participate in, authorize, or issue any cryptocurrency.

 ## Community

-Add our assistant on WeChat to join the open-source community:
+Scan the WeChat QR code to join the open-source community group:

 <img width="140" src="https://img-1317903499.cos.ap-guangzhou.myqcloud.com/docs/open-community.png" />
--- a/docs/en/knowledge/index.mdx
+++ b/docs/en/knowledge/index.mdx
@@ -5,6 +5,10 @@ description: CowAgent personal knowledge base — structured knowledge accumulat

 The personal knowledge base is the Agent's long-term structured knowledge store, saved in the `knowledge/` directory within the workspace. Unlike memory, which is organized by timeline, the knowledge base organizes content by topic — articles, conversation insights, and learning materials are structured into interlinked Markdown pages, forming a continuously growing knowledge network.

+<Frame>
+  <img src="https://cdn.link-ai.tech/doc/20260413105435.png" width="800" />
+</Frame>
+
 ## Core Concepts

 ### Knowledge vs Memory
@@ -43,7 +47,7 @@ Knowledge writing is an autonomous Agent behavior, triggered in these scenarios:
 Each knowledge page includes cross-reference links to related pages, gradually building a knowledge graph.

 <Frame>
-  <img src="https://gist.github.com/user-attachments/assets/3ce92f78-1863-4820-8fa8-660c0f2b7f09" alt="Conversational knowledge ingest" />
+  <img src="https://cdn.link-ai.tech/doc/20260413110104.png" width="800" />
 </Frame>

 ## Knowledge Retrieval
@@ -63,11 +67,11 @@ The web console provides a dedicated "Knowledge" module with:
 - **Chat integration** — Knowledge document links referenced in Agent replies are clickable for direct navigation

 <Frame>
-  <img src="https://gist.github.com/user-attachments/assets/b7b9d6be-0ac1-4c65-803b-2c6b36bd59a7" alt="Knowledge document browsing" />
+  <img src="https://cdn.link-ai.tech/doc/17aad553d3e9e428c52ff9dc31726fda.png" width="800" />
 </Frame>

 <Frame>
-  <img src="https://gist.github.com/user-attachments/assets/44ae68ca-96cc-40b9-ab33-cdbec34c2379" alt="Knowledge graph visualization" />
+  <img src="https://cdn.link-ai.tech/doc/20260413105402.png" width="800" />
 </Frame>

 ## CLI Commands
--- a/docs/en/models/coding-plan.mdx
+++ b/docs/en/models/coding-plan.mdx
@@ -77,7 +77,7 @@ Reference: [China Key](https://platform.minimaxi.com/docs/coding-plan/quickstart

 ---

-## Zhipu GLM
+## GLM

 ```json
 {
--- a/docs/en/models/glm.mdx
+++ b/docs/en/models/glm.mdx
@@ -1,5 +1,5 @@
 ---
-title: Zhipu GLM
+title: GLM
 description: Zhipu AI GLM model configuration (Text / Image Understanding / Speech-to-Text / Embedding)
 ---

--- a/docs/en/models/index.mdx
+++ b/docs/en/models/index.mdx
@@ -3,43 +3,35 @@ title: Models Overview
 description: Model vendors supported by CowAgent and their capability matrix
 ---

-CowAgent supports mainstream large language models from both Chinese and overseas vendors. Model interfaces are implemented under the project's `models/` directory. In addition to text chat, some vendors also provide vision understanding, image generation, speech-to-text, text-to-speech, and embedding capabilities, which can be invoked on demand in the Agent flow.
-
-<Note>
-  The following models are recommended in Agent mode; choose based on quality and cost: deepseek-v4-flash, MiniMax-M2.7, claude-sonnet-4-6, gemini-3.5-flash, glm-5.1, qwen3.6-plus, kimi-k2.6, ernie-5.1.
-
-  [LinkAI](https://link-ai.tech) is also supported, letting you switch between multiple vendors with a single key while gaining knowledge bases, workflows, and plugins.
-</Note>
-
+CowAgent supports a wide range of mainstream large language models. Model interfaces live under the project's `models/` directory. Beyond text chat, several vendors also provide vision understanding, image generation, speech-to-text, text-to-speech, and embeddings — all of which can be invoked on demand in the Agent flow.

 ## Capability Matrix

-A snapshot of each vendor's capabilities. "Text" refers to the main chat model; the remaining columns indicate which Agent capabilities the vendor can handle.
+A snapshot of each vendor's capabilities. "Text" refers to the main chat model; the remaining columns show which Agent capabilities the vendor can power.

-| Vendor | Representative Models | Text | Image Understanding | Image Generation | Speech-to-Text | Text-to-Speech | Embedding |
+| Vendor | Representative Models | Text | Vision | Image Gen | STT | TTS | Embedding |
 | --- | --- | :-: | :-: | :-: | :-: | :-: | :-: |
-| [DeepSeek](/models/deepseek) | deepseek-v4-flash / pro | ✅ | | | | | |
-| [MiniMax](/models/minimax) | MiniMax-M2.7 | ✅ | ✅ | ✅ | | ✅ | |
-| [Claude](/models/claude) | claude-opus-4-7 | ✅ | ✅ | | | | |
-| [Gemini](/models/gemini) | gemini-3.5-flash | ✅ | ✅ | ✅ | | | |
-| [OpenAI](/models/openai) | gpt-5.5, o-series | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
-| [Zhipu GLM](/models/glm) | glm-5.1, glm-5v-turbo | ✅ | ✅ | | ✅ | | ✅ |
-| [Tongyi Qwen](/models/qwen) | qwen3.7-max | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
-| [Doubao](/models/doubao) | doubao-seed-2.0 series | ✅ | ✅ | ✅ | | | ✅ |
-| [Kimi](/models/kimi) | kimi-k2.6 | ✅ | ✅ | | | | |
-| [Baidu Qianfan](/models/qianfan) | ernie-5.1 | ✅ | ✅ | | | | |
-| [LinkAI](/models/linkai) | 100+ models from multiple vendors | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
-| [Custom](/models/custom) | Local models / third-party proxies | ✅ | | | | | |
+| [DeepSeek](/en/models/deepseek) | deepseek-v4-flash / pro | ✅ | | | | | |
+| [MiniMax](/en/models/minimax) | MiniMax-M2.7 | ✅ | ✅ | ✅ | | ✅ | |
+| [Claude](/en/models/claude) | claude-opus-4-7 | ✅ | ✅ | | | | |
+| [Gemini](/en/models/gemini) | gemini-3.5-flash | ✅ | ✅ | ✅ | | | |
+| [OpenAI](/en/models/openai) | gpt-5.5, o-series | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+| [GLM](/en/models/glm) | glm-5.1, glm-5v-turbo | ✅ | ✅ | | ✅ | | ✅ |
+| [Qwen](/en/models/qwen) | qwen3.7-max | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+| [Doubao](/en/models/doubao) | doubao-seed-2.0 series | ✅ | ✅ | ✅ | | | ✅ |
+| [Kimi](/en/models/kimi) | kimi-k2.6 | ✅ | ✅ | | | | |
+| [ERNIE](/en/models/qianfan) | ernie-5.1 | ✅ | ✅ | | | | |
+| [LinkAI](/en/models/linkai) | 100+ models from multiple vendors | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+| [Custom](/en/models/custom) | Local models / third-party proxies | ✅ | | | | | |

 <Tip>
-  Every capability in the Web Console (Vision / Image / Speech-to-Text / Text-to-Speech / Embedding / Web Search) can be configured independently with its own vendor and model; they are not forced to be bound together.
+  Every capability in the Web console (Vision / Image / STT / TTS / Embedding / Web Search) can be configured independently with its own vendor and model — there is no forced binding between them.
 </Tip>

-
 ## How to Configure

-**Option 1 (recommended):** Manage models and capabilities online via the [Web Console](/channels/web), with no need to edit the configuration file:
+**Option 1 (recommended):** Manage models and capabilities online via the [Web console](/en/channels/web), with no need to edit the configuration file:

 <img width="900" src="https://cdn.link-ai.tech/doc/20260521212527.png" />

-**Option 2:** Manually edit `config.json` and fill in the model name and API key according to the selected model. Every model also supports OpenAI-compatible access: set `bot_type` to `openai` and configure `open_ai_api_base` and `open_ai_api_key`.
+**Option 2:** Edit `config.json` manually and fill in the model name and API key for the selected vendor. Every model also supports OpenAI-compatible access — just set `bot_type` to `openai` and configure `open_ai_api_base` and `open_ai_api_key`.
--- a/docs/en/models/qianfan.mdx
+++ b/docs/en/models/qianfan.mdx
@@ -1,6 +1,6 @@
 ---
-title: Baidu Qianfan / ERNIE
-description: Baidu Qianfan ERNIE model configuration
+title: ERNIE
+description: ERNIE model configuration (Baidu Qianfan)
 ---

 Option 1: Native integration (recommended):
--- a/docs/en/models/qwen.mdx
+++ b/docs/en/models/qwen.mdx
@@ -1,9 +1,9 @@
 ---
-title: Tongyi Qwen
-description: Tongyi Qwen model configuration (Text / Image Understanding / Image Generation / Speech-to-Text / Text-to-Speech / Embedding)
+title: Qwen
+description: Qwen model configuration (Text / Image Understanding / Image Generation / Speech-to-Text / Text-to-Speech / Embedding)
 ---

-Tongyi Qwen (DashScope / Bailian) is one of the most fully-featured vendors in China. Text, image understanding, image generation, speech-to-text, text-to-speech, and embedding can all be enabled with a single `dashscope_api_key`.
+Qwen (Alibaba DashScope / Bailian) is one of the most fully-featured vendors. Text, image understanding, image generation, speech-to-text, text-to-speech, and embedding can all be enabled with a single `dashscope_api_key`.

 <Tip>
  All capabilities below can be configured in one place via the "Model Management" page in the Web Console, with no need to manually edit the configuration file.
@@ -66,7 +66,7 @@ Available models: `qwen-image-2.0`, `qwen-image-2.0-pro`.

 | Parameter | Description |
 | --- | --- |
-| `voice_to_text` | Set to `dashscope` to enable Tongyi Qwen ASR |
+| `voice_to_text` | Set to `dashscope` to enable Qwen ASR |
 | `voice_to_text_model` | Optional, defaults to `qwen3-asr-flash` |

 Credentials are automatically reused from `dashscope_api_key`. A single audio segment should be smaller than 10MB and no longer than 300 seconds.
--- a/docs/en/releases/v2.0.3.mdx
+++ b/docs/en/releases/v2.0.3.mdx
@@ -34,7 +34,7 @@ Related commits: [30c6d9b](https://github.com/zhayujie/CowAgent/commit/30c6d9b)

 ## 💰 Coding Plan Support

-Added integration with vendor Coding Plan (monthly programming subscription) tiers via the unified OpenAI-compatible path. Supported vendors include Aliyun, MiniMax, Zhipu GLM, Kimi, and Volcengine.
+Added integration with vendor Coding Plan (monthly programming subscription) tiers via the unified OpenAI-compatible path. Supported vendors include Aliyun, MiniMax, GLM, Kimi, and Volcengine.

 See [Coding Plan docs](https://docs.cowagent.ai/en/models/coding-plan) for detailed configuration.

--- a/docs/en/releases/v2.0.8.mdx
+++ b/docs/en/releases/v2.0.8.mdx
@@ -1,6 +1,6 @@
 ---
 title: v2.0.8
-description: CowAgent 2.0.8 - Major Feishu channel upgrade (voice, streaming typewriter, one-click QR app creation), DeepSeek V4 / Baidu Qianfan ERNIE 5.0 support, scheduler memory enhancements and multiple fixes
+description: CowAgent 2.0.8 - Major Feishu channel upgrade (voice, streaming typewriter, one-click QR app creation), DeepSeek V4 / ERNIE 5.0 support, scheduler memory enhancements and multiple fixes
 ---

 ## 🪶 Major Feishu Channel Upgrade
@@ -30,9 +30,9 @@ The voice and streaming building blocks come from a community contribution #2791

 - **DeepSeek V4 series**: Added `deepseek-v4-pro` / `deepseek-v4-flash`, with `deepseek-v4-flash` set as the new default
 - **Unified thinking-mode toggle**: DeepSeek V4, Qwen3 and other thinking-capable models now share the same `enable_thinking` switch
- **Baidu Qianfan / ERNIE first-class integration**: New `qianfan` provider supporting `ernie-5.0` (default recommendation), `ernie-x1.1`, `ernie-4.5-turbo-128k`, `ernie-4.5-turbo-32k`. Dedicated `qianfan_api_key` / `qianfan_api_base` settings keep OpenAI config clean; legacy `wenxin` / `wenxin-4` paths are fully preserved. #2790 Thanks [@jimmyzhuu](https://github.com/jimmyzhuu)
+- **ERNIE first-class integration**: New `qianfan` provider supporting `ernie-5.0` (default recommendation), `ernie-x1.1`, `ernie-4.5-turbo-128k`, `ernie-4.5-turbo-32k`. Dedicated `qianfan_api_key` / `qianfan_api_base` settings keep OpenAI config clean; legacy `wenxin` / `wenxin-4` paths are fully preserved. #2790 Thanks [@jimmyzhuu](https://github.com/jimmyzhuu)

-  Documentation: [Baidu Qianfan / ERNIE](https://docs.cowagent.ai/en/models/qianfan)
+  Documentation: [ERNIE](https://docs.cowagent.ai/en/models/qianfan)

 ## 🌐 Translation Provider

--- a/docs/en/skills/hub.mdx
+++ b/docs/en/skills/hub.mdx
@@ -0,0 +1,65 @@
+---
+title: Skill Hub
+description: Browse, search, and install AI Agent skills
+---
+
+[Cow Skill Hub](https://skills.cowagent.ai/) is an open-source skill marketplace for AI Agents, aggregating official picks, community contributions, and third-party skills from GitHub, ClawHub, and beyond.
+
+Source code: [github.com/zhayujie/cow-skill-hub](https://github.com/zhayujie/cow-skill-hub)
+
+<img src="https://cdn.link-ai.tech/doc/20260401110103.png" width="800" />
+
+## Features
+
+- **Browse skills** — filter by category (Featured / Community / Third-party) and tags
+- **Search skills** — find skills by name or description
+- **View details** — read the skill manifest, file contents, install command, and required environment variables
+- **One-click install** — copy the install command and run it in CowAgent
+
+## Installing a skill
+
+Run the install command in chat or in your terminal:
+
+<CodeGroup>
+```text Chat
+/skill install <name>
+```
+
+```bash Terminal
+cow skill install <name>
+```
+</CodeGroup>
+
+You can also browse the marketplace directly from chat:
+
+```text
+/skill list --remote
+/skill search <keyword>
+```
+
+Beyond the curated list, you can install third-party skills from **GitHub, ClawHub, LinkAI, or any URL** via the CLI. See [Installing skills](/en/skills/install) for details.
+
+## Contributing a skill
+
+To submit your own skill:
+
+1. Visit [skills.cowagent.ai/submit](https://skills.cowagent.ai/submit)
+2. Sign in with GitHub or Google
+3. Upload a folder or zip file containing `SKILL.md`
+4. Skill name, display name, and description are auto-detected — adjust as needed
+5. Submit for review; skills go live after security and quality checks
+
+<img src="https://cdn.link-ai.tech/doc/20260401111904.png" width="800" />
+
+Skill file layout:
+
+```
+your-skill/
+├── SKILL.md        # required, in the root
+├── scripts/        # optional, runtime scripts
+└── resources/      # optional, additional assets
+```
+
+<Tip>
+  Skills are built around the `SKILL.md` manifest. You can also download `SKILL.md` from a skill's detail page and use it with any Agent that supports custom instructions (OpenClaw, Cursor, Claude Code, and more).
+</Tip>
--- a/docs/en/skills/image-generation.mdx
+++ b/docs/en/skills/image-generation.mdx
@@ -1,5 +1,5 @@
 ---
-title: image-generation - Image Generation
+title: image-generation
 description: Text-to-image / image-to-image / multi-image fusion with automatic multi-provider routing and fallback
 ---

@@ -39,7 +39,7 @@ To pin a specific model:
 ## Configuring API Keys

 <Tip>
-  It is recommended to configure providers from the "Model Management" page in the [Web Console](/channels/web). Chat model keys configured there are automatically reused by the image generation skill — no need to set them twice. You can also edit the configuration file manually or temporarily set keys in a conversation using the `env_config` tool.
+  It is recommended to configure providers from the "Model Management" page in the [Web console](/en/channels/web). Chat model keys configured there are automatically reused by the image generation skill — no need to set them twice. You can also edit the configuration file manually or temporarily set keys in a conversation using the `env_config` tool.
 </Tip>

 Credentials are shared with the main model providers:
--- a/docs/en/skills/install.mdx
+++ b/docs/en/skills/install.mdx
@@ -3,11 +3,11 @@ title: Install Skills
 description: Install skills from multiple sources with a single command
 ---

-CowAgent supports installing skills from **Cow Skill Hub, GitHub, ClawHub**, and any URL with a unified `install` command. Use `/skill install` in chat or `cow skill install` in the terminal.
+CowAgent supports installing skills from **[Cow Skill Hub](https://skills.cowagent.ai/), GitHub, ClawHub, LinkAI**, and any URL via a unified `install` command. Use `/skill install` in chat or `cow skill install` in the terminal.

-## From Skill Hub
+## From the Skill Hub

-Browse the Skill Hub and install:
+Browse all available skills at [skills.cowagent.ai](https://skills.cowagent.ai/) and install by name:

 ```text
 /skill list --remote
@@ -16,7 +16,7 @@ Browse the Skill Hub and install:

 ## From GitHub

-Supports batch install from repositories and single skill from subdirectories:
+Any GitHub-hosted skill can be installed directly. Supports both repository-level batch install and subdirectory-level single install:

 ```text
 /skill install larksuite/cli
@@ -25,10 +25,22 @@ Supports batch install from repositories and single skill from subdirectories:

 ## From ClawHub

+All [ClawHub](https://clawhub.ai/) skills (40k+) can be installed with a single command:
+
 ```text
-/skill install clawhub:baidu-search
+/skill install clawhub:<name>
 ```

+## From LinkAI
+
+All public resources on [LinkAI](https://link-ai.tech/console) (10k+ apps / workflows / plugins), as well as your own resources (apps, workflows, knowledge bases, databases, plugins), can be installed via:
+
+```text
+/skill install linkai:<code>
+```
+
+> Every resource created on the LinkAI platform has a unique `code`. Find it on each resource's page in the [console](https://link-ai.tech/console).
+
 ## From URL

 Supports zip archives and SKILL.md file links:
--- a/docs/en/skills/knowledge-wiki.mdx
+++ b/docs/en/skills/knowledge-wiki.mdx
@@ -1,5 +1,5 @@
 ---
-title: knowledge-wiki - Knowledge Base
+title: knowledge-wiki
 description: Maintain a local structured knowledge base with automatic archiving, categorisation, and cross-referencing
 ---

--- a/docs/en/skills/skill-creator.mdx
+++ b/docs/en/skills/skill-creator.mdx
@@ -1,5 +1,5 @@
 ---
-title: skill-creator - Skill Creator
+title: skill-creator
 description: Create, install, and update skills — standardises SKILL.md format and directory structure
 ---

--- a/docs/en/tools/scheduler.mdx
+++ b/docs/en/tools/scheduler.mdx
@@ -38,3 +38,43 @@ Create and manage scheduled tasks with natural language:
 <Frame>
  <img src="https://cdn.link-ai.tech/doc/20260202195402.png" width="800" />
 </Frame>
+
+## Results injected into the conversation
+
+Scheduled tasks run inside an isolated session (so internal planning and tool calls do not pollute the user's chat), but the **final output** is written back to the user's real session as a message pair. You can directly follow up — e.g. "expand on point 2 from earlier".
+
+**Default policy**
+
+- Output of Agent dynamic tasks is injected into the conversation
+- Fixed-message tasks are not injected by default (configurable)
+- Each session keeps the most recent **3 pairs** of scheduler messages; older pairs are pruned automatically. Regular user messages are unaffected
+
+**Configuration**
+
+| Key | Default | Description |
+| --- | --- | --- |
+| `scheduler_inject_to_session` | `true` | Master switch |
+| `scheduler_inject_max_per_session` | `3` | Max scheduler message pairs kept per session |
+| `scheduler_inject_send_message` | `false` | Whether to also inject fixed-message tasks |
+
+```json
+{
+  "scheduler_inject_to_session": true,
+  "scheduler_inject_max_per_session": 3,
+  "scheduler_inject_send_message": false
+}
+```
+
+## Context inside scheduled task execution
+
+The isolated session for scheduled tasks retains a few recent runs of conversation history, so you can naturally do "compare with last time" or "continue from previous conclusion". To prevent prompts from growing unbounded for high-frequency tasks (e.g. a 5-minute monitor), history is auto-trimmed:
+
+```
+scheduler_keep_turns = max(1, agent_max_context_turns / 5)
+```
+
+`agent_max_context_turns` defaults to `20`, so each scheduled run keeps the most recent **4 turns** of history by default. Increase `agent_max_context_turns` if you need longer memory.
+
+<Note>
+For group-chat scenarios (Feishu / WeCom group bots / DingTalk, etc.), the user's real `session_id` looks like `user_id:group_id` — different from `receiver`. Scheduler records the correct `session_id` when a task is created. For older `tasks.json` entries missing this field, the runtime falls back to `receiver`, matching legacy behavior.
+</Note>
--- a/docs/en/tools/vision.mdx
+++ b/docs/en/tools/vision.mdx
@@ -24,7 +24,7 @@ If the current provider fails, the tool automatically tries the next one until i
 | Gemini | Main model | inlineData format |
 | Doubao | Main model | doubao-seed-2-0 series natively supported |
 | Kimi (Moonshot) | Main model | kimi-k2.6, kimi-k2.5 natively supported |
-| Baidu Qianfan | Main model | Defaults to the multimodal main model (e.g. `ernie-5.1`); falls back to `ernie-4.5-turbo-vl` when the main model is not multimodal |
+| ERNIE | Main model | Defaults to the multimodal main model (e.g. `ernie-5.1`); falls back to `ernie-4.5-turbo-vl` when the main model is not multimodal |
 | ZhipuAI | glm-5v-turbo | Always uses the dedicated vision model |
 | MiniMax | MiniMax-Text-01 | Always uses the dedicated vision model |

--- a/docs/en/tools/web-fetch.mdx
+++ b/docs/en/tools/web-fetch.mdx
@@ -0,0 +1,32 @@
+---
+title: web_fetch - Web Fetch
+description: Fetch web pages and document content
+---
+
+Fetch the content of an HTTP/HTTPS URL. Web pages are extracted as readable text; document files (PDF, Word, Excel, etc.) are downloaded and parsed automatically.
+
+## Parameters
+
+| Parameter | Type | Required | Description |
+| --- | --- | --- | --- |
+| `url` | string | Yes | HTTP/HTTPS URL (web page or document) |
+
+## Supported file types
+
+| Type | Formats |
+| --- | --- |
+| PDF | `.pdf` |
+| Word | `.docx` |
+| Text | `.txt`, `.md`, `.csv`, `.log` |
+| Spreadsheet | `.xls`, `.xlsx` |
+| Presentation | `.ppt`, `.pptx` |
+
+## Use cases
+
+- Extract readable text from a web page
+- Download and parse remote documents
+- Inspect API response bodies
+
+<Note>
+  `web_fetch` only retrieves static HTML. For pages that require JavaScript rendering (such as SPAs), use the `browser` tool instead.
+</Note>
--- a/docs/en/tools/web-search.mdx
+++ b/docs/en/tools/web-search.mdx
@@ -3,10 +3,10 @@ title: web_search - Web Search
 description: Search the internet for real-time information, with support for multiple search providers
 ---

-Search the internet for real-time information, news, research, and more. Supports four backends — Bocha, Baidu Qianfan, Zhipu, and LinkAI — and works once any one of them is configured.
+Search the internet for real-time information, news, research, and more. Supports four backends — Bocha, ERNIE, GLM, and LinkAI — and works once any one of them is configured.

 <Tip>
-  It is recommended to configure providers and routing strategy visually from the "Model Management → Search" panel in the [Web Console](/channels/web), without manually editing the configuration file.
+  It is recommended to configure providers and routing strategy visually from the "Model Management → Search" panel in the [Web console](/en/channels/web), without manually editing the configuration file.
 </Tip>

 ## Providers
@@ -14,7 +14,7 @@ Search the internet for real-time information, news, research, and more. Support
 | Provider | Credential | Apply |
 | --- | --- | --- |
 | Bocha | `tools.web_search.bocha_api_key` | [Bocha Open Platform](https://open.bochaai.com/) |
-| Baidu Qianfan | Reuses `qianfan_api_key` | [Qianfan Console](https://cloud.baidu.com/doc/qianfan/s/2mh4su4uy) |
+| ERNIE | Reuses `qianfan_api_key` | [Qianfan Console](https://cloud.baidu.com/doc/qianfan/s/2mh4su4uy) |
 | Zhipu | Reuses `zhipu_ai_api_key` | [Zhipu Open Platform](https://docs.bigmodel.cn/cn/guide/tools/web-search) |
 | LinkAI | Reuses `linkai_api_key` | [LinkAI Console](https://link-ai.tech/console/interface) |

--- a/docs/intro/index.mdx
+++ b/docs/intro/index.mdx
@@ -3,7 +3,9 @@ title: 项目介绍
 description: CowAgent - 基于大模型的超级AI助理
 ---

+<div align="center">
  <img src="https://cdn.link-ai.tech/doc/78c5dd674e2c828642ecc0406669fed7.png" alt="CowAgent" width="450px"/>
+</div>

 **CowAgent** 是基于大模型的超级AI助理，能够主动思考和任务规划、操作计算机和外部资源、创造和执行Skills、拥有长期记忆和知识库并不断成长。

--- a/docs/ja/README.md
+++ b/docs/ja/README.md
@@ -25,15 +25,15 @@ CowAgent は軽量でデプロイしやすく、拡張性に優れています

 | 機能 | 説明 |
 | :--- | :--- |
-| 🤖 [自律的タスク計画](https://docs.cowagent.ai/ja/intro/architecture) | 複雑なタスクを分解し、目標達成までツールを繰り返し呼び出して段階的に実行 |
+| 🤖 [タスク計画](https://docs.cowagent.ai/ja/intro/architecture) | 複雑なタスクを分解し、目標達成までツールを繰り返し呼び出して段階的に実行 |
 | 🧠 [長期記憶](https://docs.cowagent.ai/ja/memory/index) | 三層構造（コンテキスト → デイリー → コア）、Deep Dream による自動蒸留、キーワードとベクトルのハイブリッド検索 |
-| 📚 [パーソナルナレッジベース](https://docs.cowagent.ai/ja/knowledge/index) | 構造化された知識を Markdown Wiki として自動整理し、進化し続けるナレッジグラフを可視化ブラウジング |
-| 🧩 [Skill システム](https://docs.cowagent.ai/ja/skills/index) | [Skill Hub](https://skills.cowagent.ai/)、GitHub、ClawHub からワンクリックでインストール；対話によるカスタム Skill 作成にも対応 |
-| 🔧 [ツールシステム](https://docs.cowagent.ai/ja/tools/index) | ファイル I/O、ターミナル、ブラウザ、スケジューラ、記憶検索、Web 検索など 10+ の組み込みツール — MCP プロトコルに完全対応 |
-| 💬 [マルチチャネル統合](https://docs.cowagent.ai/ja/channels/index) | 一つの Agent で Web、WeChat、Feishu、DingTalk、WeCom、QQ、公式アカウントを同時にサポート |
-| 🎨 マルチモーダルメッセージ | テキスト・画像・音声・ファイルをフルサポート — 認識・生成・双方向送受信 |
-| ⚙️ [プラガブルなモデル](https://docs.cowagent.ai/ja/models/index) | Claude、GPT、Gemini、DeepSeek、GLM、Qwen、Kimi、MiniMax、Doubao など、設定 1 行で切り替え可能 |
-| 📦 [すぐに使える](https://docs.cowagent.ai/ja/guide/quick-start) | ワンラインインストーラー、統合された Web コンソール、複数のデプロイモード（ローカル / Docker / サーバー） |
+| 📚 [ナレッジベース](https://docs.cowagent.ai/ja/knowledge/index) | 構造化された知識を Markdown Wiki として自動整理し、進化し続けるナレッジグラフを可視化ブラウジング |
+| 🧩 [Skill](https://docs.cowagent.ai/ja/skills/index) | [Skill Hub](https://skills.cowagent.ai/)、GitHub、ClawHub からワンクリックでインストール；対話によるカスタム Skill 作成にも対応 |
+| 🔧 [ツール](https://docs.cowagent.ai/ja/tools/index) | ファイル I/O、ターミナル、ブラウザ、スケジューラ、記憶検索、Web 検索など 10+ の組み込みツール — MCP プロトコルに完全対応 |
+| 💬 [チャネル](https://docs.cowagent.ai/ja/channels/index) | 一つの Agent で Web、WeChat、Feishu、DingTalk、WeCom、QQ、公式アカウントを同時にサポート |
+| 🎨 マルチモーダル | テキスト・画像・音声・ファイルをフルサポート — 認識・生成・双方向送受信 |
+| ⚙️ [モデル](https://docs.cowagent.ai/ja/models/index) | Claude、GPT、Gemini、DeepSeek、GLM、Qwen、Kimi、MiniMax、Doubao など、設定 1 行で切り替え可能 |
+| 📦 [クイックスタート](https://docs.cowagent.ai/ja/guide/quick-start) | ワンラインインストーラー、統合された Web コンソール、複数のデプロイモード（ローカル / Docker / サーバー） |

 <br/>

@@ -72,7 +72,7 @@ docker compose up -d

 起動後、`http://localhost:9899` にアクセスして **Web コンソール**を開くと、モデル設定・チャネル接続・Skill インストールがすべてここで完結します。

-> 📖 詳細ガイド: [ワンラインインストーラー](https://docs.cowagent.ai/ja/guide/quick-start) · [ソースから手動インストール](https://docs.cowagent.ai/ja/guide/manual-install) · [アップグレード](https://docs.cowagent.ai/ja/guide/upgrade)
+> 📖 詳細ガイド: [クイックスタート](https://docs.cowagent.ai/ja/guide/quick-start) · [ソースからインストール](https://docs.cowagent.ai/ja/guide/manual-install) · [アップグレード](https://docs.cowagent.ai/ja/guide/upgrade)

 インストール後は、[`cow` CLI](https://docs.cowagent.ai/ja/cli/index) でサービスを管理できます：

@@ -101,7 +101,7 @@ CowAgent は主要な LLM プロバイダーすべてに対応しています。
 | [Doubao](https://docs.cowagent.ai/ja/models/doubao) | doubao-seed-2.0 シリーズ | ✅ | ✅ | ✅ | | | ✅ |
 | [Kimi](https://docs.cowagent.ai/ja/models/kimi) | kimi-k2.6 | ✅ | ✅ | | | | |
 | [MiniMax](https://docs.cowagent.ai/ja/models/minimax) | MiniMax-M2.7 | ✅ | ✅ | ✅ | | ✅ | |
-| [Qianfan](https://docs.cowagent.ai/ja/models/qianfan) | ernie-5.1 | ✅ | ✅ | | | | |
+| [ERNIE](https://docs.cowagent.ai/ja/models/qianfan) | ernie-5.1 | ✅ | ✅ | | | | |
 | [LinkAI](https://docs.cowagent.ai/ja/models/linkai) | 100+ モデルを統一ゲートウェイで提供 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
 | [カスタム](https://docs.cowagent.ai/ja/models/custom) | ローカルモデル / サードパーティプロキシ | ✅ | | | | | |

@@ -217,18 +217,6 @@ WeChat の QR コードをスキャンしてオープンソースコミュニテ

 <br/>

-## 🛠️ 開発とコントリビューション
-
-新しいチャネルの追加を歓迎します — [Feishu チャネル](https://github.com/zhayujie/CowAgent/blob/master/channel/feishu/feishu_channel.py) を参考にカスタムチャネルを実装できます。新しい Skill のコントリビューションも [Skill Hub](https://skills.cowagent.ai/submit) で受け付けています。
-
-⭐ Star でプロジェクトの更新をフォローしてください。PR や Issue の提出も歓迎します。
-
-## 🌟 コントリビューター
-
-![cow contributors](https://contrib.rocks/image?repo=zhayujie/CowAgent&max=1000)
-
-<br/>
-
 ## 🏢 エンタープライズサービス

 [**LinkAI**](https://link-ai.tech/) は企業や開発者向けのワンストップ AI Agent プラットフォームで、CowAgent にマネージドホスティングとエンタープライズグレードのサポートを提供します：
@@ -241,6 +229,18 @@ WeChat の QR コードをスキャンしてオープンソースコミュニテ

 <br/>

+## 🛠️ 開発とコントリビューション
+
+新しいチャネルの追加を歓迎します — [Feishu チャネル](https://github.com/zhayujie/CowAgent/blob/master/channel/feishu/feishu_channel.py) を参考にカスタムチャネルを実装できます。新しい Skill のコントリビューションも [Skill Hub](https://skills.cowagent.ai/submit) で受け付けています。
+
+⭐ Star でプロジェクトの更新をフォローしてください。PR や Issue の提出も歓迎します。
+
+## 🌟 コントリビューター
+
+![cow contributors](https://contrib.rocks/image?repo=zhayujie/CowAgent&max=1000)
+
+<br/>
+
 ## ⚠️ 免責事項

 1. 本プロジェクトは [MIT License](/LICENSE) に基づき、技術研究と学習を目的としています。利用者は所在地の法令・規制を遵守する必要があり、本プロジェクトの利用に起因するいかなる結果についてもメンテナーは責任を負いません。
--- a/docs/ja/skills/hub.mdx
+++ b/docs/ja/skills/hub.mdx
@@ -0,0 +1,65 @@
+---
+title: スキルハブ
+description: AI Agent スキルの閲覧、検索、インストール
+---
+
+[Cow Skill Hub](https://skills.cowagent.ai/) は、公式推奨・コミュニティ貢献・サードパーティ（GitHub、ClawHub など）のスキルを集約した、オープンソースの AI Agent スキルマーケットプレイスです。
+
+ソースコード: [github.com/zhayujie/cow-skill-hub](https://github.com/zhayujie/cow-skill-hub)
+
+<img src="https://cdn.link-ai.tech/doc/20260401110103.png" width="800" />
+
+## 機能
+
+- **スキル閲覧** — カテゴリ（公式推奨 / コミュニティ / サードパーティ）とタグでフィルタ
+- **スキル検索** — 名前または説明で検索
+- **詳細表示** — スキルマニフェスト、ファイル内容、インストールコマンド、必要な環境変数を確認
+- **ワンクリックインストール** — インストールコマンドをコピーして CowAgent で実行
+
+## スキルのインストール
+
+チャット内またはターミナルでインストールコマンドを実行:
+
+<CodeGroup>
+```text チャット
+/skill install <name>
+```
+
+```bash ターミナル
+cow skill install <name>
+```
+</CodeGroup>
+
+チャットからスキルハブを直接閲覧することもできます:
+
+```text
+/skill list --remote
+/skill search <キーワード>
+```
+
+リスト表示されている厳選スキル以外にも、**GitHub、ClawHub、LinkAI、任意の URL** からサードパーティスキルを CLI 経由でインストールできます。詳しくは [スキルのインストール](/ja/skills/install) を参照してください。
+
+## スキルの貢献
+
+ご自身のスキルを投稿するには:
+
+1. [skills.cowagent.ai/submit](https://skills.cowagent.ai/submit) にアクセス
+2. GitHub または Google でログイン
+3. `SKILL.md` を含むフォルダまたは zip ファイルをアップロード
+4. スキル名・表示名・説明は自動検出されます。必要に応じて編集してください
+5. 提出後、セキュリティ・品質チェックを経て公開されます
+
+<img src="https://cdn.link-ai.tech/doc/20260401111904.png" width="800" />
+
+スキルのファイル構成:
+
+```
+your-skill/
+├── SKILL.md        # 必須、ルートに配置
+├── scripts/        # 任意、実行スクリプト
+└── resources/      # 任意、その他リソース
+```
+
+<Tip>
+  スキルは `SKILL.md` マニフェストを中心に構築されます。スキル詳細ページから `SKILL.md` をダウンロードし、カスタム指示に対応した任意の Agent（OpenClaw、Cursor、Claude Code など）でも利用できます。
+</Tip>
--- a/docs/ja/tools/web-fetch.mdx
+++ b/docs/ja/tools/web-fetch.mdx
@@ -0,0 +1,32 @@
+---
+title: web_fetch - Web 取得
+description: Web ページやドキュメントのコンテンツを取得
+---
+
+HTTP/HTTPS URL の内容を取得します。Web ページからは可読テキストを抽出し、ドキュメントファイル（PDF、Word、Excel など）は自動でダウンロードして解析します。
+
+## パラメータ
+
+| パラメータ | 型 | 必須 | 説明 |
+| --- | --- | --- | --- |
+| `url` | string | はい | HTTP/HTTPS URL（Web ページまたはドキュメント） |
+
+## 対応ファイル形式
+
+| 種別 | 形式 |
+| --- | --- |
+| PDF | `.pdf` |
+| Word | `.docx` |
+| テキスト | `.txt`、`.md`、`.csv`、`.log` |
+| 表計算 | `.xls`、`.xlsx` |
+| プレゼン | `.ppt`、`.pptx` |
+
+## ユースケース
+
+- Web ページの可読テキストを抽出する
+- リモートドキュメントのダウンロードと解析
+- API レスポンスの確認
+
+<Note>
+  `web_fetch` は静的 HTML のみ取得できます。JavaScript レンダリングが必要なページ（SPA など）は `browser` ツールを使用してください。
+</Note>
--- a/docs/zh/README.md
+++ b/docs/zh/README.md
@@ -25,15 +25,15 @@ CowAgent 轻量、易部署、可扩展，自由接入主流大模型，覆盖

 | 能力 | 说明 |
 | :--- | :--- |
-| 🤖 [自主任务规划](https://docs.cowagent.ai/intro/architecture) | 理解复杂任务并自主分解执行，循环调用工具直到完成目标 |
+| 🤖 [任务规划](https://docs.cowagent.ai/intro/architecture) | 理解复杂任务并自主分解执行，循环调用工具直到完成目标 |
 | 🧠 [长期记忆](https://docs.cowagent.ai/memory) | 三层记忆架构（上下文 → 天级 → 核心），梦境蒸馏自动整理，支持关键词与向量混合检索 |
-| 📚 [个人知识库](https://docs.cowagent.ai/knowledge) | 自动整理结构化知识为 Markdown Wiki，构建持续增长的知识图谱，可视化浏览 |
-| 🧩 [技能系统](https://docs.cowagent.ai/skills) | 从 [Skill Hub](https://skills.cowagent.ai/)、GitHub、ClawHub 等一键安装；也可通过对话创造自定义技能 |
-| 🔧 [工具系统](https://docs.cowagent.ai/tools) | 内置文件读写、终端、浏览器、定时任务、记忆检索、联网搜索等 10+ 工具，支持 MCP 协议 |
-| 💬 [多渠道接入](https://docs.cowagent.ai/channels) | 一个 Agent 同时接入 Web、微信、飞书、钉钉、企微、QQ、公众号 等多个渠道 |
-| 🎨 多模态消息 | 文本、图片、语音、文件全消息类型支持，覆盖识别、生成、收发 |
-| ⚙️ [多模型自由切换](https://docs.cowagent.ai/models) | DeepSeek、Claude、Gemini、GPT、GLM、Qwen、Kimi、MiniMax、Doubao 等主流厂商，配置一行切换 |
-| 📦 [开箱即用](https://docs.cowagent.ai/guide/quick-start) | 一键脚本安装，Web 控制台统一管理；本地、Docker、服务器多种部署方式 |
+| 📚 [知识库](https://docs.cowagent.ai/knowledge) | 自动整理结构化知识为 Markdown Wiki，构建持续增长的知识图谱，可视化浏览 |
+| 🧩 [技能](https://docs.cowagent.ai/skills) | 从 [Skill Hub](https://skills.cowagent.ai/)、GitHub、ClawHub 等一键安装；也可通过对话创造自定义技能 |
+| 🔧 [工具](https://docs.cowagent.ai/tools) | 内置文件读写、终端、浏览器、定时任务、记忆检索、联网搜索等 10+ 工具，支持 MCP 协议 |
+| 💬 [通道](https://docs.cowagent.ai/channels) | 一个 Agent 同时接入 Web、微信、飞书、钉钉、企微、QQ、公众号 等多个渠道 |
+| 🎨 多模态 | 文本、图片、语音、文件全消息类型支持，覆盖识别、生成、收发 |
+| ⚙️ [模型](https://docs.cowagent.ai/models) | DeepSeek、Claude、Gemini、GPT、GLM、Qwen、Kimi、MiniMax、Doubao 等主流厂商，配置一行切换 |
+| 📦 [快速开始](https://docs.cowagent.ai/guide/quick-start) | 一键脚本安装，Web 控制台统一管理；本地、Docker、服务器多种部署方式 |

 <br/>

@@ -72,7 +72,7 @@ docker compose up -d

 启动成功后访问 `http://localhost:9899` 进入 **Web 控制台**，在控制台内即可完成模型配置、渠道接入、技能安装等全部操作。

-> 📖 详细安装指南：[一键运行脚本](https://docs.cowagent.ai/guide/quick-start) · [手动源码安装](https://docs.cowagent.ai/guide/manual-install) · [升级](https://docs.cowagent.ai/guide/upgrade)
+> 📖 详细安装指南：[快速开始](https://docs.cowagent.ai/guide/quick-start) · [源码安装](https://docs.cowagent.ai/guide/manual-install) · [升级](https://docs.cowagent.ai/guide/upgrade)

 安装后可使用 `cow` [CLI 命令](https://docs.cowagent.ai/cli) 管理服务：

@@ -101,7 +101,7 @@ CowAgent 支持国内外主流厂商的大语言模型。**文本对话、图像
 | [通义千问](https://docs.cowagent.ai/models/qwen) | qwen3.7-max | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
 | [豆包 Doubao](https://docs.cowagent.ai/models/doubao) | doubao-seed-2.0 系列 | ✅ | ✅ | ✅ | | | ✅ |
 | [Kimi](https://docs.cowagent.ai/models/kimi) | kimi-k2.6 | ✅ | ✅ | | | | |
-| [百度千帆](https://docs.cowagent.ai/models/qianfan) | ernie-5.1 | ✅ | ✅ | | | | |
+| [百度ERNIE](https://docs.cowagent.ai/models/qianfan) | ernie-5.1 | ✅ | ✅ | | | | |
 | [LinkAI](https://docs.cowagent.ai/models/linkai) | 100+ 模型统一接入 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
 | [自定义](https://docs.cowagent.ai/models/custom) | 本地模型 / 三方代理 | ✅ | | | | | |

@@ -221,18 +221,6 @@ CowAgent 支持国内外主流厂商的大语言模型。**文本对话、图像

 <br/>

-## 🛠️ 开发与贡献
-
-欢迎接入更多应用通道，参考 [飞书通道实现](https://github.com/zhayujie/CowAgent/blob/master/channel/feishu/feishu_channel.py) 新增自定义通道；同时欢迎贡献新技能，向 [Skill Hub](https://skills.cowagent.ai/submit) 提交。
-
-通过 ⭐ Star 关注项目更新，欢迎提交 PR、Issue 进行反馈。
-
-## 🌟 贡献者
-
-![cow contributors](https://contrib.rocks/image?repo=zhayujie/CowAgent&max=1000)
-
-<br/>
-
 ## 🏢 企业服务

 <a href="https://link-ai.tech" target="_blank"><img width="550" src="https://cdn.link-ai.tech/image/link-ai-intro.jpg"></a>
@@ -249,6 +237,18 @@ CowAgent 支持国内外主流厂商的大语言模型。**文本对话、图像

 <br/>

+## 🛠️ 开发与贡献
+
+欢迎接入更多应用通道，参考 [飞书通道实现](https://github.com/zhayujie/CowAgent/blob/master/channel/feishu/feishu_channel.py) 新增自定义通道；同时欢迎贡献新技能，向 [Skill Hub](https://skills.cowagent.ai/submit) 提交。
+
+通过 ⭐ Star 关注项目更新，欢迎提交 PR、Issue 进行反馈。
+
+## 🌟 贡献者
+
+![cow contributors](https://contrib.rocks/image?repo=zhayujie/CowAgent&max=1000)
+
+<br/>
+
 ## ⚠️ 声明

 1. 本项目遵循 [MIT 开源协议](/LICENSE)，主要用于技术研究和学习。使用时请遵守所在地法律法规及相关政策，因使用本项目所产生的一切后果由使用者自行承担。