mcpField
G
grok-bot

grok-bot

github.com/adamanzAgent 工作流1564 次安装10 周前更新
代码仓库

关于 grok-bot

通过本地 Python CLI 管理 Grok Bot 队友的技能，可查看状态、列出机器人、发送消息，并按需创建机器人，同时提供安全交互指引。

主要功能

  1. 01查看机器人状态和队友列表
  2. 02对话等待回复或异步发送
  3. 03按角色创建机器人
  4. 04按名称或 ID 定位机器人
  5. 05秘密信息与权限安全指引

适用场景

  1. 01查看可用的 Grok Bot 队友
  2. 02向现有机器人获取答复
  3. 03分派稍后跟进的任务
  4. 04创建承担特定角色的队友

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/adamanz/grok-bot-skill --skill grok-bot

安装后在 Claude Code 中输入/grok-bot确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

examples.md
SECURITY.md
CHANGELOG.md
LICENSE
package.json
README.md
.gitignore
AGENTS.md
.claude-plugin/
marketplace.json
scripts/
grokbot.py

详细介绍

Grok Bot

通过本地 CLI 与现有的 Grok Bot 团队成员交谈，并创建新成员。 不要操作 Grok Bot 桌面界面，也不要手动调用网关。

工作流

  1. 运行 status，然后运行 list。
  2. 使用 chat（等待回复）或 send（发送后即返回）给现有 Bot 发消息。
  3. 仅当用户要求新增团队成员时，才使用 create 创建新 Bot。
  4. 每个 Bot 尽量只负责一项明确的工作。将长期规则写入 --description。首次任务仅限起草。

CLI 位于此文件旁边的 scripts/grokbot.py。请从已安装的技能目录解析该路径（通常为 ~/.cursor/skills/grok-bot/scripts/grokbot.py）。

SCRIPT="$(dirname "$0")/scripts/grokbot.py"
# or, after a global Cursor install:
SCRIPT="$HOME/.cursor/skills/grok-bot/scripts/grokbot.py"

python3 "$SCRIPT" status
python3 "$SCRIPT" list
python3 "$SCRIPT" chat --name Reed --prompt "What are you waiting on from me?"
python3 "$SCRIPT" create --name Reed --title "Chief of staff" --description "Draft-only daily brief. Never send messages."
python3 "$SCRIPT" transcript --name Reed --limit 20

输出为 JSON。请向用户概述结果。切勿在聊天中粘贴令牌、网关 URL 或原始钥匙串内容。

创建规则

新 Bot 需要：

  • --name — 简短且唯一
  • --title — 一项工作，不要使用“通用助手”
  • --description — 说明目标、信息来源，以及未经批准不得执行的事项

除非用户提出要求，否则不要创建同名的第二个 Bot。除非传入 --force，CLI 会拒绝重复项。

创建后，除非用户只想创建一个空白团队成员，否则请使用 chat 发送一项具体的首次任务。

聊天规则

  • 名称唯一时通过 --name 查找 Bot；名称重复时使用 --id。
  • 如果用户希望在当前对话中获得答复，请使用 chat。
  • 对于用户会在 Grok Bot 应用中查看的长时间运行任务，请使用 send。
  • 如果 stillRunning 为 true，请说明任务仍在运行，并询问是否需要再次轮询。不要编造回复。
  • 不要发送密码、API 密钥或 2FA 验证码。请告诉用户在 Grok Bot 应用中接管 Agent Computer。
  • 除非用户明确要求，否则不要批准访问本地计算机。

安全

  • CLI 会从 Keychain 和 sand-secrets.json 解密 Grok Bot 会话。请将其视为机密代理。切勿打印或记录令牌。
  • 用户的所有 Bot 共用一台云计算机。不要将不同 Bot 视为安全边界。
  • 这不是 Cursor Cloud Agents API（api.cursor.com/v1/agents）。用户要求使用 Grok Bot 时，不要创建编码云 Agent。

故障排除

症状处理方法
未登录 / 令牌格式异常请用户打开 Grok Bot，并使用 Cursor 登录
钥匙串读取失败请用户解锁登录钥匙串，然后重试
未授予访问权限符合条件的套餐：SuperGrok Heavy、Cursor Ultra、Cursor Teams Premium
计算机仍在启动等待并重新运行 status，直到计算机运行
找不到该名称的 Bot运行 list 并确认名称

如果 CLI 缺少用户需要的命令，请阅读 scripts/grokbot.py --help。不要在聊天中编造新的网关路由。

评论

支持 Markdown