403ceb39be
## 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>
70 lines
2.1 KiB
Markdown
70 lines
2.1 KiB
Markdown
# 🔄 异步任务与 Spawn
|
||
|
||
> 返回 [README](../../README.zh.md)
|
||
|
||
PicoClaw 通过 `spawn` 工具支持**异步任务执行**。主要由 **Heartbeat（心跳）** 系统使用，在不阻塞主 Agent 循环的情况下运行耗时任务。
|
||
|
||
## Heartbeat
|
||
|
||
心跳系统会定期检查 `workspace/HEARTBEAT.md` 中的计划任务。首次运行时会自动生成默认模板，你可以自定义它来定义快速任务（内联处理）和长任务（通过 `spawn` 委派）。
|
||
|
||
**`HEARTBEAT.md` 示例：**
|
||
|
||
```markdown
|
||
## Quick Tasks (respond directly)
|
||
|
||
- Report current time
|
||
|
||
## Long Tasks (use spawn for async)
|
||
|
||
- Search the web for AI news and summarize
|
||
- Check email and report important messages
|
||
```
|
||
|
||
**关键行为：**
|
||
|
||
| 特性 | 描述 |
|
||
| ---------------- | ---------------------------------------- |
|
||
| **spawn** | 创建异步子 Agent，不阻塞主心跳进程 |
|
||
| **独立上下文** | 子 Agent 拥有独立上下文，无会话历史 |
|
||
| **message tool** | 子 Agent 通过 message 工具直接与用户通信 |
|
||
| **非阻塞** | spawn 后，心跳继续处理下一个任务 |
|
||
|
||
#### 子 Agent 通信原理
|
||
|
||
```
|
||
心跳触发 (Heartbeat triggers)
|
||
↓
|
||
Agent 读取 HEARTBEAT.md
|
||
↓
|
||
对于长任务: spawn 子 Agent
|
||
↓ ↓
|
||
继续下一个任务 子 Agent 独立工作
|
||
↓ ↓
|
||
所有任务完成 子 Agent 使用 "message" 工具
|
||
↓ ↓
|
||
响应 HEARTBEAT_OK 用户直接收到结果
|
||
```
|
||
|
||
子 Agent 可以访问工具（message, web_search 等），并且无需通过主 Agent 即可独立与用户通信。
|
||
|
||
**配置：**
|
||
|
||
```json
|
||
{
|
||
"heartbeat": {
|
||
"enabled": true,
|
||
"interval": 30
|
||
}
|
||
}
|
||
```
|
||
|
||
| 选项 | 默认值 | 描述 |
|
||
| ---------- | ------ | ---------------------------- |
|
||
| `enabled` | `true` | 启用/禁用心跳 |
|
||
| `interval` | `30` | 检查间隔，单位分钟 (最小: 5) |
|
||
|
||
**环境变量:**
|
||
|
||
- `PICOCLAW_HEARTBEAT_ENABLED=false` 禁用
|
||
- `PICOCLAW_HEARTBEAT_INTERVAL=60` 更改间隔
|