sipeed · wzg-gie · Apr 11, 2026 · Apr 25, 2026 · Apr 25, 2026 · Apr 25, 2026
diff --git a/docs/channels/dingtalk.md b/docs/channels/dingtalk.md
@@ -35,19 +35,40 @@ In **Permissions & Scopes**, ensure the following permissions are granted:
 
 ### 5. Configure PicoClaw
 
+#### 1. WebUI Configuration
+
+We recommend using the WebUI first because it is faster and more convenient.
+
+![WebUI DingTalk Connection Interface](/img/channels/webui_dingtalk.png)
+
+Fill in the Client ID (`YOUR_CLIENT_ID`) and Client Secret (`YOUR_CLIENT_SECRET`) in order, then click **Save**.
+
+#### 2. Configuration Files
+
+Edit `~/.picoclaw/.security.yml`:
+
+```yaml
+dingtalk:
+  settings:
+    client_secret: YOUR_CLIENT_SECRET
+```
+
+Edit `~/.picoclaw/config.json`:
+
 ```json
 {
   "channels": {
-    "dingtalk": {
       "enabled": true,
-      "client_id": "YOUR_CLIENT_ID",
-      "client_secret": "YOUR_CLIENT_SECRET",
-      "allow_from": [],
-      "group_trigger": {
-        "mention_only": true
+      "type": "dingtalk",
+      "reasoning_channel_id": "",
+      "group_trigger": {},
+      "typing": {},
+      "placeholder": {
+        "enabled": false
       },
-      "reasoning_channel_id": ""
-    }
+      "settings": {
+        "client_id": "YOUR_CLIENT_ID"
+      }
   }
 }
 ```

diff --git a/docs/channels/discord.md b/docs/channels/discord.md
@@ -24,14 +24,43 @@ title: Discord
 
 ### 4. Configure
 
+#### 1. WebUI Configuration
+
+We recommend using the WebUI first because it is faster and more convenient.
+
+![WebUI Discord Connection Interface](/img/channels/webui_discord.png)
+
+Fill in the Bot Token (`YOUR_BOT_TOKEN`) and Allowed Sources (`YOUR_USER_ID`) in order, then click **Save**.
+
+#### 2. Configuration Files
+
+Edit `~/.picoclaw/.security.yml`:
+
+```yaml
+discord:
+  settings:
+    token: YOUR_BOT_TOKEN
+```
+
+Edit `~/.picoclaw/config.json`:
+
 ```json
 {
   "channels": {
     "discord": {
       "enabled": true,
-      "token": "YOUR_BOT_TOKEN",
-      "allow_from": ["YOUR_USER_ID"],
-      "group_trigger": {
+      "type": "discord",
+      "allow_from": [
+        "YOUR_USER_ID"
+      ],
+      "reasoning_channel_id": "",
+      "group_trigger": {},
+      "typing": {},
+      "placeholder": {
+        "enabled": false
+      },
+      "settings": {
+        "proxy": "",
         "mention_only": false
       }
     }

diff --git a/docs/channels/feishu.md b/docs/channels/feishu.md
@@ -51,30 +51,53 @@ For development/testing, you can leave `encrypt_key` and `verification_token` em
 
 ### 5. Configure PicoClaw
 
+#### 1. WebUI Configuration
+
+We recommend using the WebUI first because it is faster and more convenient.
+
+![WebUI Feishu Connection Interface](/img/channels/webui_feishu.png)
+
+Fill in the App ID (`YOUR_APP_ID`), App Secret (`YOUR_APP_SECRET`), Encrypt Key (`YOUR_ENCRYPT_KEY`), and Verification Token (`YOUR_VERIFICATION_TOKEN`) in order, then click **Save**.
+
+#### 2. Configuration Files
+
+Edit `~/.picoclaw/config.json`:
+
 ```json
 {
   "channels": {
     "feishu": {
       "enabled": true,
-      "app_id": "cli_xxx",
-      "app_secret": "YOUR_APP_SECRET",
-      "encrypt_key": "YOUR_ENCRYPT_KEY",
-      "verification_token": "YOUR_VERIFICATION_TOKEN",
-      "allow_from": [],
-      "group_trigger": {
-        "mention_only": true
-      },
+      "type": "feishu",
+      "allow_from": [
+        "YOUR_USER_ID"
+      ],
+      "reasoning_channel_id": "",
+      "group_trigger": {},
+      "typing": {},
       "placeholder": {
-        "enabled": true,
-        "text": "Thinking..."
+        "enabled": false
       },
-      "random_reaction_emoji": [],
-      "reasoning_channel_id": ""
+      "settings": {
+        "app_id": "YOUR_APP_ID",
+        "random_reaction_emoji": null,
+        "is_lark": false
+      }
     }
   }
 }
 ```
 
+Edit `~/.picoclaw/.security.yml`:
+
+```yaml
+feishu:
+  settings:
+    app_secret: "YOUR_APP_SECRET"
+    encrypt_key: "YOUR_ENCRYPT_KEY"
+    verification_token: "YOUR_VERIFICATION_TOKEN"
+```
+
 ### 6. Publish the App
 
 1. Go to **Version Management & Release**

diff --git a/docs/channels/telegram.md b/docs/channels/telegram.md
@@ -22,13 +22,36 @@ Telegram is the **recommended** channel. It's easy to set up and supports voice
 
 ### 3. Configure
 
+#### 1. WebUI Configuration
+
+We recommend using the WebUI first because it is faster and more convenient.
+
+![WebUI Telegram Connection Interface](/img/channels/webui_telegram.png)
+
+Fill in the Bot Token (`YOUR_BOT_TOKEN`) and Allowed Sources (`YOUR_USER_ID`) in order, then click **Save**.
+
+#### 2. Configuration Files
+
+Edit `~/.picoclaw/.security.yml`:
+
+```yaml
+telegram:
+  settings:
+    token: YOUR_BOT_TOKEN
+```
+
+Edit `~/.picoclaw/config.json`:
+
 ```json
 {
   "channels": {
     "telegram": {
       "enabled": true,
-      "token": "YOUR_BOT_TOKEN",
-      "allow_from": ["YOUR_USER_ID"]
+      "allow_from": [
+        "YOUR_USER_ID"
+      ],
+      "reasoning_channel_id": "",
+      "group_trigger": {}
     }
   }
 }

