picclaw 入门介绍

PicoClaw: 基于Go语言的超高效 AI 助手

10$硬件 · 10MB内存 · 1秒启动 · 皮皮虾，我们走！

**中文** | [日本語](README.ja.md) | [Português](README.pt-br.md) | [Tiếng Việt](README.vi.md) | [Français](README.fr.md) | [English](README.md)

---

🦐 PicoClaw 是一个受 nanobot 启发的超轻量级个人 AI 助手。它采用 Go 语言 从零重构，经历了一个“自举”过程——即由 AI Agent 自身驱动了整个架构迁移和代码优化。

⚡️ 极致轻量：可在 10 美元 的硬件上运行，内存占用 <10MB。这意味着比 OpenClaw 节省 99% 的内存，比 Mac mini 便宜 98%！

注意：人手有限，中文文档可能略有滞后，请优先查看英文文档。

[!CAUTION] 🚨 SECURITY & OFFICIAL CHANNELS / 安全声明

• 无加密货币 (NO CRYPTO): PicoClaw 没有 发行任何官方代币、Token 或虚拟货币。所有在 pump.fun 或其他交易平台上的相关声称均为 诈骗。
• 官方域名: 唯一的官方网站是 picoclaw.io，公司官网是 sipeed.com。
• 警惕: 许多 .ai/.org/.com/.net/... 后缀的域名被第三方抢注，请勿轻信。
• 注意: picoclaw正在初期的快速功能开发阶段，可能有尚未修复的网络安全问题，在1.0正式版发布前，请不要将其部署到生产环境中
• 注意: picoclaw最近合并了大量PRs，近期版本可能内存占用较大(10~20MB)，我们将在功能较为收敛后进行资源占用优化.

📢 新闻 (News)

2026-02-16 🎉 PicoClaw 在一周内突破了12K star! 感谢大家的关注！PicoClaw 的成长速度超乎我们预期. 由于PR数量的快速膨胀，我们亟需社区开发者参与维护. 我们需要的志愿者角色和roadmap已经发布到了这里, 期待你的参与！

2026-02-13 🎉 PicoClaw 在 4 天内突破 5000 Stars！ 感谢社区的支持！由于正值中国春节假期，PR 和 Issue 涌入较多，我们正在利用这段时间敲定 项目路线图 (Roadmap) 并组建 开发者群组，以便加速 PicoClaw 的开发。 🚀 行动号召： 请在 GitHub Discussions 中提交您的功能请求 (Feature Requests)。我们将在接下来的周会上进行审查和优先级排序。

2026-02-09 🎉 PicoClaw 正式发布！ 仅用 1 天构建，旨在将 AI Agent 带入 10 美元硬件与 <10MB 内存的世界。🦐 PicoClaw（皮皮虾），我们走！

✨ 特性

🪶 超轻量级: 核心功能内存占用 <10MB — 比 Clawdbot 小 99%。

💰 极低成本: 高效到足以在 10 美元的硬件上运行 — 比 Mac mini 便宜 98%。

⚡️ 闪电启动: 启动速度快 400 倍，即使在 0.6GHz 单核处理器上也能在 1 秒内启动。

🌍 真正可移植: 跨 RISC-V、ARM 和 x86 架构的单二进制文件，一键运行！

🤖 AI 自举: 纯 Go 语言原生实现 — 95% 的核心代码由 Agent 生成，并经由“人机回环 (Human-in-the-loop)”微调。

	OpenClaw	NanoBot	PicoClaw
语言	TypeScript	Python	Go
RAM	>1GB	>100MB	< 10MB
启动时间</br>(0.8GHz core)	>500s	>30s	<1s
成本	Mac Mini $599	大多数 Linux 开发板 ~$50	任意 Linux 开发板</br>低至 $10

🦾 演示

🛠️ 标准助手工作流

🧩 全栈工程师模式	🗂️ 日志与规划管理	🔎 网络搜索与学习
开发 • 部署 • 扩展	日程 • 自动化 • 记忆	发现 • 洞察 • 趋势

📱 在手机上轻松运行

picoclaw 可以将你10年前的老旧手机废物利用，变身成为你的AI助理！快速指南:

1. 先去应用商店下载安装Termux
2. 打开后执行指令

