refactor(docs): reorganize docs by type and locale

This commit is contained in:
wenjie
2026-04-17 11:41:36 +08:00
parent 0da962c4b4
commit 4e1ceee62e
168 changed files with 759 additions and 720 deletions
+21
View File
@@ -0,0 +1,21 @@
# PicoClaw Documentation
Documentation is organized by document type first and language second.
## Sections
- `project/`: project-level translated entry documents
- `guides/`: setup and usage guides
- `reference/`: reference material and configuration details
- `operations/`: debugging and troubleshooting
- `security/`: security-related documentation
- `architecture/`: architecture and internal design notes
- `channels/`: channel-specific integration guides
- `design/`: design proposals and investigations
- `migration/`: migration notes
## Language Naming
- English documents use the base filename, for example `configuration.md`
- Translations use `.<locale>.md`, for example `configuration.zh.md`
- Code-adjacent translated READMEs follow the same convention
+1 -1
View File
@@ -1,4 +1,4 @@
> Retour au [README](../../../README.fr.md)
> Retour au [README](../../project/README.fr.md)
# DingTalk
+1 -1
View File
@@ -1,4 +1,4 @@
> [README](../../../README.ja.md) に戻る
> [README](../../project/README.ja.md) に戻る
# DingTalk
+1 -1
View File
@@ -1,4 +1,4 @@
> Voltar ao [README](../../../README.pt-br.md)
> Voltar ao [README](../../project/README.pt-br.md)
# DingTalk
+1 -1
View File
@@ -1,4 +1,4 @@
> Quay lại [README](../../../README.vi.md)
> Quay lại [README](../../project/README.vi.md)
# DingTalk
+1 -1
View File
@@ -1,4 +1,4 @@
> 返回 [README](../../../README.zh.md)
> 返回 [README](../../project/README.zh.md)
# 钉钉
+1 -1
View File
@@ -1,4 +1,4 @@
> Retour au [README](../../../README.fr.md)
> Retour au [README](../../project/README.fr.md)
# Discord
+1 -1
View File
@@ -1,4 +1,4 @@
> [README](../../../README.ja.md) に戻る
> [README](../../project/README.ja.md) に戻る
# Discord
+1 -1
View File
@@ -1,4 +1,4 @@
> Voltar ao [README](../../../README.pt-br.md)
> Voltar ao [README](../../project/README.pt-br.md)
# Discord
+1 -1
View File
@@ -1,4 +1,4 @@
> Quay lại [README](../../../README.vi.md)
> Quay lại [README](../../project/README.vi.md)
# Discord
+1 -1
View File
@@ -1,4 +1,4 @@
> 返回 [README](../../../README.zh.md)
> 返回 [README](../../project/README.zh.md)
# Discord
+1 -1
View File
@@ -1,4 +1,4 @@
> Retour au [README](../../../README.fr.md)
> Retour au [README](../../project/README.fr.md)
# Feishu
+1 -1
View File
@@ -1,4 +1,4 @@
> [README](../../../README.ja.md) に戻る
> [README](../../project/README.ja.md) に戻る
# 飛書(Feishu
+1 -1
View File
@@ -1,4 +1,4 @@
> Voltar ao [README](../../../README.pt-br.md)
> Voltar ao [README](../../project/README.pt-br.md)
# Feishu
+1 -1
View File
@@ -1,4 +1,4 @@
> Quay lại [README](../../../README.vi.md)
> Quay lại [README](../../project/README.vi.md)
# Feishu
+1 -1
View File
@@ -1,4 +1,4 @@
> 返回 [README](../../../README.zh.md)
> 返回 [README](../../project/README.zh.md)
# 飞书
+1 -1
View File
@@ -1,4 +1,4 @@
> Retour au [README](../../../README.fr.md)
> Retour au [README](../../project/README.fr.md)
# Line
+1 -1
View File
@@ -1,4 +1,4 @@
> [README](../../../README.ja.md) に戻る
> [README](../../project/README.ja.md) に戻る
# Line
+1 -1
View File
@@ -1,4 +1,4 @@
> Voltar ao [README](../../../README.pt-br.md)
> Voltar ao [README](../../project/README.pt-br.md)
# Line
+1 -1
View File
@@ -1,4 +1,4 @@
> Quay lại [README](../../../README.vi.md)
> Quay lại [README](../../project/README.vi.md)
# Line
+1 -1
View File
@@ -1,4 +1,4 @@
> 返回 [README](../../../README.zh.md)
> 返回 [README](../../project/README.zh.md)
# Line
+1 -1
View File
@@ -1,4 +1,4 @@
> Retour au [README](../../../README.fr.md)
> Retour au [README](../../project/README.fr.md)
# MaixCam
+1 -1
View File
@@ -1,4 +1,4 @@
> [README](../../../README.ja.md) に戻る
> [README](../../project/README.ja.md) に戻る
# MaixCam
+1 -1
View File
@@ -1,4 +1,4 @@
> Voltar ao [README](../../../README.pt-br.md)
> Voltar ao [README](../../project/README.pt-br.md)
# MaixCam
+1 -1
View File
@@ -1,4 +1,4 @@
> Quay lại [README](../../../README.vi.md)
> Quay lại [README](../../project/README.vi.md)
# MaixCam
+1 -1
View File
@@ -1,4 +1,4 @@
> 返回 [README](../../../README.zh.md)
> 返回 [README](../../project/README.zh.md)
# MaixCam
+1 -1
View File
@@ -1,4 +1,4 @@
> Retour au [README](../../../README.fr.md)
> Retour au [README](../../project/README.fr.md)
# Guide de configuration du canal Matrix
+1 -1
View File
@@ -1,4 +1,4 @@
> [README](../../../README.ja.md) に戻る
> [README](../../project/README.ja.md) に戻る
# Matrix チャンネル設定ガイド
+1 -1
View File
@@ -1,4 +1,4 @@
> Voltar ao [README](../../../README.pt-br.md)
> Voltar ao [README](../../project/README.pt-br.md)
# Guia de Configuração do Canal Matrix
+1 -1
View File
@@ -1,4 +1,4 @@
> Quay lại [README](../../../README.vi.md)
> Quay lại [README](../../project/README.vi.md)
# Hướng dẫn Cấu hình Kênh Matrix
+1 -1
View File
@@ -1,4 +1,4 @@
> 返回 [README](../../../README.zh.md)
> 返回 [README](../../project/README.zh.md)
# Matrix 通道配置指南
+1 -1
View File
@@ -1,4 +1,4 @@
> Retour au [README](../../../README.fr.md)
> Retour au [README](../../project/README.fr.md)
# OneBot
+1 -1
View File
@@ -1,4 +1,4 @@
> [README](../../../README.ja.md) に戻る
> [README](../../project/README.ja.md) に戻る
# OneBot
+1 -1
View File
@@ -1,4 +1,4 @@
> Voltar ao [README](../../../README.pt-br.md)
> Voltar ao [README](../../project/README.pt-br.md)
# OneBot
+1 -1
View File
@@ -1,4 +1,4 @@
> Quay lại [README](../../../README.vi.md)
> Quay lại [README](../../project/README.vi.md)
# OneBot
+1 -1
View File
@@ -1,4 +1,4 @@
> 返回 [README](../../../README.zh.md)
> 返回 [README](../../project/README.zh.md)
# OneBot
+1 -1
View File
@@ -1,4 +1,4 @@
> Retour au [README](../../../README.fr.md)
> Retour au [README](../../project/README.fr.md)
# QQ
+1 -1
View File
@@ -1,4 +1,4 @@
> [README](../../../README.ja.md) に戻る
> [README](../../project/README.ja.md) に戻る
# QQ
+1 -1
View File
@@ -1,4 +1,4 @@
> Voltar ao [README](../../../README.pt-br.md)
> Voltar ao [README](../../project/README.pt-br.md)
# QQ
+1 -1
View File
@@ -1,4 +1,4 @@
> Quay lại [README](../../../README.vi.md)
> Quay lại [README](../../project/README.vi.md)
# QQ
+1 -1
View File
@@ -1,4 +1,4 @@
> 返回 [README](../../../README.zh.md)
> 返回 [README](../../project/README.zh.md)
# QQ
+1 -1
View File
@@ -1,4 +1,4 @@
> Retour au [README](../../../README.fr.md)
> Retour au [README](../../project/README.fr.md)
# Slack
+1 -1
View File
@@ -1,4 +1,4 @@
> [README](../../../README.ja.md) に戻る
> [README](../../project/README.ja.md) に戻る
# Slack
+1 -1
View File
@@ -1,4 +1,4 @@
> Voltar ao [README](../../../README.pt-br.md)
> Voltar ao [README](../../project/README.pt-br.md)
# Slack
+1 -1
View File
@@ -1,4 +1,4 @@
> Quay lại [README](../../../README.vi.md)
> Quay lại [README](../../project/README.vi.md)
# Slack
+1 -1
View File
@@ -1,4 +1,4 @@
> 返回 [README](../../../README.zh.md)
> 返回 [README](../../project/README.zh.md)
# Slack
+1 -1
View File
@@ -1,4 +1,4 @@
> Retour au [README](../../../README.fr.md)
> Retour au [README](../../project/README.fr.md)
# Telegram
+1 -1
View File
@@ -1,4 +1,4 @@
> [README](../../../README.ja.md) に戻る
> [README](../../project/README.ja.md) に戻る
# Telegram
+1 -1
View File
@@ -2,7 +2,7 @@
# Telegram
The Telegram channel uses long polling via the Telegram Bot API for bot-based communication. It supports text messages, media attachments (photos, voice, audio, documents), voice transcription ([setup](../../providers.md#voice-transcription)), and built-in command handling.
The Telegram channel uses long polling via the Telegram Bot API for bot-based communication. It supports text messages, media attachments (photos, voice, audio, documents), voice transcription ([setup](../../guides/providers.md#voice-transcription)), and built-in command handling.
## Configuration
+1 -1
View File
@@ -1,4 +1,4 @@
> Voltar ao [README](../../../README.pt-br.md)
> Voltar ao [README](../../project/README.pt-br.md)
# Telegram
+1 -1
View File
@@ -1,4 +1,4 @@
> Quay lại [README](../../../README.vi.md)
> Quay lại [README](../../project/README.vi.md)
# Telegram
+2 -2
View File
@@ -1,8 +1,8 @@
> 返回 [README](../../../README.zh.md)
> 返回 [README](../../project/README.zh.md)
# Telegram
Telegram Channel 通过 Telegram 机器人 API 使用长轮询实现基于机器人的通信。它支持文本消息、媒体附件(照片、语音、音频、文档)、语音转录(配置见[提供商与模型配置](../../zh/providers.md#语音转录)),以及内置命令处理器。
Telegram Channel 通过 Telegram 机器人 API 使用长轮询实现基于机器人的通信。它支持文本消息、媒体附件(照片、语音、音频、文档)、语音转录(配置见[提供商与模型配置](../../guides/providers.zh.md#语音转录)),以及内置命令处理器。
## 配置
+1 -1
View File
@@ -101,7 +101,7 @@ The VK channel supports both voice message reception and text-to-speech capabili
- **ASR (Automatic Speech Recognition)**: Voice messages can be transcribed to text using configured voice models
- **TTS (Text-to-Speech)**: Text responses can be converted to voice messages
To enable voice transcription, configure a voice model in your providers setup. See [Voice Transcription](../../providers.md#voice-transcription) for details.
To enable voice transcription, configure a voice model in your providers setup. See [Voice Transcription](../../guides/providers.md#voice-transcription) for details.
### Group Chat Support
+1 -1
View File
@@ -1,4 +1,4 @@
> Retour au [README](../../../README.fr.md)
> Retour au [README](../../project/README.fr.md)
# WeCom
+1 -1
View File
@@ -1,4 +1,4 @@
> [README](../../../README.ja.md) に戻る
> [README](../../project/README.ja.md) に戻る
# WeCom
+1 -1
View File
@@ -1,4 +1,4 @@
> Voltar ao [README](../../../README.pt-br.md)
> Voltar ao [README](../../project/README.pt-br.md)
# WeCom
+1 -1
View File
@@ -1,4 +1,4 @@
> Quay lại [README](../../../README.vi.md)
> Quay lại [README](../../project/README.vi.md)
# WeCom
+1 -1
View File
@@ -1,4 +1,4 @@
> 返回 [README](../../../README.zh.md)
> 返回 [README](../../project/README.zh.md)
# 企业微信(WeCom
@@ -1,4 +1,4 @@
> Retour au [README](../../README.fr.md)
> Retour au [README](../project/README.fr.md)
# Utiliser le fournisseur Antigravity dans PicoClaw
@@ -1,4 +1,4 @@
> [README](../../README.ja.md) に戻る
> [README](../project/README.ja.md) に戻る
# PicoClaw で Antigravity プロバイダーを使用する
@@ -1,4 +1,4 @@
> Voltar ao [README](../../README.pt-br.md)
> Voltar ao [README](../project/README.pt-br.md)
# Usando o provedor Antigravity no PicoClaw
@@ -1,4 +1,4 @@
> Quay lại [README](../../README.vi.md)
> Quay lại [README](../project/README.vi.md)
# Sử dụng nhà cung cấp Antigravity trong PicoClaw
@@ -1,4 +1,4 @@
> 返回 [README](../../README.zh.md)
> 返回 [README](../project/README.zh.md)
# 在 PicoClaw 中使用 Antigravity 提供商
@@ -1,6 +1,6 @@
# 💬 Configuration des Applications de Chat
> Retour au [README](../../README.fr.md)
> Retour au [README](../project/README.fr.md)
## 💬 Applications de Chat
@@ -19,7 +19,7 @@ Communiquez avec votre PicoClaw via Telegram, Discord, WhatsApp, Matrix, QQ, Din
| **QQ** | ⭐⭐ Moyen | API bot officielle, communauté chinoise | [Documentation](../channels/qq/README.fr.md) |
| **DingTalk** | ⭐⭐ Moyen | Mode Stream (pas d'IP publique requise), entreprise | [Documentation](../channels/dingtalk/README.fr.md) |
| **LINE** | ⭐⭐⭐ Avancé | HTTPS Webhook requis | [Documentation](../channels/line/README.fr.md) |
| **WeCom (企业微信)** | ⭐⭐⭐ Avancé | Bot groupe (Webhook), app personnalisée (API), AI Bot | [Bot](../channels/wecom/wecom_bot/README.fr.md) / [App](../channels/wecom/wecom_app/README.fr.md) / [AI Bot](../channels/wecom/wecom_aibot/README.fr.md) |
| **WeCom (企业微信)** | ⭐⭐⭐ Avancé | Bot groupe (Webhook), app personnalisée (API), AI Bot | [Guide](../channels/wecom/README.fr.md) |
| **Feishu (飞书)** | ⭐⭐⭐ Avancé | Collaboration entreprise, fonctionnalités riches | [Documentation](../channels/feishu/README.fr.md) |
| **IRC** | ⭐⭐ Moyen | Serveur + configuration TLS | [Documentation](#irc) |
| **OneBot** | ⭐⭐ Moyen | Compatible NapCat/Go-CQHTTP, écosystème communautaire | [Documentation](../channels/onebot/README.fr.md) |
@@ -391,7 +391,7 @@ PicoClaw prend en charge trois types d'intégration WeCom :
**Option 2 : WeCom App (Application personnalisée)** - Plus de fonctionnalités, messagerie proactive, chat privé uniquement
**Option 3 : WeCom AI Bot (Bot IA)** - Bot IA officiel, réponses en streaming, prend en charge les discussions de groupe et privées
Voir le [Guide de Configuration WeCom AI Bot](../channels/wecom/wecom_aibot/README.fr.md) pour les instructions détaillées.
Voir le [Guide de Configuration WeCom](../channels/wecom/README.fr.md) pour les instructions détaillées.
**Configuration rapide - WeCom Bot :**
@@ -1,6 +1,6 @@
# 💬 チャットアプリ設定
> [README](../../README.ja.md) に戻る
> [README](../project/README.ja.md) に戻る
## 💬 チャットアプリ連携
@@ -21,7 +21,7 @@ PicoClaw は複数のチャットプラットフォームをサポートして
| **QQ** | ⭐⭐ 中程度 | 公式ボット API、中国コミュニティ向け | [ドキュメント](../channels/qq/README.ja.md) |
| **DingTalk** | ⭐⭐ 中程度 | Stream モード(公開 IP 不要)、企業向け | [ドキュメント](../channels/dingtalk/README.ja.md) |
| **LINE** | ⭐⭐⭐ やや難 | HTTPS Webhook が必要 | [ドキュメント](../channels/line/README.ja.md) |
| **WeCom (企業微信)** | ⭐⭐⭐ やや難 | グループ Bot (Webhook)、カスタムアプリ (API)、AI Bot 対応 | [Bot](../channels/wecom/wecom_bot/README.ja.md) / [App](../channels/wecom/wecom_app/README.ja.md) / [AI Bot](../channels/wecom/wecom_aibot/README.ja.md) |
| **WeCom (企業微信)** | ⭐⭐⭐ やや難 | グループ Bot (Webhook)、カスタムアプリ (API)、AI Bot 対応 | [ガイド](../channels/wecom/README.ja.md) |
| **Feishu (飛書)** | ⭐⭐⭐ やや難 | エンタープライズコラボレーション、機能豊富 | [ドキュメント](../channels/feishu/README.ja.md) |
| **IRC** | ⭐⭐ 中程度 | サーバー + TLS 設定 | [ドキュメント](#irc) |
| **OneBot** | ⭐⭐ 中程度 | NapCat/Go-CQHTTP 互換、コミュニティエコシステム充実 | [ドキュメント](../channels/onebot/README.ja.md) |
@@ -502,7 +502,7 @@ PicoClaw は 3 種類の WeCom 統合をサポートしています:
**方式 2: カスタムアプリ (App)** — より多機能、プロアクティブメッセージング、プライベートチャットのみ
**方式 3: AI Bot** — 公式 AI Bot、ストリーミング返信、グループ・プライベートチャット対応
詳細なセットアップ手順は [WeCom AI Bot 設定ガイド](../channels/wecom/wecom_aibot/README.ja.md) を参照してください。
詳細なセットアップ手順は [WeCom 設定ガイド](../channels/wecom/README.ja.md) を参照してください。
**クイックセットアップ — グループ Bot:**
+14 -14
View File
@@ -10,20 +10,20 @@ Talk to your picoclaw through Telegram, Discord, WhatsApp, Matrix, QQ, DingTalk,
| Channel | Difficulty | Description | Documentation |
| -------------------- | ------------------ | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| **Telegram** | ⭐ Easy | Recommended, voice-to-text, long polling (no public IP needed) | [Docs](channels/telegram/README.md) |
| **Discord** | ⭐ Easy | Socket Mode, group/DM support, rich bot ecosystem | [Docs](channels/discord/README.md) |
| **Telegram** | ⭐ Easy | Recommended, voice-to-text, long polling (no public IP needed) | [Docs](../channels/telegram/README.md) |
| **Discord** | ⭐ Easy | Socket Mode, group/DM support, rich bot ecosystem | [Docs](../channels/discord/README.md) |
| **WhatsApp** | ⭐ Easy | Native (QR scan) or Bridge URL | [Docs](#whatsapp) |
| **Weixin** | ⭐ Easy | Native QR scan (Tencent iLink API) | [Docs](#weixin) |
| **Slack** | ⭐ Easy | **Socket Mode** (no public IP needed), enterprise | [Docs](channels/slack/README.md) |
| **Matrix** | ⭐⭐ Medium | Federated protocol, self-hosting supported | [Docs](channels/matrix/README.md) |
| **QQ** | ⭐⭐ Medium | Official bot API, Chinese community | [Docs](channels/qq/README.md) |
| **DingTalk** | ⭐⭐ Medium | Stream mode (no public IP needed), enterprise | [Docs](channels/dingtalk/README.md) |
| **LINE** | ⭐⭐⭐ Advanced | HTTPS Webhook required | [Docs](channels/line/README.md) |
| **WeCom (企业微信)** | ⭐⭐⭐ Advanced | Official AI Bot over WebSocket, streaming + media | [Docs](channels/wecom/README.md) |
| **Feishu (飞书)** | ⭐⭐⭐ Advanced | Enterprise collaboration, feature-rich | [Docs](channels/feishu/README.md) |
| **Slack** | ⭐ Easy | **Socket Mode** (no public IP needed), enterprise | [Docs](../channels/slack/README.md) |
| **Matrix** | ⭐⭐ Medium | Federated protocol, self-hosting supported | [Docs](../channels/matrix/README.md) |
| **QQ** | ⭐⭐ Medium | Official bot API, Chinese community | [Docs](../channels/qq/README.md) |
| **DingTalk** | ⭐⭐ Medium | Stream mode (no public IP needed), enterprise | [Docs](../channels/dingtalk/README.md) |
| **LINE** | ⭐⭐⭐ Advanced | HTTPS Webhook required | [Docs](../channels/line/README.md) |
| **WeCom (企业微信)** | ⭐⭐⭐ Advanced | Official AI Bot over WebSocket, streaming + media | [Docs](../channels/wecom/README.md) |
| **Feishu (飞书)** | ⭐⭐⭐ Advanced | Enterprise collaboration, feature-rich | [Docs](../channels/feishu/README.md) |
| **IRC** | ⭐⭐ Medium | Server + TLS configuration | [Docs](#irc) |
| **OneBot** | ⭐⭐ Medium | NapCat/Go-CQHTTP compatible, community ecosystem | [Docs](channels/onebot/README.md) |
| **MaixCam** | ⭐ Easy | Hardware integration channel for Sipeed AI cameras | [Docs](channels/maixcam/README.md) |
| **OneBot** | ⭐⭐ Medium | NapCat/Go-CQHTTP compatible, community ecosystem | [Docs](../channels/onebot/README.md) |
| **MaixCam** | ⭐ Easy | Hardware integration channel for Sipeed AI cameras | [Docs](../channels/maixcam/README.md) |
| **Pico** | ⭐ Easy | Native PicoClaw protocol channel | |
<a id="telegram"></a>
@@ -331,7 +331,7 @@ picoclaw gateway
picoclaw gateway
```
For full options (`device_id`, `join_on_invite`, `group_trigger`, `placeholder`, `reasoning_channel_id`), see [Matrix Channel Configuration Guide](channels/matrix/README.md).
For full options (`device_id`, `join_on_invite`, `group_trigger`, `placeholder`, `reasoning_channel_id`), see [Matrix Channel Configuration Guide](../channels/matrix/README.md).
</details>
@@ -392,7 +392,7 @@ picoclaw gateway
PicoClaw now exposes WeCom as a single AI Bot channel over WebSocket.
No public webhook callback URL is required.
See [WeCom Configuration Guide](channels/wecom/README.md) for the full configuration reference and migration notes.
See [WeCom Configuration Guide](../channels/wecom/README.md) for the full configuration reference and migration notes.
**Quick Setup - Recommended**
@@ -472,7 +472,7 @@ picoclaw gateway
Open Feishu, search for your bot name, and start chatting. You can also add the bot to a group — use `group_trigger.mention_only: true` to only respond when @mentioned.
For full options, see [Feishu Channel Configuration Guide](channels/feishu/README.md).
For full options, see [Feishu Channel Configuration Guide](../channels/feishu/README.md).
</details>
@@ -1,6 +1,6 @@
# 💬 Konfigurasi Aplikasi Sembang
> Kembali ke [README](../../README.my.md)
> Kembali ke [README](../project/README.ms.md)
## 💬 Aplikasi Sembang
@@ -279,7 +279,7 @@ picoclaw gateway
picoclaw gateway
```
Untuk pilihan penuh (`device_id`, `join_on_invite`, `group_trigger`, `placeholder`, `reasoning_channel_id`), lihat [Panduan Konfigurasi Saluran Matrix](docs/channels/matrix/README.md).
Untuk pilihan penuh (`device_id`, `join_on_invite`, `group_trigger`, `placeholder`, `reasoning_channel_id`), lihat [Panduan Konfigurasi Saluran Matrix](../channels/matrix/README.md).
</details>
@@ -341,7 +341,7 @@ PicoClaw menyokong tiga jenis integrasi WeCom:
**Pilihan 2: WeCom App (Custom App)** - Lebih banyak ciri, pemesejan proaktif, sembang peribadi sahaja
**Pilihan 3: WeCom AI Bot (AI Bot)** - AI Bot rasmi, balasan streaming, menyokong sembang kumpulan & peribadi
Lihat [Panduan Konfigurasi WeCom AI Bot](docs/channels/wecom/wecom_aibot/README.zh.md) untuk arahan penyediaan terperinci.
Lihat [Panduan Konfigurasi WeCom](../channels/wecom/README.zh.md) untuk arahan penyediaan terperinci.
**Quick Setup - WeCom Bot:**
@@ -1,6 +1,6 @@
# 💬 Configuração de Aplicativos de Chat
> Voltar ao [README](../../README.pt-br.md)
> Voltar ao [README](../project/README.pt-br.md)
## 💬 Aplicativos de Chat
@@ -19,7 +19,7 @@ Converse com seu picoclaw através do Telegram, Discord, WhatsApp, Matrix, QQ, D
| **QQ** | ⭐⭐ Médio | API bot oficial, comunidade chinesa | [Documentação](../channels/qq/README.pt-br.md) |
| **DingTalk** | ⭐⭐ Médio | Modo Stream (sem IP público), empresarial | [Documentação](../channels/dingtalk/README.pt-br.md) |
| **LINE** | ⭐⭐⭐ Avançado | HTTPS Webhook obrigatório | [Documentação](../channels/line/README.pt-br.md) |
| **WeCom (企业微信)** | ⭐⭐⭐ Avançado | Bot de grupo (Webhook), app personalizado (API), AI Bot | [Bot](../channels/wecom/wecom_bot/README.pt-br.md) / [App](../channels/wecom/wecom_app/README.pt-br.md) / [AI Bot](../channels/wecom/wecom_aibot/README.pt-br.md) |
| **WeCom (企业微信)** | ⭐⭐⭐ Avançado | Bot de grupo (Webhook), app personalizado (API), AI Bot | [Guia](../channels/wecom/README.pt-br.md) |
| **Feishu (飞书)** | ⭐⭐⭐ Avançado | Colaboração empresarial, rico em recursos | [Documentação](../channels/feishu/README.pt-br.md) |
| **IRC** | ⭐⭐ Médio | Servidor + configuração TLS | [Documentação](#irc) |
| **OneBot** | ⭐⭐ Médio | Compatível com NapCat/Go-CQHTTP, ecossistema comunitário | [Documentação](../channels/onebot/README.pt-br.md) |
@@ -416,7 +416,7 @@ O PicoClaw suporta três tipos de integração WeCom:
**Opção 2: WeCom App (App Personalizado)** - Mais recursos, mensagens proativas, apenas chat privado
**Opção 3: WeCom AI Bot (AI Bot)** - AI Bot oficial, respostas em streaming, suporta chat de grupo e privado
Veja o [Guia de Configuração do WeCom AI Bot](../channels/wecom/wecom_aibot/README.pt-br.md) para instruções detalhadas de configuração.
Veja o [Guia de Configuração do WeCom](../channels/wecom/README.pt-br.md) para instruções detalhadas de configuração.
**Configuração Rápida - WeCom Bot:**
@@ -1,6 +1,6 @@
# 💬 Cấu Hình Ứng Dụng Chat
> Quay lại [README](../../README.vi.md)
> Quay lại [README](../project/README.vi.md)
## 💬 Ứng Dụng Chat
@@ -19,7 +19,7 @@ Trò chuyện với picoclaw của bạn qua Telegram, Discord, WhatsApp, Matrix
| **QQ** | ⭐⭐ Trung bình | API bot chính thức, cộng đồng Trung Quốc | [Tài liệu](../channels/qq/README.vi.md) |
| **DingTalk** | ⭐⭐ Trung bình | Chế độ Stream (không cần IP công khai), doanh nghiệp | [Tài liệu](../channels/dingtalk/README.vi.md) |
| **LINE** | ⭐⭐⭐ Nâng cao | Yêu cầu HTTPS Webhook | [Tài liệu](../channels/line/README.vi.md) |
| **WeCom (企业微信)** | ⭐⭐⭐ Nâng cao | Bot nhóm (Webhook), ứng dụng tùy chỉnh (API), AI Bot | [Bot](../channels/wecom/wecom_bot/README.vi.md) / [App](../channels/wecom/wecom_app/README.vi.md) / [AI Bot](../channels/wecom/wecom_aibot/README.vi.md) |
| **WeCom (企业微信)** | ⭐⭐⭐ Nâng cao | Bot nhóm (Webhook), ứng dụng tùy chỉnh (API), AI Bot | [Hướng dẫn](../channels/wecom/README.vi.md) |
| **Feishu (飞书)** | ⭐⭐⭐ Nâng cao | Cộng tác doanh nghiệp, nhiều tính năng | [Tài liệu](../channels/feishu/README.vi.md) |
| **IRC** | ⭐⭐ Trung bình | Máy chủ + cấu hình TLS | [Tài liệu](#irc) |
| **OneBot** | ⭐⭐ Trung bình | Tương thích NapCat/Go-CQHTTP, hệ sinh thái cộng đồng | [Tài liệu](../channels/onebot/README.vi.md) |
@@ -416,7 +416,7 @@ PicoClaw hỗ trợ ba loại tích hợp WeCom:
**Tùy chọn 2: WeCom App (App Tùy chỉnh)** - Nhiều tính năng hơn, nhắn tin chủ động, chỉ chat riêng
**Tùy chọn 3: WeCom AI Bot (AI Bot)** - AI Bot chính thức, phản hồi streaming, hỗ trợ chat nhóm & riêng
Xem [Hướng Dẫn Cấu Hình WeCom AI Bot](../channels/wecom/wecom_aibot/README.vi.md) để biết hướng dẫn thiết lập chi tiết.
Xem [Hướng Dẫn Cấu Hình WeCom](../channels/wecom/README.vi.md) để biết hướng dẫn thiết lập chi tiết.
**Thiết Lập Nhanh - WeCom Bot:**
@@ -1,6 +1,6 @@
# 💬 聊天应用配置
> 返回 [README](../../README.zh.md)
> 返回 [README](../project/README.zh.md)
## 💬 聊天应用集成 (Chat Apps)
@@ -1,6 +1,6 @@
# ⚙️ Guide de Configuration
> Retour au [README](../../README.fr.md)
> Retour au [README](../project/README.fr.md)
## ⚙️ Configuration
@@ -393,7 +393,7 @@ Les tâches planifiées persistent après redémarrage dans `~/.picoclaw/workspa
| Sujet | Description |
| ----- | ----------- |
| [Système de Hooks](../hooks/README.md) | Hooks événementiels : observateurs, intercepteurs, hooks d'approbation |
| [Steering](../steering.md) | Injecter des messages dans une boucle agent en cours d'exécution |
| [SubTurn](../subturn.md) | Coordination de subagents, contrôle de concurrence, cycle de vie |
| [Gestion du Contexte](../agent-refactor/context.md) | Détection des limites de contexte, compression |
| [Système de Hooks](../architecture/hooks/README.md) | Hooks événementiels : observateurs, intercepteurs, hooks d'approbation |
| [Steering](../architecture/steering.md) | Injecter des messages dans une boucle agent en cours d'exécution |
| [SubTurn](../architecture/subturn.md) | Coordination de subagents, contrôle de concurrence, cycle de vie |
| [Gestion du Contexte](../architecture/agent-refactor/context.md) | Détection des limites de contexte, compression |
@@ -1,6 +1,6 @@
# ⚙️ 設定ガイド
> [README](../../README.ja.md) に戻る
> [README](../project/README.ja.md) に戻る
## ⚙️ 設定詳細
@@ -394,7 +394,7 @@ PicoClaw は `cron` ツールを通じて cron スタイルのスケジュール
| トピック | 説明 |
| -------- | ---- |
| [Hook システム](../hooks/README.md) | イベント駆動 Hook:オブザーバー、インターセプター、承認 Hook |
| [Steering](../steering.md) | 実行中の Agent ループにメッセージを注入 |
| [SubTurn](../subturn.md) | サブ Agent の調整、並行制御、ライフサイクル |
| [コンテキスト管理](../agent-refactor/context.md) | コンテキスト境界検出、圧縮戦略 |
| [Hook システム](../architecture/hooks/README.md) | イベント駆動 Hook:オブザーバー、インターセプター、承認 Hook |
| [Steering](../architecture/steering.md) | 実行中の Agent ループにメッセージを注入 |
| [SubTurn](../architecture/subturn.md) | サブ Agent の調整、並行制御、ライフサイクル |
| [コンテキスト管理](../architecture/agent-refactor/context.md) | コンテキスト境界検出、圧縮戦略 |
@@ -6,7 +6,7 @@
Config file: `~/.picoclaw/config.json`
> **Security Configuration:** For storing API keys, tokens, and other sensitive data, see the [Security Configuration Guide](security_configuration.md).
> **Security Configuration:** For storing API keys, tokens, and other sensitive data, see the [Security Configuration Guide](../security/security_configuration.md).
### Environment Variables
@@ -555,7 +555,7 @@ chmod 600 ~/.picoclaw/.security.yml
- If a field exists in both files, `.security.yml` value takes precedence
- You can mix direct values in config.json with security values
For complete documentation, see [`security_configuration.md`](security_configuration.md).
For complete documentation, see [`../security/security_configuration.md`](../security/security_configuration.md).
#### All Supported Vendors
@@ -840,7 +840,7 @@ This keeps the runtime lightweight while making new OpenAI-compatible backends m
> **Note**: The `providers` format is deprecated. Use the new `model_list` format with `.security.yml` for better security.
>
> **`max_parallel_turns`**: Controls concurrent processing of messages from different sessions. `1` (default) = sequential; `>1` = parallel. Messages from the same session are always serialized. See [Steering docs](../steering.md) for details.
> **`max_parallel_turns`**: Controls concurrent processing of messages from different sessions. `1` (default) = sequential; `>1` = parallel. Messages from the same session are always serialized. See [Steering docs](../architecture/steering.md) for details.
</details>
@@ -906,9 +906,9 @@ Scheduled tasks persist across restarts and are stored in `~/.picoclaw/workspace
| Topic | Description |
| ----- | ----------- |
| [Security Configuration](security_configuration.md) | Store API keys and secrets in separate `.security.yml` file |
| [Sensitive Data Filtering](sensitive_data_filtering.md) | Filter API keys and tokens from tool results before sending to LLM |
| [Hook System](hooks/README.md) | Event-driven hooks: observers, interceptors, approval hooks |
| [Steering](steering.md) | Inject messages into a running agent loop between tool calls |
| [SubTurn](subturn.md) | Subagent coordination, concurrency control, lifecycle |
| [Context Management](agent-refactor/context.md) | Context boundary detection, proactive budget check, compression |
| [Security Configuration](../security/security_configuration.md) | Store API keys and secrets in separate `.security.yml` file |
| [Sensitive Data Filtering](../security/sensitive_data_filtering.md) | Filter API keys and tokens from tool results before sending to LLM |
| [Hook System](../architecture/hooks/README.md) | Event-driven hooks: observers, interceptors, approval hooks |
| [Steering](../architecture/steering.md) | Inject messages into a running agent loop between tool calls |
| [SubTurn](../architecture/subturn.md) | Subagent coordination, concurrency control, lifecycle |
| [Context Management](../architecture/agent-refactor/context.md) | Context boundary detection, proactive budget check, compression |
@@ -1,6 +1,6 @@
# ⚙️ Panduan Konfigurasi
> Kembali ke [README](../../README.my.md)
> Kembali ke [README](../project/README.ms.md)
## ⚙️ Konfigurasi
@@ -1,6 +1,6 @@
# ⚙️ Guia de Configuração
> Voltar ao [README](../../README.pt-br.md)
> Voltar ao [README](../project/README.pt-br.md)
## ⚙️ Configuração
@@ -394,7 +394,7 @@ As tarefas agendadas persistem após reinicializações em `~/.picoclaw/workspac
| Tópico | Descrição |
| ------ | --------- |
| [Sistema de Hooks](../hooks/README.md) | Hooks orientados a eventos: observadores, interceptores, hooks de aprovação |
| [Steering](../steering.md) | Injetar mensagens em um loop de agente em execução |
| [SubTurn](../subturn.md) | Coordenação de subagentes, controle de concorrência, ciclo de vida |
| [Gerenciamento de Contexto](../agent-refactor/context.md) | Detecção de limites de contexto, compressão |
| [Sistema de Hooks](../architecture/hooks/README.md) | Hooks orientados a eventos: observadores, interceptores, hooks de aprovação |
| [Steering](../architecture/steering.md) | Injetar mensagens em um loop de agente em execução |
| [SubTurn](../architecture/subturn.md) | Coordenação de subagentes, controle de concorrência, ciclo de vida |
| [Gerenciamento de Contexto](../architecture/agent-refactor/context.md) | Detecção de limites de contexto, compressão |
@@ -1,6 +1,6 @@
# ⚙️ Hướng Dẫn Cấu Hình
> Quay lại [README](../../README.vi.md)
> Quay lại [README](../project/README.vi.md)
## ⚙️ Cấu Hình
@@ -394,7 +394,7 @@ Tác vụ đã lên lịch được lưu trữ bền vững sau khi khởi độ
| Chủ đề | Mô tả |
| ------ | ----- |
| [Hệ Thống Hook](../hooks/README.md) | Hook hướng sự kiện: observer, interceptor, approval hook |
| [Steering](../steering.md) | Chèn tin nhắn vào vòng lặp agent đang chạy |
| [SubTurn](../subturn.md) | Điều phối subagent, kiểm soát đồng thời, vòng đời |
| [Quản Lý Ngữ Cảnh](../agent-refactor/context.md) | Phát hiện ranh giới ngữ cảnh, nén |
| [Hệ Thống Hook](../architecture/hooks/README.md) | Hook hướng sự kiện: observer, interceptor, approval hook |
| [Steering](../architecture/steering.md) | Chèn tin nhắn vào vòng lặp agent đang chạy |
| [SubTurn](../architecture/subturn.md) | Điều phối subagent, kiểm soát đồng thời, vòng đời |
| [Quản Lý Ngữ Cảnh](../architecture/agent-refactor/context.md) | Phát hiện ranh giới ngữ cảnh, nén |
@@ -1,6 +1,6 @@
# ⚙️ 配置指南
> 返回 [README](../../README.zh.md)
> 返回 [README](../project/README.zh.md)
## ⚙️ 配置详解
@@ -670,8 +670,8 @@ PicoClaw 通过 `cron` 工具支持 cron 风格的定时任务。Agent 可以设
| 主题 | 说明 |
| ---- | ---- |
| [敏感数据过滤](../sensitive_data_filtering.md) | 在发送给 LLM 前,从工具结果中过滤 API 密钥和令牌 |
| [Hook 系统](../hooks/README.zh.md) | 事件驱动 Hook:观察者、拦截器、审批 Hook |
| [Steering](../steering.md) | 在工具调用间向运行中的 Agent 注入消息 |
| [SubTurn](../subturn.md) | 子 Agent 协调、并发控制、生命周期管理 |
| [上下文管理](../agent-refactor/context.md) | 上下文边界检测、主动预算检查、压缩策略 |
| [敏感数据过滤](../security/sensitive_data_filtering.zh.md) | 在发送给 LLM 前,从工具结果中过滤 API 密钥和令牌 |
| [Hook 系统](../architecture/hooks/README.zh.md) | 事件驱动 Hook:观察者、拦截器、审批 Hook |
| [Steering](../architecture/steering.md) | 在工具调用间向运行中的 Agent 注入消息 |
| [SubTurn](../architecture/subturn.md) | 子 Agent 协调、并发控制、生命周期管理 |
| [上下文管理](../architecture/agent-refactor/context.md) | 上下文边界检测、主动预算检查、压缩策略 |
@@ -1,6 +1,6 @@
# 🐳 Docker et Démarrage Rapide
> Retour au [README](../../README.fr.md)
> Retour au [README](../project/README.fr.md)
## 🐳 Docker Compose
@@ -1,6 +1,6 @@
# 🐳 Docker とクイックスタート
> [README](../../README.ja.md) に戻る
> [README](../project/README.ja.md) に戻る
## 🐳 Docker Compose
@@ -143,7 +143,7 @@ picoclaw onboard
}
```
> **新機能**: `model_list` 設定形式により、コード変更なしで provider を追加できます。詳細は[モデル設定](providers.md#モデル設定-model_list)を参照してください。
> **新機能**: `model_list` 設定形式により、コード変更なしで provider を追加できます。詳細は[モデル設定](providers.ja.md#モデル設定-model_list)を参照してください。
> `request_timeout` はオプションで、単位は秒です。省略または `<= 0` に設定した場合、PicoClaw はデフォルトのタイムアウト(120 秒)を使用します。
**3. API Key の取得**
@@ -1,6 +1,6 @@
# 🐳 Panduan Docker & Quick Start
> Kembali ke [README](../../README.my.md)
> Kembali ke [README](../project/README.ms.md)
## 🐳 Docker Compose
@@ -1,6 +1,6 @@
# 🐳 Docker e Início Rápido
> Voltar ao [README](../../README.pt-br.md)
> Voltar ao [README](../project/README.pt-br.md)
## 🐳 Docker Compose
@@ -1,6 +1,6 @@
# 🐳 Docker và Bắt Đầu Nhanh
> Quay lại [README](../../README.vi.md)
> Quay lại [README](../project/README.vi.md)
## 🐳 Docker Compose
@@ -1,6 +1,6 @@
# 🐳 Docker 与快速开始
> 返回 [README](../../README.zh.md)
> 返回 [README](../project/README.zh.md)
## 🐳 Docker Compose
@@ -143,7 +143,7 @@ picoclaw onboard
}
```
> **新功能**: `model_list` 配置格式支持零代码添加 provider。详见[模型配置](providers.md#模型配置-model_list)章节。
> **新功能**: `model_list` 配置格式支持零代码添加 provider。详见[模型配置](providers.zh.md#模型配置-model_list)章节。
> `request_timeout` 为可选项,单位为秒。若省略或设置为 `<= 0`PicoClaw 使用默认超时(120 秒)。
**3. 获取 API Key**
@@ -1,4 +1,4 @@
> Retour au [README](../../README.fr.md)
> Retour au [README](../project/README.fr.md)
# 🖥️ PicoClaw Liste de compatibilité matérielle
@@ -99,7 +99,7 @@ Produits grand public, routeurs et appareils industriels testés avec PicoClaw.
Tout téléphone Android ARM64 (2015+) avec 1 Go+ de RAM. Installez [Termux](https://github.com/termux/termux-app), utilisez `proot` pour exécuter PicoClaw.
> Voir [README : Exécuter sur d'anciens téléphones Android](../../README.fr.md#-run-on-old-android-phones) pour les instructions de configuration.
> Voir [README : Exécuter sur d'anciens téléphones Android](../project/README.fr.md#-run-on-old-android-phones) pour les instructions de configuration.
### Bureau / Serveur / Cloud
@@ -1,4 +1,4 @@
> [README](../../README.ja.md) に戻る
> [README](../project/README.ja.md) に戻る
# 🖥️ PicoClaw ハードウェア互換性リスト
@@ -99,7 +99,7 @@ PicoClaw でテスト済みのコンシューマー製品、ルーター、産
1GB 以上の RAM を搭載した ARM64 Android スマートフォン(2015年以降)。[Termux](https://github.com/termux/termux-app) をインストールし、`proot` を使用して PicoClaw を実行します。
> セットアップ手順は [README:古い Android スマートフォンで実行](../../README.ja.md#-run-on-old-android-phones) を参照してください。
> セットアップ手順は [README:古い Android スマートフォンで実行](../project/README.ja.md#-run-on-old-android-phones) を参照してください。
### デスクトップ / サーバー / クラウド
@@ -97,7 +97,7 @@ Consumer products, routers, and industrial devices that have been tested with Pi
Any ARM64 Android phone (2015+) with 1GB+ RAM. Install [Termux](https://github.com/termux/termux-app), use `proot` to run PicoClaw.
> See [README: Run on old Android Phones](../README.md#-run-on-old-android-phones) for setup instructions.
> See [README: Run on old Android Phones](../../README.md#-run-on-old-android-phones) for setup instructions.
### Desktop / Server / Cloud
@@ -1,4 +1,4 @@
> Voltar ao [README](../../README.pt-br.md)
> Voltar ao [README](../project/README.pt-br.md)
# 🖥️ PicoClaw Lista de compatibilidade de hardware
@@ -99,7 +99,7 @@ Produtos de consumo, roteadores e dispositivos industriais testados com o PicoCl
Qualquer celular Android ARM64 (2015+) com 1GB+ de RAM. Instale o [Termux](https://github.com/termux/termux-app), use `proot` para rodar o PicoClaw.
> Veja [README: Rodar em celulares Android antigos](../../README.pt-br.md#-run-on-old-android-phones) para instruções de configuração.
> Veja [README: Rodar em celulares Android antigos](../project/README.pt-br.md#-run-on-old-android-phones) para instruções de configuração.
### Desktop / Servidor / Nuvem

Some files were not shown because too many files have changed in this diff Show More