Skip to content

How to create a Lichess OAuth token

Mark Harrison edited this page Jul 11, 2023 · 2 revisions

Creating a lichess OAuth token

  • Create an account for your bot on Lichess.org.
  • NOTE: If you have previously played games on an existing account, you will not be able to use it as a bot account.
  • Once your account has been created and you are logged in, create a personal OAuth2 token with the "Play games with the bot API" (bot:play) scope selected and a description added.
  • A token (e.g. xxxxxxxxxxxxxxxx) will be displayed. Store this in the config.yml file as the token field. You can also set the token in the environment variable $LICHESS_BOT_TOKEN.
  • NOTE: You won't see this token again on Lichess, so do save it.

Next step: Upgrade to a BOT account

Previous step: Install lichess-bot