# 注意: 下面的v0.1.1 可以换为你实际看到的最新版本
wget https://github.com/sipeed/picoclaw/releases/download/v0.1.1/picoclaw-linux-arm64
chmod +x picoclaw-linux-arm64
pkg install proot
termux-chroot ./picoclaw-linux-arm64 onboard

然后跟随下面的“快速开始”章节继续配置picoclaw即可使用！

🐜 创新的低占用部署

PicoClaw 几乎可以部署在任何 Linux 设备上！

• $9.9 LicheeRV-Nano E(网口) 或 W(WiFi6) 版本，用于极简家庭助手。
• $30~50 NanoKVM，或 $100 NanoKVM-Pro，用于自动化服务器运维。
• $50 MaixCAM 或 $100 MaixCAM2，用于智能监控。

https://private-user-images.githubusercontent.com/83055338/547056448-e7b031ff-d6f5-4468-bcca-5726b6fecb5c.mp4

🌟 更多部署案例敬请期待！

📦 安装

使用预编译二进制文件安装

从 Release 页面 下载适用于您平台的固件。

从源码安装（获取最新特性，开发推荐）

git clone https://github.com/sipeed/picoclaw.git

cd picoclaw
make deps

# 构建（无需安装）
make build

# 为多平台构建
make build-all

# 构建并安装
make install

🐳 Docker Compose

您也可以使用 Docker Compose 运行 PicoClaw，无需在本地安装任何环境。

# 1. 克隆仓库
git clone https://github.com/sipeed/picoclaw.git
cd picoclaw

# 2. 首次运行 — 自动生成 docker/data/config.json 后退出
docker compose -f docker/docker-compose.yml --profile gateway up
# 容器打印 "First-run setup complete." 后自动停止

# 3. 填写 API Key 等配置
vim docker/data/config.json   # 设置 provider API key、Bot Token 等

# 4. 正式启动
docker compose -f docker/docker-compose.yml --profile gateway up -d

[!TIP] Docker 用户: 默认情况下, Gateway 监听 127.0.0.1，该端口不会暴露到容器外。如果需要通过端口映射访问健康检查接口，请在环境变量中设置 PICOCLAW_GATEWAY_HOST=0.0.0.0 或修改 config.json。

# 5. 查看日志
docker compose -f docker/docker-compose.yml logs -f picoclaw-gateway

# 6. 停止
docker compose -f docker/docker-compose.yml --profile gateway down

Agent 模式 (一次性运行)

# 提问
docker compose -f docker/docker-compose.yml run --rm picoclaw-agent -m "2+2 等于几？"

# 交互模式
docker compose -f docker/docker-compose.yml run --rm picoclaw-agent

更新镜像

docker compose -f docker/docker-compose.yml pull
docker compose -f docker/docker-compose.yml --profile gateway up -d

🚀 快速开始

[!TIP] 在 ~/.picoclaw/config.json 中设置您的 API Key。 获取 API Key: OpenRouter (LLM) · Zhipu (智谱) (LLM) 网络搜索是 可选的 - 获取免费的 Tavily API (每月 1000 次免费查询) 或 Brave Search API (每月 2000 次免费查询)

1. 初始化 (Initialize)

picoclaw onboard

2. 配置 (Configure) (~/.picoclaw/config.json)

{
  "agents": {
    "defaults": {
      "workspace": "~/.picoclaw/workspace",
      "model_name": "gpt4",
      "max_tokens": 8192,
      "temperature": 0.7,
      "max_tool_iterations": 20
    }
  },
  "model_list": [
    {
      "model_name": "gpt4",
      "model": "openai/gpt-5.2",
      "api_key": "your-api-key",
      "request_timeout": 300
    },
    {
      "model_name": "claude-sonnet-4.6",
      "model": "anthropic/claude-sonnet-4.6",
      "api_key": "your-anthropic-key"
    }
  ],
  "tools": {
    "web": {
      "brave": {
        "enabled": false,
        "api_key": "YOUR_BRAVE_API_KEY",
        "max_results": 5
      },
      "tavily": {
        "enabled": false,
        "api_key": "YOUR_TAVILY_API_KEY",
        "max_results": 5
      }
    },
    "cron": {
      "exec_timeout_minutes": 5
    }
  }
}

新功能: model_list 配置格式支持零代码添加 provider。详见模型配置章节。 request_timeout 为可选项，单位为秒。若省略或设置为 <= 0，PicoClaw 使用默认超时（120 秒）。

