mirror of
https://github.com/sipeed/picoclaw.git
synced 2026-06-12 18:08:54 +00:00
docs: fix inaccuracies, add translations, and expand channel docs (#1837)
## Config field fixes (cross-verified against Go source) - MaixCam: server_address → host + port - IRC: use_tls → tls, channels_to_join → channels (all 6 languages) - WeCom AI Bot: callback port 18791 → 18790 - credential_encryption: base_url → api_base, add required model field, remove incorrect passphrase-only mode docs - providers.md: agents.defaults.model → model_name (×4), remove non-existent session.backlog_limit - migration guide, troubleshooting: agents.defaults.model → model_name - ANTIGRAVITY_AUTH: fix file path, Go 1.21 → 1.25, model → model_name - spawn-tasks: fix truncated file, add Heartbeat introduction - tools_configuration: add Tavily/SearXNG/GLMSearch, exec allow_remote/ timeout_seconds/custom_allow_patterns, cron allow_command, skills github/search_cache, clawhub timeout/max_zip_size/max_response_size - configuration: fix builtin skills path (build-time embedded, not cwd), HEARTBEAT.md marked auto-generated ## Broken link fixes (15 total) - chat-apps.md: WeCom/Matrix links with wrong relative paths - providers.md: migration link with extra docs/ prefix - hardware-compatibility.md: README links with wrong depth (all 5 langs) - chat-apps.md: WhatsApp dead links → anchor links (zh/ja) ## Getting-started accuracy - README (all 6 langs): add picoclaw.io as recommended download, add missing picoclaw model CLI command - docker.md: clarify first-run trigger condition (all 6 langs) - configuration.md: fix builtin skills path description (all 6 langs) ## QQ channel - Add quick setup via q.qq.com/qqbot/openclaw (one-click bot creation) - Add manual setup as fallback (all 6 languages) ## Feishu channel - Update setup flow: WebSocket/SDK mode, no webhook URL needed - Preserve Lark international domain note (all 6 languages) ## chat-apps.md - Add Feishu, Slack, IRC, OneBot detail sections (all 6 languages) - Add MaixCam section to ja/fr/pt-br/vi - Fix all channel doc links to point to correct language version ## New translations (25 files, 5 docs × 5 languages) debug.md, credential_encryption.md, hardware-compatibility.md, ANTIGRAVITY_AUTH.md, ANTIGRAVITY_USAGE.md → zh/ja/fr/pt-br/vi ## Channel docs (6 languages each, 60 new files) telegram, discord, qq, feishu, maixcam, dingtalk, line, slack, onebot, wecom/wecom_aibot, wecom/wecom_app, wecom/wecom_bot Co-authored-by: BeaconCat <BeaconCat@users.noreply.github.com>
This commit is contained in:
@@ -0,0 +1,33 @@
|
||||
> Retour au [README](../../../README.fr.md)
|
||||
|
||||
# OneBot
|
||||
|
||||
OneBot est un standard de protocole ouvert pour les bots QQ, fournissant une interface unifiée pour diverses implémentations de bots QQ (par exemple go-cqhttp, Mirai). Il utilise WebSocket pour la communication.
|
||||
|
||||
## Configuration
|
||||
|
||||
```json
|
||||
{
|
||||
"channels": {
|
||||
"onebot": {
|
||||
"enabled": true,
|
||||
"ws_url": "ws://localhost:8080",
|
||||
"access_token": "",
|
||||
"allow_from": []
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
| Champ | Type | Requis | Description |
|
||||
| ------------ | ------ | ------ | -------------------------------------------------------------------- |
|
||||
| enabled | bool | Oui | Activer ou non le canal OneBot |
|
||||
| ws_url | string | Oui | URL WebSocket du serveur OneBot |
|
||||
| access_token | string | Non | Jeton d'accès pour la connexion au serveur OneBot |
|
||||
| allow_from | array | Non | Liste blanche d'ID utilisateurs ; vide signifie tous les utilisateurs |
|
||||
|
||||
## Procédure de configuration
|
||||
|
||||
1. Déployez une implémentation compatible OneBot (par exemple napcat)
|
||||
2. Configurez l'implémentation OneBot pour activer le service WebSocket et définir un jeton d'accès (si nécessaire)
|
||||
3. Renseignez l'URL WebSocket et le jeton d'accès dans le fichier de configuration
|
||||
@@ -0,0 +1,33 @@
|
||||
> [README](../../../README.ja.md) に戻る
|
||||
|
||||
# OneBot
|
||||
|
||||
OneBot は QQ ボット向けのオープンプロトコル標準で、複数の QQ ボット実装(例: go-cqhttp、Mirai)に統一されたインターフェースを提供します。通信には WebSocket を使用します。
|
||||
|
||||
## 設定
|
||||
|
||||
```json
|
||||
{
|
||||
"channels": {
|
||||
"onebot": {
|
||||
"enabled": true,
|
||||
"ws_url": "ws://localhost:8080",
|
||||
"access_token": "",
|
||||
"allow_from": []
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
| フィールド | 型 | 必須 | 説明 |
|
||||
| ------------ | ------ | ------ | ---------------------------------------------------------------- |
|
||||
| enabled | bool | はい | OneBot チャンネルを有効にするかどうか |
|
||||
| ws_url | string | はい | OneBot サーバーの WebSocket URL |
|
||||
| access_token | string | いいえ | OneBot サーバーへの接続に使用するアクセストークン |
|
||||
| allow_from | array | いいえ | ユーザーIDのホワイトリスト。空の場合は全ユーザーを許可 |
|
||||
|
||||
## セットアップ手順
|
||||
|
||||
1. OneBot 互換の実装(例: napcat)をデプロイする
|
||||
2. OneBot 実装で WebSocket サービスを有効にし、アクセストークンを設定する(必要な場合)
|
||||
3. WebSocket URL とアクセストークンを設定ファイルに入力する
|
||||
@@ -0,0 +1,33 @@
|
||||
> Back to [README](../../../README.md)
|
||||
|
||||
# OneBot
|
||||
|
||||
OneBot is an open protocol standard for QQ bots, providing a unified interface for various QQ bot implementations (e.g. go-cqhttp, Mirai). It uses WebSocket for communication.
|
||||
|
||||
## Configuration
|
||||
|
||||
```json
|
||||
{
|
||||
"channels": {
|
||||
"onebot": {
|
||||
"enabled": true,
|
||||
"ws_url": "ws://localhost:8080",
|
||||
"access_token": "",
|
||||
"allow_from": []
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
| Field | Type | Required | Description |
|
||||
| ------------ | ------ | -------- | ---------------------------------------------------------------- |
|
||||
| enabled | bool | Yes | Whether to enable the OneBot channel |
|
||||
| ws_url | string | Yes | WebSocket URL of the OneBot server |
|
||||
| access_token | string | No | Access token for connecting to the OneBot server |
|
||||
| allow_from | array | No | User ID whitelist; empty means all users are allowed |
|
||||
|
||||
## Setup
|
||||
|
||||
1. Deploy a OneBot-compatible implementation (e.g. napcat)
|
||||
2. Configure the OneBot implementation to enable the WebSocket service and set an access token (if needed)
|
||||
3. Fill in the WebSocket URL and access token in the configuration file
|
||||
@@ -0,0 +1,33 @@
|
||||
> Voltar ao [README](../../../README.pt-br.md)
|
||||
|
||||
# OneBot
|
||||
|
||||
OneBot é um padrão de protocolo aberto para bots QQ, fornecendo uma interface unificada para diversas implementações de bots QQ (ex.: go-cqhttp, Mirai). Utiliza WebSocket para comunicação.
|
||||
|
||||
## Configuração
|
||||
|
||||
```json
|
||||
{
|
||||
"channels": {
|
||||
"onebot": {
|
||||
"enabled": true,
|
||||
"ws_url": "ws://localhost:8080",
|
||||
"access_token": "",
|
||||
"allow_from": []
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
| Campo | Tipo | Obrigatório | Descrição |
|
||||
| ------------ | ------ | ----------- | -------------------------------------------------------------------- |
|
||||
| enabled | bool | Sim | Se o canal OneBot deve ser habilitado |
|
||||
| ws_url | string | Sim | URL WebSocket do servidor OneBot |
|
||||
| access_token | string | Não | Token de acesso para conexão ao servidor OneBot |
|
||||
| allow_from | array | Não | Lista de permissão de IDs de usuário; vazio permite todos |
|
||||
|
||||
## Configuração passo a passo
|
||||
|
||||
1. Implante uma implementação compatível com OneBot (ex.: napcat)
|
||||
2. Configure a implementação OneBot para habilitar o serviço WebSocket e definir um token de acesso (se necessário)
|
||||
3. Preencha a URL WebSocket e o token de acesso no arquivo de configuração
|
||||
@@ -0,0 +1,33 @@
|
||||
> Quay lại [README](../../../README.vi.md)
|
||||
|
||||
# OneBot
|
||||
|
||||
OneBot là tiêu chuẩn giao thức mở dành cho bot QQ, cung cấp giao diện thống nhất cho nhiều triển khai bot QQ khác nhau (ví dụ: go-cqhttp, Mirai). Nó sử dụng WebSocket để giao tiếp.
|
||||
|
||||
## Cấu hình
|
||||
|
||||
```json
|
||||
{
|
||||
"channels": {
|
||||
"onebot": {
|
||||
"enabled": true,
|
||||
"ws_url": "ws://localhost:8080",
|
||||
"access_token": "",
|
||||
"allow_from": []
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
| Trường | Kiểu | Bắt buộc | Mô tả |
|
||||
| ------------ | ------ | -------- | -------------------------------------------------------------------- |
|
||||
| enabled | bool | Có | Có bật kênh OneBot hay không |
|
||||
| ws_url | string | Có | URL WebSocket của máy chủ OneBot |
|
||||
| access_token | string | Không | Token truy cập để kết nối với máy chủ OneBot |
|
||||
| allow_from | array | Không | Danh sách trắng ID người dùng; để trống cho phép tất cả |
|
||||
|
||||
## Quy trình thiết lập
|
||||
|
||||
1. Triển khai một bản triển khai tương thích OneBot (ví dụ: napcat)
|
||||
2. Cấu hình bản triển khai OneBot để bật dịch vụ WebSocket và đặt token truy cập (nếu cần)
|
||||
3. Điền URL WebSocket và token truy cập vào file cấu hình
|
||||
@@ -1,3 +1,5 @@
|
||||
> 返回 [README](../../../README.zh.md)
|
||||
|
||||
# OneBot
|
||||
|
||||
OneBot 是一个面向 QQ 机器人的开放协议标准,为多种 QQ 机器人实现(例如 go-cqhttp、Mirai)提供了统一的接口。它使用 WebSocket 进行通信。
|
||||
|
||||
Reference in New Issue
Block a user