robbin/grokbot-local-agent

这是什么？

核心功能

• 01通过同机的 Pi 编程代理执行委派的任务。
• 02每个任务带有 ID，状态和产物保存在磁盘上。
• 03任务完成时发送 webhook，唤醒 Bot 验证并汇报结果。
• 04按所有者 Agent ID 过滤 pending、list 和 ack，避免 Bot 之间串报。
• 05支持后续对话、取消任务，以及固定模型的同步调用。
• 06可选的 Telegram 监控，将 Pi 会话进度推送到私人聊天。

适用场景

• 把批量改文件或小脚本从订阅额度有限的聊天 Bot 转交给本地代理。
• 在 Bot 对话结束后，继续运行长文档草稿或调研任务。
• 通过 webhook 唤醒，获得后台编程任务的验证结果汇报。
• 通过 Telegram 在手机上实时查看被委派的代理会话。

快速上手

1. 1

   安装 Node 22+ 和 Pi 编码代理

   npm i -g --prefix ~/.local @earendil-works/pi-coding-agent
2. 2

   自行登录模型：在交互式终端运行 pi 并输入 /login

3. 3

   将脚本复制到 ~/tools/pi-call

   mkdir -p ~/tools/pi-call && cp -a bin/. ~/tools/pi-call/
4. 4

   运行冒烟测试，应输出 OK

   ~/tools/pi-call/pi-run /tmp "Reply with only OK" --timeout 120

使用前须知

• !需要 Node 22+ 以及你自己单独的模型账户或订阅，并需自行完成认证。
• !需要在 Grok Bot 主机上配置 webhook 例程和密钥，设置工作量较大。
• !这是轻量辅助工具而非隔离沙箱，不提供强权限隔离。

收录于专题

标签

常见问题

grokbot-local-agent 是什么？

让 Grok Bot 将重任务交给同机的本地 Pi 代理执行，完成后通过 webhook 唤醒 Bot 验证和汇报。 grokbot-local-agent 是一组脚本，用于把 Grok Bot 的工作委派给同一台 Linux 机器上的本地编程代理 Pi。批量改文件、小脚本、长文档草稿和调研等重任务通过 Pi 运行，使用用户自己的模型账号，不占用 Bot 的订阅额度。

grokbot-local-agent 可以免费使用吗？用的什么许可证？

grokbot-local-agent 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

grokbot-local-agent 还在维护吗？

活跃维护中。grokbot-local-agent 最近一次提交是在 2026年10月26日。

grokbot-local-agent 适合用来做什么？

把批量改文件或小脚本从订阅额度有限的聊天 Bot 转交给本地代理。 在 Bot 对话结束后，继续运行长文档草稿或调研任务。 通过 webhook 唤醒，获得后台编程任务的验证结果汇报。 通过 Telegram 在手机上实时查看被委派的代理会话。

grokbot-local-agent 怎么安装和运行？

安装 Node 22+ 和 Pi 编码代理: npm i -g --prefix ~/.local @earendil-works/pi-coding-agent 自行登录模型：在交互式终端运行 pi 并输入 /login 将脚本复制到 ~/tools/pi-call: mkdir -p ~/tools/pi-call && cp -a bin/. ~/tools/pi-call/ 运行冒烟测试，应输出 OK: ~/tools/pi-call/pi-run /tmp "Reply with only OK" --timeout 120

在哪里获取 grokbot-local-agent？

源代码和安装说明在 GitHub 上：https://github.com/robbin/grokbot-local-agent