3. 获取 API Key

• LLM 提供商: OpenRouter · Zhipu · Anthropic · OpenAI · Gemini
• 网络搜索 (可选): Tavily - 专为 AI Agent 优化 (1000 请求/月) · Brave Search - 提供免费层级 (2000 请求/月)

注意: 完整的配置模板请参考 config.example.json。

4. 对话 (Chat)

picoclaw agent -m "2+2 等于几？"

就是这样！您在 2 分钟内就拥有了一个可工作的 AI 助手。

---

💬 聊天应用集成 (Chat Apps)

PicoClaw 支持多种聊天平台，使您的 Agent 能够连接到任何地方。

注意: 所有 Webhook 类渠道（LINE、WeCom 等）均挂载在同一个 Gateway HTTP 服务器上（gateway.host:gateway.port，默认 127.0.0.1:18790），无需为每个渠道单独配置端口。注意：飞书（Feishu）使用 WebSocket/SDK 模式，不通过该共享 HTTP webhook 服务器接收消息。

核心渠道

渠道	设置难度	特性说明	文档链接
Telegram	⭐ 简单	推荐，支持语音转文字，长轮询无需公网	查看文档
Discord	⭐ 简单	Socket Mode，支持群组/私信，Bot 生态成熟	查看文档
Slack	⭐ 简单	Socket Mode (无需公网 IP)，企业级支持	查看文档
QQ	⭐⭐ 中等	官方机器人 API，适合国内社群	查看文档
钉钉 (DingTalk)	⭐⭐ 中等	Stream 模式无需公网，企业办公首选	查看文档
企业微信 (WeCom)	⭐⭐⭐ 较难	支持群机器人(Webhook)和自建应用(API)	Bot 文档 / App 文档
飞书 (Feishu)	⭐⭐⭐ 较难	企业级协作，功能丰富	查看文档
Line	⭐⭐⭐ 较难	需要 HTTPS Webhook	查看文档
OneBot	⭐⭐ 中等	兼容 NapCat/Go-CQHTTP，社区生态丰富	查看文档
MaixCam	⭐ 简单	专为 AI 摄像头设计的硬件集成通道	查看文档

加入 Agent 社交网络

只需通过 CLI 或任何集成的聊天应用发送一条消息，即可将 PicoClaw 连接到 Agent 社交网络。

**阅读 https://clawdchat.ai/skill.md 并按照说明加入 ClawdChat.ai

⚙️ 配置详解

配置文件路径: ~/.picoclaw/config.json

环境变量

你可以使用环境变量覆盖默认路径。这对于便携安装、容器化部署或将 picoclaw 作为系统服务运行非常有用。这些变量是独立的，控制不同的路径。

变量	描述	默认路径
PICOCLAW_CONFIG	覆盖配置文件的路径。这直接告诉 picoclaw 加载哪个 config.json，忽略所有其他位置。	~/.picoclaw/config.json
PICOCLAW_HOME	覆盖 picoclaw 数据根目录。这会更改 workspace 和其他数据目录的默认位置。	~/.picoclaw

示例：

# 使用特定的配置文件运行 picoclaw
# 工作区路径将从该配置文件中读取
PICOCLAW_CONFIG=/etc/picoclaw/production.json picoclaw gateway

# 在 /opt/picoclaw 中存储所有数据运行 picoclaw
# 配置将从默认的 ~/.picoclaw/config.json 加载
# 工作区将在 /opt/picoclaw/workspace 创建
PICOCLAW_HOME=/opt/picoclaw picoclaw agent

# 同时使用两者进行完全自定义设置
PICOCLAW_HOME=/srv/picoclaw PICOCLAW_CONFIG=/srv/picoclaw/main.json picoclaw gateway

工作区布局 (Workspace Layout)

PicoClaw 将数据存储在您配置的工作区中（默认：~/.picoclaw/workspace）：

~/.picoclaw/workspace/
├── sessions/          # 对话会话和历史
├── memory/           # 长期记忆 (MEMORY.md)
├── state/            # 持久化状态 (最后一次频道等)
├── cron/             # 定时任务数据库
├── skills/           # 自定义技能
├── AGENTS.md         # Agent 行为指南
├── HEARTBEAT.md      # 周期性任务提示词 (每 30 分钟检查一次)
├── IDENTITY.md       # Agent 身份设定
├── SOUL.md           # Agent 灵魂/性格
├── TOOLS.md          # 工具描述
└── USER.md           # 用户偏好

