mirror of https://github.com/sipeed/picoclaw.git synced 2026-06-12 18:08:54 +00:00

Files

T

BeaconCat 403ceb39be 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>

2026-03-20 22:37:05 +08:00

README.fr.md

docs: fix inaccuracies, add translations, and expand channel docs (#1837 )

2026-03-20 22:37:05 +08:00

README.ja.md

docs: fix inaccuracies, add translations, and expand channel docs (#1837 )

2026-03-20 22:37:05 +08:00

README.md

docs: fix inaccuracies, add translations, and expand channel docs (#1837 )

2026-03-20 22:37:05 +08:00

README.pt-br.md

docs: fix inaccuracies, add translations, and expand channel docs (#1837 )

2026-03-20 22:37:05 +08:00

README.vi.md

docs: fix inaccuracies, add translations, and expand channel docs (#1837 )

2026-03-20 22:37:05 +08:00

README.zh.md

docs: fix inaccuracies, add translations, and expand channel docs (#1837 )

2026-03-20 22:37:05 +08:00

README.md

Back to README

Feishu

Feishu (international name: Lark) is an enterprise collaboration platform by ByteDance. It supports both Chinese and global markets through event-driven WebSocket connections.

Configuration

{
  "channels": {
    "feishu": {
      "enabled": true,
      "app_id": "cli_xxx",
      "app_secret": "xxx",
      "encrypt_key": "",
      "verification_token": "",
      "allow_from": []
    }
  }
}

Field	Type	Required	Description
enabled	bool	Yes	Whether to enable the Feishu channel
app_id	string	Yes	App ID of the Feishu application (starts with `cli_`)
app_secret	string	Yes	App Secret of the Feishu application
encrypt_key	string	No	Encryption key for event callbacks
verification_token	string	No	Token used for Webhook event verification
allow_from	array	No	Allowlist of user IDs; empty means all users are allowed
random_reaction_emoji	array	No	List of random reaction emojis; empty uses the default "Pin"

Setup

Go to the Feishu Open Platform and create an application
Enable the Bot capability in the application settings
Create a version and publish the application (configuration takes effect only after publishing)
Obtain the App ID (starts with cli_) and App Secret
Fill in the App ID and App Secret in the PicoClaw configuration file
Run picoclaw gateway to start the service
Search for the bot name in Feishu and start a conversation

PicoClaw connects to Feishu using WebSocket/SDK mode — no public callback address or Webhook URL is required.

encrypt_key and verification_token are optional; enabling event encryption is recommended for production environments.

For custom emoji references, see: Feishu Emoji List