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

配置文件：编辑 ~/.picoclaw/config.json 文件，这是核心步骤。你需要至少配置一个 LLM 提供商（如智谱、OpenRouter）的 API Key。一个最小化的配置示例如下（以智谱 AI 为例）：

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

初始化：运行以下命令，它会在你的用户目录下创建 ~/.picoclaw/ 文件夹和默认配置文件。

picoclaw onboard

使用场景

配置好之后，你就可以用多种方式和你的 AI 助手交互了。

• 本地命令行对话
• 接入聊天平台（网关模式） 这是 PicoClaw 最实用的功能之一，可以让你通过 Telegram、Discord 等日常 App 与 AI 助手聊天。
• 高级功能：定时任务与个性化
  • 自定义人格：通过修改 ~/.picoclaw/workspace/ 下的 AGENTS.md 或 SOUL.md 文件，可以用自然语言定义助手的性格、技能和行为准则，无需编写代码。
  • 定时任务（cron）：你可以设置让助手定时执行任务，比如每天早上 9 点提醒你今天的日程。

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

启动网关服务：

picoclaw gateway

如果是 Docker 安装，网关通常已经后台运行了。之后，你就可以在手机上随时随地和你的 AI 助手对话了。

在 ~/.picoclaw/config.json 文件中，找到 channels 部分，填入你创建的 Telegram Bot Token 和你的用户 ID。

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

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

picoclaw agent

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

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

Windows 编译说明

目前官方未提供详细的 Windows 源码编译指南，但 PicoClaw 是 Go 语言项目，可通过以下方式在 Windows 10 上获得：

方法一：从源码自行编译

确保你的 Windows 10 系统已安装 Go（推荐 1.16 及以上版本）。在项目根目录下执行 go build 命令，Go 会自动下载依赖并生成可执行文件。

git clone https://github.com/sipeed/picoclaw.git
cd picoclaw
go build -o picoclaw.exe

方法二：直接下载预编译版本（推荐）

如果主要是想使用 PicoClaw 而非参与源码开发，更简单的方法是直接下载官方提供的 Windows 预编译版本。

1. 下载文件：从 PicoClaw 的 GitHub Releases 页面下载 picoclaw-windows-amd64.exe。
2. 放置与重命名：将下载的文件放到一个方便的目录，例如 C:\picoclaw，并将其重命名为 picoclaw.exe。
3. 初始化工作区：在 picoclaw.exe 所在目录打开命令提示符，运行 picoclaw init 命令生成配置文件和工作区。
4. 配置 API 密钥：编辑生成的配置文件（默认路径为 C:\Users\你的用户名\.picoclaw\workspace\config.json），填入你的 LLM API 密钥（如 OpenAI、DeepSeek 或本地 Ollama）。
5. 运行：最后，执行 picoclaw run 即可开始使用。

实践参考

若使用 MSYS 环境编译，流程如下：

cd D:\AI\picoclaw-main
gmake deps
gmake build
rename picoclaw picoclaw.exe
picoclaw onboard

注意：具体路径请根据实际环境调整。