Jules API — 谷歌 Jules AI 编码会话管理

Name: Jules API — 谷歌 Jules AI 编码会话管理
Author: arthbhalodiya

arthbhalodiya

Jules API — 谷歌 Jules AI 编码会话管理

v1.0.0

通过 Jules API 创建和管理 Google Jules AI 编码会话，自动执行代码写作、bug 修复、测试和 GitHub 仓库 PR 创建等任务。

0· 713·2 当前·2 累计

by @arthbhalodiya·MIT-0

API工具 AI模型访问自动化测试工具代码生成

下载技能包

License

MIT-0

最后更新

2026/2/26

安全扫描

VirusTotal

无害

查看报告

OpenClaw

可疑

medium confidence

该技能基本符合其声明的目的（使用 API 密钥调用 Jules REST API），但包装的帮助脚本与声明的要求存在不一致，且有一些运行时行为需要注意。

评估建议

此技能似乎是一个真正的 Jules REST API 帮助工具，但在安装或运行之前，请审查以下点： 1. 帮助脚本使用 `jq` 构造和解析 JSON，但技能元数据仅列出 `curl` 作为必需项。安装 `jq` 或更新脚本/元数据后再使用。 2. 该技能需要您的 `JULES_API_KEY`，该密钥授予 Jules 访问连接到您的 Jules 账户的仓库的权限（包括自动创建 PR 的能力）。仅使用可信的 API 密钥，并考虑限制范围或使用最小权限账户。 3. 包中没有隐藏的网络端点或下载步骤，但帮助脚本将对 `jules.googleapis.com` 进行网络调用。先在受控环境中检查脚本并进行测试。 4. 如果您计划允许自主代理操作，请谨慎对待自动批准/自动 PR 流程；除非您信任自动化，否则更好地使用 `requirePlanApproval`。...

详细分析 ▾

⚠ 用途与能力

名称/描述、声明的环境变量（JULES_API_KEY）和 curl 使用与 Jules REST API 客户端一致。然而，包含的 scripts/jules.sh 脚本依赖于 jq 来构建和解析 JSON（在某些地方无条件地），而技能元数据仅列出 curl 作为必需的二进制文件。这种不匹配意味着，如果没有 jq，包装的技能可能会在运行时失败，元数据也会低估实际的运行时足迹。

✓ 指令范围

SKILL.md 仅针对 Jules 端点（会话、源、活动）指示，并通过 x-goog-api-key 标头发送 API 密钥。没有指令读取无关文件、其他环境变量或向第三方泄露数据。注意：该技能支持自动化模式（AUTO_CREATE_PR），这将导致 Jules 在连接的 GitHub 仓库上创建 PR —— 这是预期但具有影响力的行为。

ℹ 安装机制

没有安装规范（仅指令），这降低了供应链风险。然而，包中包含一个帮助脚本（scripts/jules.sh），如果用户运行它，将会执行；安装时它不会写入/执行任何内容，但将在运行时运行 curl 和 jq。没有外部下载或存档提取。

✓ 凭证需求

仅需要 JULES_API_KEY，并适用于记录的 API 交互。用户应该意识到，API 密钥授予 Jules 访问连接到 Jules 账户的仓库的权限（包括使用自动化模式时创建 PR 的能力），因此密钥范围和对 Jules 集成的信任很重要。

✓ 持久化与权限

技能不请求 always:true，并且其文件中没有进行持久的系统更改。它不修改其他技能或系统范围的代理设置。允许自主调用（平台默认），但不与其他高权限请求组合。

安全有层次，运行前请审查代码。

License

MIT-0

可自由使用、修改和再分发，无需署名。

查看条款 ↗

运行时依赖

无特殊依赖

版本

latestv1.0.02026/2/14

Jules API 技能的初始发布： - 通过 Jules REST API 创建和管理 Google Jules AI 编码会话。 - 启动编码任务、监控会话进度、检索会话活动和工件。 - 批准计划、向会话发送消息并交互式指导编码任务。 - 列出、查询和获取连接的 GitHub 源（仓库）的详细信息。 - 对所有端点、所需参数和用法示例提供全面文档。

● 无害

安装命令点击复制

官方npx clawhub@latest install jules-api

镜像加速npx clawhub@latest install jules-api --registry https://cn.clawhub-mirror.com

技能文档

Jules API 技能 ====================

与 Google Jules AI 编码代理通过其 REST API 交互。Jules 可以自主执行 GitHub 仓库的编码任务——编写代码、修复 bug、添加测试并创建 pull 请求。

