← Back to Plugins
Integration

Github

Boyao0305 By Boyao0305 👁 8 views ▲ 0 votes

GitHub integration plugin for OpenClaw — manage repos, issues, PRs, and more.

GitHub

Configuration Example

"plugins": {
  "entries": {
    "github": {
      "enabled": true,
      "config": {
        "token": "your_github_personal_access_token"
      }
    }
  }
}

README

# openclaw-github-plugin

A GitHub integration plugin for [OpenClaw](https://github.com/openclaw/openclaw) that gives your AI agent the ability to interact with GitHub directly from chat.

## Tools

| Tool | Description |
|------|-------------|
| `github_whoami` | Get info about the authenticated GitHub user |
| `github_list_repos` | List repositories for the authenticated user or any user/org |
| `github_get_repo` | Get details about a specific repository |
| `github_list_issues` | List issues for a repository |
| `github_create_issue` | Create a new issue |
| `github_get_issue` | Get details and comments for a specific issue |
| `github_comment_issue` | Post a comment on an issue or PR |
| `github_update_issue` | Close/reopen/edit an issue |
| `github_list_prs` | List pull requests |
| `github_get_pr` | Get PR details including changed files |
| `github_search` | Search GitHub for repos, issues, code, or users |

## Installation

Copy the plugin directory to `~/.openclaw/extensions/github/` or your workspace's `.openclaw/extensions/github/`.

Then add to your `~/.openclaw/openclaw.json`:

```json
"plugins": {
  "entries": {
    "github": {
      "enabled": true,
      "config": {
        "token": "your_github_personal_access_token"
      }
    }
  }
}
```

Restart the gateway:

```bash
openclaw gateway restart
```

## Token Permissions

Create a fine-grained PAT at [github.com/settings/tokens](https://github.com/settings/tokens) with:
- **Contents:** Read/Write
- **Issues:** Read/Write
- **Pull requests:** Read/Write
- **Metadata:** Read

## Requirements

- OpenClaw 2026.x+
- Node.js 18+ (for the gateway)
- A GitHub Personal Access Token

## Notes

- Plugin runs in-process with the OpenClaw gateway — treat it as trusted code
- Token is stored in `openclaw.json` — keep that file private
integration

Comments

Sign in to leave a comment

Loading comments...