atomgit - AtomGit/GitCode API 技能

直接调用 AtomGit/GitCode OpenAPI v5，通过 curl 命令执行操作。

注意：AtomGit (atomgit.com) 和 GitCode (gitcode.com) 是同一平台的不同域名，共享相同的 API 后端。无论使用哪个域名，API 端点都相同。

前置条件

1. 1. AtomGit/GitCode Token - 访问以下任一地址生成：

- https://gitcode.com/setting/token-classic - https://atomgit.com/setting/token-classic

1. 2. 权限：api, readuser, readrepository, writerepository, issues, pullrequests

Token 在两个平台通用，因为后端是同一套系统。

配置方法

方式一：Gateway 配置（推荐）

编辑 ~/.openclaw/openclaw.json，添加 skill 配置：

json
{
skills: {
entries: {
atomgit: {
enabled: true,
env: {
ATOMGIT_TOKEN: your-token-here
}
}
}
}
}

或使用环境变量占位符：

json
{
skills: {
entries: {
atomgit: {
enabled: true,
env: {
ATOMGITTOKEN: ATOMGITTOKEN
}
}
}
}
}

然后在终端设置环境变量：

bash
export ATOMGIT_TOKEN=your-token-here

方式二：终端环境变量

直接在终端设置：

bash
export ATOMGIT_TOKEN=your-token-here

API 信息

• - Base URL:

- https://api.gitcode.com/api/v5 (推荐) - https://api.atomgit.com/api/v5 (等效)

• - 认证: Authorization: Bearer
• 速率限制: 50 次/分钟

两个 API 端点完全等效，数据互通。

---

完整 API 接口列表 (294 个端点)

一、用户 API (User) - 42 个端点

✅ 已验证可用的接口

bash

获取当前用户信息

curl -H Authorization: Bearer $TOKEN https://api.gitcode.com/api/v5/user

获取当前用户邮箱

curl -H Authorization: Bearer $TOKEN https://api.gitcode.com/api/v5/user/emails

获取当前用户仓库列表

curl -H Authorization: Bearer $TOKEN https://api.gitcode.com/api/v5/user/repos?per_page=20

获取当前用户收藏的仓库

curl -H Authorization: Bearer $TOKEN https://api.gitcode.com/api/v5/user/starred

获取当前用户订阅的仓库

curl -H Authorization: Bearer $TOKEN https://api.gitcode.com/api/v5/user/subscriptions

获取指定用户信息

curl -H Authorization: Bearer $TOKEN https://api.gitcode.com/api/v5/users/:username

获取指定用户的仓库

curl -H Authorization: Bearer $TOKEN https://api.gitcode.com/api/v5/users/:username/repos

获取指定用户收藏的仓库

curl -H Authorization: Bearer $TOKEN https://api.gitcode.com/api/v5/users/:username/starred

获取用户的组织

curl -H Authorization: Bearer $TOKEN https://api.gitcode.com/api/v5/users/:username/orgs

获取当前用户的组织

curl -H Authorization: Bearer $TOKEN https://api.gitcode.com/api/v5/user/orgs

添加 SSH 密钥

curl -X POST -H Authorization: Bearer $TOKEN -H Content-Type: application/json \ -d {title:My Key,key:ssh-rsa AAA...} \ https://api.gitcode.com/api/v5/user/keys

获取 SSH 密钥列表

curl -H Authorization: Bearer $TOKEN https://api.gitcode.com/api/v5/user/keys

删除 SSH 密钥

curl -X DELETE -H Authorization: Bearer $TOKEN \ https://api.gitcode.com/api/v5/user/keys/:id

---

二、仓库 API (Repository) - 168 个端点

✅ 已验证可用的接口

bash

获取仓库详情

curl -H Authorization: Bearer $TOKEN https://api.gitcode.com/api/v5/repos/:owner/:repo

获取仓库分支列表

curl -H Authorization: Bearer $TOKEN https://api.gitcode.com/api/v5/repos/:owner/:repo/branches

获取仓库提交列表

curl -H Authorization: Bearer $TOKEN https://api.gitcode.com/api/v5/repos/:owner/:repo/commits

获取单个提交详情

curl -H Authorization: Bearer $TOKEN https://api.gitcode.com/api/v5/repos/:owner/:repo/commits/:sha

获取提交 diff

curl -H Authorization: Bearer $TOKEN https://api.gitcode.com/api/v5/repos/:owner/:repo/commits/:sha/diff

获取仓库标签列表

curl -H Authorization: Bearer $TOKEN https://api.gitcode.com/api/v5/repos/:owner/:repo/tags

获取文件内容

curl -H Authorization: Bearer $TOKEN https://api.gitcode.com/api/v5/repos/:owner/:repo/contents/:path

获取目录树

curl -H Authorization: Bearer $TOKEN https://api.gitcode.com/api/v5/repos/:owner/:repo/git/trees/:sha

获取贡献者列表

curl -H Authorization: Bearer $TOKEN https://api.gitcode.com/api/v5/repos/:owner/:repo/contributors

获取语言统计

curl -H Authorization: Bearer $TOKEN https://api.gitcode.com/api/v5/repos/:owner/:repo/languages

获取 Star 用户列表

curl -H Authorization: Bearer $TOKEN https://api.gitcode.com/api/v5/repos/:owner/:repo/stargazers

获取 Fork 列表

curl -H Authorization: Bearer $TOKEN https://api.gitcode.com/api/v5/repos/:owner/:repo/forks

获取协作者列表

curl -H Authorization: Bearer $TOKEN https://api.gitcode.com/api/v5/repos/:owner/:repo/collaborators

获取 Webhook 列表

curl -H Authorization: Bearer $TOKEN https://api.gitcode.com/api/v5/repos/:owner/:repo/hooks

获取版本列表

curl -H Authorization: Bearer $TOKEN https://api.gitcode.com/api/v5/repos/:owner/:repo/releases

获取仓库通知

curl -H Authorization: Bearer $TOKEN https://api.gitcode.com/api/v5/repos/:owner/:repo/notifications

创建用户仓库

curl -X POST -H Authorization: Bearer $TOKEN -H Content-Type: application/json \ -d {name:my-repo,description:My repo,private:false,auto_init:true} \ https://api.gitcode.com/api/v5/user/repos

创建组织仓库

curl -X POST -H Authorization: Bearer $TOKEN -H Content-Type: application/json \ -d {name:org-repo,description:Org repo} \ https://api.gitcode.com/api/v5/orgs/:org/repos

更新仓库

curl -X PUT -H Authorization: Bearer $TOKEN -H Content-Type: application/json \ -d {description:New description,private:false} \ https://api.gitcode.com/api/v5/repos/:owner/:repo

删除仓库 ⚠️

curl -X DELETE -H Authorization: Bearer $TOKEN \ https://api.gitcode.com/api/v5/repos/:owner/:repo

Fork 仓库

curl -X POST -H Authorization: Bearer $TOKEN \ https://api.gitcode.com/api/v5/repos/:owner/:repo/forks

转移仓库

curl -X POST -H Authorization: Bearer $TOKEN -H Content-Type: application/json \ -d {new_owner:new-owner} \ https://api.gitcode.com/api/v5/repos/:owner/:repo/transfer

⚠️ 已知问题的接口

bash

获取文件列表 - 404 Not Found

curl -H