心跳 / 周期性任务 (Heartbeat)

PicoClaw 可以自动执行周期性任务。在工作区创建 HEARTBEAT.md 文件：

# Periodic Tasks

- Check my email for important messages
- Review my calendar for upcoming events
- Check the weather forecast

Agent 将每隔 30 分钟（可配置）读取此文件，并使用可用工具执行任务。

使用 Spawn 的异步任务

对于耗时较长的任务（网络搜索、API 调用），使用 spawn 工具创建一个 子 Agent (subagent)：

# Periodic Tasks

## 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 即可独立与用户通信。

配置：

{
  "heartbeat": {
    "enabled": true,
    "interval": 30
  }
}

选项	默认值	描述
enabled	true	启用/禁用心跳
interval	30	检查间隔，单位分钟 (最小: 5)

环境变量:

• PICOCLAW_HEARTBEAT_ENABLED=false 禁用
• PICOCLAW_HEARTBEAT_INTERVAL=60 更改间隔

提供商 (Providers)

[!NOTE] Groq 通过 Whisper 提供免费的语音转录。如果配置了 Groq，Telegram 语音消息将被自动转录为文字。

提供商	用途	获取 API Key
gemini	LLM (Gemini 直连)	aistudio.google.com
zhipu	LLM (智谱直连)	bigmodel.cn
openrouter(待测试)	LLM (推荐，可访问所有模型)	openrouter.ai
anthropic(待测试)	LLM (Claude 直连)	console.anthropic.com
openai(待测试)	LLM (GPT 直连)	platform.openai.com
deepseek(待测试)	LLM (DeepSeek 直连)	platform.deepseek.com
qwen	LLM (通义千问)	dashscope.console.aliyun.com
groq	LLM + 语音转录 (Whisper)	console.groq.com
cerebras	LLM (Cerebras 直连)	cerebras.ai

模型配置 (model_list)

新功能！ PicoClaw 现在采用以模型为中心的配置方式。只需使用 厂商/模型 格式（如 zhipu/glm-4.7）即可添加新的 provider——无需修改任何代码！

该设计同时支持多 Agent 场景，提供灵活的 Provider 选择：

• 不同 Agent 使用不同 Provider：每个 Agent 可以使用自己的 LLM provider
• 模型回退（Fallback）：配置主模型和备用模型，提高可靠性
• 负载均衡：在多个 API 端点之间分配请求
• 集中化配置：在一个地方管理所有 provider

📋 所有支持的厂商

厂商	model 前缀	默认 API Base	协议	获取 API Key
OpenAI	openai/	https://api.openai.com/v1	OpenAI	获取密钥
Anthropic	anthropic/	https://api.anthropic.com/v1	Anthropic	获取密钥
智谱 AI (GLM)	zhipu/	https://open.bigmodel.cn/api/paas/v4	OpenAI	获取密钥
DeepSeek	deepseek/	https://api.deepseek.com/v1	OpenAI	获取密钥
Google Gemini	gemini/	https://generativelanguage.googleapis.com/v1beta	OpenAI	获取密钥
Groq	groq/	https://api.groq.com/openai/v1	OpenAI	获取密钥
Moonshot	moonshot/	https://api.moonshot.cn/v1	OpenAI	获取密钥
通义千问 (Qwen)	qwen/	https://dashscope.aliyuncs.com/compatible-mode/v1	OpenAI	获取密钥
NVIDIA	nvidia/	https://integrate.api.nvidia.com/v1	OpenAI	获取密钥
Ollama	ollama/	http://localhost:11434/v1	OpenAI	本地（无需密钥）
OpenRouter	openrouter/	https://openrouter.ai/api/v1	OpenAI	获取密钥
VLLM	vllm/	http://localhost:8000/v1	OpenAI	本地
Cerebras	cerebras/	https://api.cerebras.ai/v1	OpenAI	获取密钥
火山引擎	volcengine/	https://ark.cn-beijing.volces.com/api/v3	OpenAI	获取密钥
神算云	shengsuanyun/	https://router.shengsuanyun.com/api/v1	OpenAI	-
Antigravity	antigravity/	Google Cloud	自定义	仅 OAuth
GitHub Copilot	github-copilot/	localhost:4321	gRPC	-

基础配置示例

