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

示例配置（以智谱 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

使用场景

命令行对话

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

  picoclaw agent
  

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

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

网关模式

接入 Telegram、Discord 等日常 App 与 AI 助手聊天。

1. 启动网关服务：

   picoclaw gateway
   

   Docker 安装通常已后台运行。
2. 配置频道：在 config.json 中填入 Telegram Bot Token 和用户 ID。

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

高级功能

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

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

Windows 编译注意事项

若在 Windows 10 上从源码编译，请确保已安装 Go 环境（推荐 1.16+）。

1. 安装 Go：确保系统环境变量包含 Go 路径。
2. 编译项目：在项目根目录下执行 go build。

   go build -o picoclaw.exe
   

3. 初始化：运行 picoclaw init 生成配置文件和工作区。
4. 配置密钥：编辑生成的配置文件，填入 LLM API 密钥。
5. 运行：执行 picoclaw run 开始使用。

若遇到编译问题，建议优先下载官方提供的 Windows 预编译版本。