基 URL： https://jules.googleapis.com/v1alpha

认证： 通过 x-goog-api-key 标头传递您的 API 密钥。从 jules.google.com/settings 获取一个。

... （以下内容为原文档中未翻译的代码块和命令行指令，保持不变） ...

# Jules API Skill Interact with the Google Jules AI coding agent via its REST API. Jules can autonomously execute coding tasks on your GitHub repositories — writing code, fixing bugs, adding tests, and creating pull requests. Base URL: https://jules.googleapis.com/v1alpha Auth: Pass your API key via the x-goog-api-key header. Get one at jules.google.com/settings.

List Sources (Connected Repositories)

Discover which GitHub repos are connected to your Jules account: ``

bash
curl -s -H "x-goog-api-key: $JULES_API_KEY" \
  "https://jules.googleapis.com/v1alpha/sources?pageSize=30"

`



With pagination:

`

bash
curl -s -H "x-goog-api-key: $JULES_API_KEY" \
  "https://jules.googleapis.com/v1alpha/sources?pageSize=10&pageToken=PAGE_TOKEN"

`



Filter specific sources:

`

bash
curl -s -H "x-goog-api-key: $JULES_API_KEY" \
  "https://jules.googleapis.com/v1alpha/sources?filter=name%3Dsources%2Fgithub-owner-repo"

`



Get a Source

Get details and branches for a specific repo:

`

bash
curl -s -H "x-goog-api-key: $JULES_API_KEY" \
  "https://jules.googleapis.com/v1alpha/sources/SOURCE_ID"

`



Example:

sources/github-myorg-myrepo

 — replace with your actual source ID from List Sources.



Create a Session (Start a Coding Task)

Create a new Jules session to execute a coding task on a repo:

`

bash
curl -s -X POST \
  -H "x-goog-api-key: $JULES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "TASK_DESCRIPTION",
    "title": "OPTIONAL_TITLE",
    "sourceContext": {
      "source": "sources/github-OWNER-REPO",
      "githubRepoContext": {
        "startingBranch": "main"
      }
    },
    "requirePlanApproval": true
  }' \
  "https://jules.googleapis.com/v1alpha/sessions"

`



Parameters

| Parameter | Required | Description |
|---|---|---|
|

prompt

 | Yes | The task description for Jules to execute |
|

title

 | No | Optional title (auto-generated if omitted) |
|

sourceContext.source | Yes | Source resource name (e.g. sources/github-owner-repo

) |
|

sourceContext.githubRepoContext.startingBranch | Yes | Branch to start from (e.g. main, develop

) |
|

requirePlanApproval | No | If true

, plans need explicit approval before execution |
|

automationMode | No | Set to AUTO_CREATE_PR

 to auto-create PRs when done |

Auto-approve + Auto-PR example

`

bash
curl -s -X POST \
  -H "x-goog-api-key: $JULES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Add comprehensive unit tests for the auth module",
    "sourceContext": {
      "source": "sources/github-myorg-myrepo",
      "githubRepoContext": { "startingBranch": "main" }
    },
    "automationMode": "AUTO_CREATE_PR"
  }' \
  "https://jules.googleapis.com/v1alpha/sessions"

`





List Sessions

List all your Jules sessions:

`

bash
curl -s -H "x-goog-api-key: $JULES_API_KEY" \
  "https://jules.googleapis.com/v1alpha/sessions?pageSize=10"

`



Paginate with

pageToken

`

bash
curl -s -H "x-goog-api-key: $JULES_API_KEY" \
  "https://jules.googleapis.com/v1alpha/sessions?pageSize=10&pageToken=NEXT_PAGE_TOKEN"

`



Get a Session

Retrieve a single session by ID (includes outputs like PRs if completed):

`

bash
curl -s -H "x-goog-api-key: $JULES_API_KEY" \
  "https://jules.googleapis.com/v1alpha/sessions/SESSION_ID"

`



Session States

| State | Meaning |
|---|---|
|

QUEUED

 | Waiting to be processed |
|

PLANNING

 | Jules is analyzing and creating a plan |
|

AWAITING_PLAN_APPROVAL

 | Plan ready, waiting for user approval |
|

AWAITING_USER_FEEDBACK

 | Jules needs additional input |
|

IN_PROGRESS

 | Jules is actively working |
|

PAUSED

 | Session is paused |
|

COMPLETED

 | Task completed successfully |
|

FAILED

 | Task failed to complete |



Approve a Plan

When a session is in

AWAITING_PLAN_APPROVAL

 state, approve the plan:

`