{
  "model_list": [
    {
      "model_name": "gpt-5.2",
      "model": "openai/gpt-5.2",
      "api_key": "sk-your-openai-key"
    },
    {
      "model_name": "claude-sonnet-4.6",
      "model": "anthropic/claude-sonnet-4.6",
      "api_key": "sk-ant-your-key"
    },
    {
      "model_name": "glm-4.7",
      "model": "zhipu/glm-4.7",
      "api_key": "your-zhipu-key"
    }
  ],
  "agents": {
    "defaults": {
      "model": "gpt-5.2"
    }
  }
}

各厂商配置示例

OpenAI

{
  "model_name": "gpt-5.2",
  "model": "openai/gpt-5.2",
  "api_key": "sk-..."
}

智谱 AI (GLM)

{
  "model_name": "glm-4.7",
  "model": "zhipu/glm-4.7",
  "api_key": "your-key"
}

DeepSeek

{
  "model_name": "deepseek-chat",
  "model": "deepseek/deepseek-chat",
  "api_key": "sk-..."
}

Anthropic (使用 OAuth)

{
  "model_name": "claude-sonnet-4.6",
  "model": "anthropic/claude-sonnet-4.6",
  "auth_method": "oauth"
}

运行 picoclaw auth login --provider anthropic 来设置 OAuth 凭证。

Ollama (本地)

{
  "model_name": "llama3",
  "model": "ollama/llama3"
}

自定义代理/API

{
  "model_name": "my-custom-model",
  "model": "openai/custom-model",
  "api_base": "https://my-proxy.com/v1",
  "api_key": "sk-...",
  "request_timeout": 300
}

负载均衡

为同一个模型名称配置多个端点——PicoClaw 会自动在它们之间轮询：

{
  "model_list": [
    {
      "model_name": "gpt-5.2",
      "model": "openai/gpt-5.2",
      "api_base": "https://api1.example.com/v1",
      "api_key": "sk-key1"
    },
    {
      "model_name": "gpt-5.2",
      "model": "openai/gpt-5.2",
      "api_base": "https://api2.example.com/v1",
      "api_key": "sk-key2"
    }
  ]
}

从旧的 providers 配置迁移

旧的 providers 配置格式已弃用，但为向后兼容仍支持。

旧配置（已弃用）：

{
  "providers": {
    "zhipu": {
      "api_key": "your-key",
      "api_base": "https://open.bigmodel.cn/api/paas/v4"
    }
  },
  "agents": {
    "defaults": {
      "provider": "zhipu",
      "model": "glm-4.7"
    }
  }
}

新配置（推荐）：

{
  "model_list": [
    {
      "model_name": "glm-4.7",
      "model": "zhipu/glm-4.7",
      "api_key": "your-key"
    }
  ],
  "agents": {
    "defaults": {
      "model": "glm-4.7"
    }
  }
}

详细的迁移指南请参考 docs/migration/model-list-migration.md。

智谱 (Zhipu) 配置示例

