PicoClaw 轻量级 AI 助手安装与使用指南

配置 PicoClaw

安装完成后，需进行初始化和配置。

1. 获取 API Key：可从智谱 AI、OpenRouter 等平台获取。
2. 网络搜索（可选）：如需联网查资料，可获取 Brave Search API Key。
3. 编辑配置文件：编辑 ~/.picoclaw/config.json。

最小化配置示例（以智谱 AI 为例）：

{
  "agents": {
    "defaults": {
      "model": "glm-5",
      "max_tokens": 8192
    }
  },
  "providers": {
    "zhipu": {
      "api_key": "你的智谱 API Key",
      "api_base": "https://open.bigmodel.cn/api/paas/v4"
    }
  }
}

4. 初始化：运行以下命令创建默认配置。

picoclaw onboard

使用场景

1. 本地命令行对话

• 交互式对话：进入连续聊天模式。

  picoclaw agent
  

• 一次性提问：适合快速查询。

  picoclaw agent -m "介绍一下皮皮虾的特点"
  

2. 接入聊天平台（网关模式）

通过 Telegram、Discord 等日常 App 与 AI 助手聊天。

• 启动网关服务：

  picoclaw gateway
  

• 配置渠道：在 config.json 的 channels 部分填入 Bot Token 和用户 ID。

  {
    "channels": {
      "telegram": {
        "enabled": true,
        "token": "你的 Telegram Bot Token",
        "allowFrom": ["你的 Telegram 用户 ID"]
      }
    }
  }
  

3. 高级功能

• 自定义人格：修改 ~/.picoclaw/workspace/ 下的 AGENTS.md 或 SOUL.md 文件，用自然语言定义助手的性格和技能。
• 定时任务（cron）：

  picoclaw cron add --message "提醒我今天的重要会议" --cron "0 9 * * 1-5"