bash
curl -s -X POST \
  -H "x-goog-api-key: $JULES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}' \
  "https://jules.googleapis.com/v1alpha/sessions/SESSION_ID:approvePlan"

`



Send a Message

Send feedback, answer questions, or give additional instructions to an active session:

`

bash
curl -s -X POST \
  -H "x-goog-api-key: $JULES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "YOUR_MESSAGE_HERE"
  }' \
  "https://jules.googleapis.com/v1alpha/sessions/SESSION_ID:sendMessage"

`



Use this when session state is

AWAITING_USER_FEEDBACK or to provide additional guidance during IN_PROGRESS

.



List Activities (Monitor Progress)

Get all events/progress for a session:

`

bash
curl -s -H "x-goog-api-key: $JULES_API_KEY" \
  "https://jules.googleapis.com/v1alpha/sessions/SESSION_ID/activities?pageSize=50"

`



Get activities after a specific timestamp (for polling):

`

bash
curl -s -H "x-goog-api-key: $JULES_API_KEY" \
  "https://jules.googleapis.com/v1alpha/sessions/SESSION_ID/activities?createTime=2026-01-17T00:03:53Z"

`



Activity Types

Activities will contain exactly one of these event fields:

| Event | Description |
|---|---|
|

planGenerated | Jules created a plan (contains plan.steps[]

) |
|

planApproved

 | A plan was approved |
|

userMessaged

 | User sent a message |
|

agentMessaged

 | Jules sent a message |
|

progressUpdated

 | Status update during execution |
|

sessionCompleted

 | Session finished successfully |
|

sessionFailed | Session encountered an error (contains reason

) |

Artifacts

Activities may include artifacts:

ChangeSet: Code changes with gitPatch (unified diff, base commit, suggested commit message)

BashOutput: Command output with command, output, exitCode

Media: Binary output with mimeType and base64 data

`Get a Single Activity`

`

bash
curl -s -H "x-goog-api-key: $JULES_API_KEY" \
  "https://jules.googleapis.com/v1alpha/sessions/SESSION_ID/activities/ACTIVITY_ID"

`





Delete a Session

`

bash
curl -s -X DELETE \
  -H "x-goog-api-key: $JULES_API_KEY" \
  "https://jules.googleapis.com/v1alpha/sessions/SESSION_ID"

`





Typical Workflow

List sources to find the repo resource name
Create a session with a prompt describing the task
Poll the session (Get Session) to track state changes
List activities to monitor progress and read Jules' messages

If requirePlanApproval was set, approve the plan when state is AWAITING_PLAN_APPROVAL

If state is AWAITING_USER_FEEDBACK, send a message with your response

When COMPLETED, get the session to find the output PR URL

`Error Handling`



| Code | Meaning |
|---|---|
| 200 | Success |
| 400 | Bad request (invalid parameters) |
| 401 | Unauthorized (invalid/missing API key) |
| 403 | Forbidden (insufficient permissions) |
| 404 | Not found |
| 429 | Rate limited |
| 500 | Server error |

Error responses return:

`

json
{
  "error": {
    "code": 400,
    "message": "Invalid session ID format",
    "status": "INVALID_ARGUMENT"
  }
}

`



Notes

Get your API key from jules.google.com/settings

Store it as the JULES_API_KEY environment variable


Sources (repos) are connected via the Jules web UI at jules.google — the API is read-only for sources

Session resource names follow the pattern sessions/{sessionId}

Activity resource names follow sessions/{sessionId}/activities/{activityId}

All list endpoints support pageSize (1-100) and pageToken` for pagination

数据来源：ClawHub ↗ · 中文优化：龙虾技能库

OpenClaw 技能定制 / 插件定制 / 私有工作流定制

免费技能或插件可能存在安全风险，如需更匹配、更安全的方案，建议联系付费定制

了解定制服务

License

运行时依赖

版本

安装命令 点击复制

技能文档

List Sources (Connected Repositories)

Get a Source

Create a Session (Start a Coding Task)

Parameters

Auto-approve + Auto-PR example

List Sessions

Get a Session

Session States

Approve a Plan

Send a Message

List Activities (Monitor Progress)

Activity Types

Artifacts

Get a Single Activity

Delete a Session

Typical Workflow

Error Handling

Notes

安装命令点击复制

`Get a Single Activity`

`Error Handling`