diff --git a/docs/providers/anthropic.md b/docs/providers/anthropic.md
@@ -0,0 +1,101 @@
+---
+id: anthropic-api
+title: Claude(Anthropic) API
+---
+
+# Claude (Anthropic) API Configuration Guide
+
+## Overview
+
+**Claude (Anthropic)** uses a **pay-as-you-go** pricing model. Access is provided through an official Anthropic API key, and charges are based on actual token usage.
+
+> ⚠️ **Important notes**
+>
+> - Claude **subscription plans** (Pro / Max / Team / Enterprise) and the **API** are **completely separate** products. Subscriptions work only on claude.ai web, desktop, and mobile apps. They **do not include API access** and cannot be used in developer tools like PicoClaw.
+> - The native Anthropic API uses the `/v1/messages` format, **not** the OpenAI-compatible `/v1/chat/completions` format. Using OpenAI compatibility mode disables key features such as Prompt Caching, Extended Thinking, and PDF processing.
+> - Using an OAuth token from a subscription account to call Claude in third-party tools **violates Anthropic's Terms of Service**. Anthropic officially blocked this path in April 2026, so do not attempt it.
+
+Official docs: https://docs.anthropic.com/en/api/getting-started
+
+
+
+![image-20260409215655752](/img/providers/Claude(Anthropic)1.png)
+
+## Get API Key
+
+1. Visit the [Anthropic Console](https://console.anthropic.com/), sign up, and log in.
+2. Open the **API Keys** page in the left navigation and click **Create Key** to generate an API key.
+3. On the **Billing** page, add a payment method and top up your balance. API usage is deducted from that balance based on actual token consumption.
+
+![image-20260409215733096](/img/providers/Claude(Anthropic)2.png)
+
+### Pricing
+
+Anthropic API billing is usage-based. There is no monthly fee, and you are charged only for the tokens you consume. Reference rates below may change over time:
+
+|       Model       | Input (per million tokens) | Output (per million tokens) |
+| :---------------: | :------------------------: | :-------------------------: |
+| claude-sonnet-4.7 |         \$3         |         \$15         |
+|  claude-opus-4.7  |         \$15        |         \$75         |
+| claude-haiku-4.7  |        \$0.25        |          \$1.25         |
+
+Latest pricing always follows Anthropic's official pricing page.
+
+### Supported Models
+
+|           Model            |                         Description                          |
+| :------------------------: | :----------------------------------------------------------: |
+|     claude-sonnet-4.7      | Recommended; balanced performance and cost, excellent long context |
+|      claude-opus-4.7       |      High-end model for complex reasoning and large context      |
+|      claude-haiku-4.7      |             Lightweight, fast response, lower cost             |
+| claude-3-5-sonnet-20241022 |          Classic stable version with broad compatibility          |
+> For daily coding, prefer **claude-sonnet-4.7** and switch to Opus only for more complex tasks.
+## Configure PicoClaw
+
+### Web UI Configuration
+
+Open PicoClaw WebUI, go to **Models** in the left sidebar, and click **Add Model** in the top-right corner.
+
+![image-20260409221239555](/img/providers/Claude(Anthropic)3.png)
+|    Field     |                     Value to enter                     |
+| :----------: | :----------------------------------------------------: |
+| Model Alias  |              Custom name, for example `anthropic`              |
+|   Model ID   | anthropic/claude-sonnet-4.7 (or another supported model) |
+|   API Key    |         API key generated in Anthropic Console         |
+| API Base URL |              https://api.anthropic.com/v1              |
+### Edit Config Files
+
+`config.json`:
+
+```json
+{
+  "version": 2,
+  "model_list": [
+    {
+      "model_name": "claude-sonnet-4.7",
+      "model": "anthropic/claude-sonnet-4.7",
+      "api_base": "https://api.anthropic.com/v1"
+    }
+  ],
+  "agents": {
+    "defaults": {
+      "model_name": "claude-sonnet-4.7"
+    }
+  }
+}
+```
+
+`~/.picoclaw/.security.yml`:
+
+```yaml
+model_list:
+  claude-sonnet-4.7:0:
+    api_keys:
+      - "your-anthropic-api-key"
+```
+## Notes
+
+- Pay-as-you-go costs scale directly with usage. For frequent or long-context tasks, set usage alerts on the Console billing page.
+- Claude Opus is significantly more expensive than Sonnet, so avoid long-running Opus usage unless needed.
+- Subscription plans and API balances are separate and non-transferable. Balance added in Console is for API calls only and is unrelated to claude.ai subscriptions.
+