**1. 获取 API key 和 base URL** - 获取 [API key](https://bigmodel.cn/usercenter/proj-mgmt/apikeys) **2. 配置** ```json { "agents": { "defaults": { "workspace": "~/.picoclaw/workspace", "model": "glm-4.7", "max_tokens": 8192, "temperature": 0.7, "max_tool_iterations": 20 } }, "providers": { "zhipu": { "api_key": "Your API Key", "api_base": "https://open.bigmodel.cn/api/paas/v4" } } } ``` **3. 运行** ```bash picoclaw agent -m "你好" ```

完整配置示例

```json { "agents": { "defaults": { "model": "anthropic/claude-opus-4-5" } }, "providers": { "openrouter": { "api_key": "sk-or-v1-xxx" }, "groq": { "api_key": "gsk_xxx" } }, "channels": { "telegram": { "enabled": true, "token": "123456:ABC...", "allow_from": ["123456789"] }, "discord": { "enabled": true, "token": "", "allow_from": [""] }, "whatsapp": { "enabled": false }, "feishu": { "enabled": false, "app_id": "cli_xxx", "app_secret": "xxx", "encrypt_key": "", "verification_token": "", "allow_from": [] }, "qq": { "enabled": false, "app_id": "", "app_secret": "", "allow_from": [] } }, "tools": { "web": { "brave": { "enabled": false, "api_key": "YOUR_BRAVE_API_KEY", "max_results": 5 }, "duckduckgo": { "enabled": true, "max_results": 5 } }, "cron": { "exec_timeout_minutes": 5 } }, "heartbeat": { "enabled": true, "interval": 30 } } ```

CLI 命令行参考

命令	描述
picoclaw onboard	初始化配置和工作区
picoclaw agent -m "..."	与 Agent 对话
picoclaw agent	交互式聊天模式
picoclaw gateway	启动网关 (Gateway)
picoclaw status	显示状态
picoclaw cron list	列出所有定时任务
picoclaw cron add ...	添加定时任务

定时任务 / 提醒 (Scheduled Tasks)

PicoClaw 通过 cron 工具支持定时提醒和重复任务：

• 一次性提醒: “Remind me in 10 minutes” (10分钟后提醒我) → 10分钟后触发一次
• 重复任务: “Remind me every 2 hours” (每2小时提醒我) → 每2小时触发
• Cron 表达式: “Remind me at 9am daily” (每天上午9点提醒我) → 使用 cron 表达式

任务存储在 ~/.picoclaw/workspace/cron/ 中并自动处理。

🤝 贡献与路线图 (Roadmap)

欢迎提交 PR！代码库刻意保持小巧和可读。🤗

路线图即将发布…

开发者群组正在组建中，入群门槛：至少合并过 1 个 PR。

用户群组：

Discord: https://discord.gg/V4sAZ9XWpN

🐛 疑难解答 (Troubleshooting)

网络搜索提示 “API 配置问题”

如果您尚未配置搜索 API Key，这是正常的。PicoClaw 会提供手动搜索的帮助链接。

启用网络搜索：

1. 在 https://tavily.com (1000 次免费) 或 https://brave.com/search/api 获取免费 API Key (2000 次免费)
2. 添加到 ~/.picoclaw/config.json:

{
  "tools": {
    "web": {
      "brave": {
        "enabled": false,
        "api_key": "YOUR_BRAVE_API_KEY",
        "max_results": 5
      },
      "duckduckgo": {
        "enabled": true,
        "max_results": 5
      }
    }
  }
}

遇到内容过滤错误 (Content Filtering Errors)

某些提供商（如智谱）有严格的内容过滤。尝试改写您的问题或使用其他模型。

Telegram bot 提示 “Conflict: terminated by other getUpdates”

这表示有另一个机器人实例正在运行。请确保同一时间只有一个 picoclaw gateway 进程在运行。

---

📝 API Key 对比

服务	免费层级	适用场景
OpenRouter	200K tokens/月	多模型聚合 (Claude, GPT-4 等)
智谱 (Zhipu)	200K tokens/月	最适合中国用户
Brave Search	2000 次查询/月	网络搜索功能
Tavily	1000 次查询/月	AI Agent 搜索优化
Groq	提供免费层级	极速推理 (Llama, Mixtral)

参考资料

• 📢 新闻 (News)
• ✨ 特性
• 🦾 演示
  • 🛠️ 标准助手工作流
  • 📱 在手机上轻松运行
  • 🐜 创新的低占用部署
• 📦 安装
  • 使用预编译二进制文件安装
  • 从源码安装（获取最新特性，开发推荐）
• 🐳 Docker Compose
  • Agent 模式 (一次性运行)
  • 更新镜像
  • 🚀 快速开始
• 💬 聊天应用集成 (Chat Apps)
  • 核心渠道
• 加入 Agent 社交网络
• ⚙️ 配置详解
  • 环境变量
  • 工作区布局 (Workspace Layout)
  • 心跳 / 周期性任务 (Heartbeat)
    • 使用 Spawn 的异步任务
    • 子 Agent 通信原理
  • 提供商 (Providers)
  • 模型配置 (model_list)
    • 📋 所有支持的厂商
    • 基础配置示例
    • 各厂商配置示例
    • 负载均衡
    • 从旧的 providers 配置迁移
• CLI 命令行参考
  • 定时任务 / 提醒 (Scheduled Tasks)
• 🤝 贡献与路线图 (Roadmap)
• 🐛 疑难解答 (Troubleshooting)
  • 网络搜索提示 “API 配置问题”
  • 遇到内容过滤错误 (Content Filtering Errors)
  • Telegram bot 提示 “Conflict: terminated by other getUpdates”
• 📝 API Key 对比
• 参考资料