Document Gitea configuration and known limitations

README.md

@@ -27,12 +27,50 @@ git clone https://pfoster.dynu.net/peter/devclaw-gitea.git
 openclaw plugins install -l ./devclaw-gitea
 ```
 
-**Prerequisites:** [OpenClaw](https://openclaw.ai) must be installed and running.
+### Configuration for Gitea
 
+1. **Set Gitea Token:**
    ```bash
-openclaw plugins install @laurentenhoor/devclaw
+   export GITEA_TOKEN=your_gitea_personal_access_token
    ```
    
+   Or add to systemd override:
+   ```bash
+   mkdir -p ~/.config/systemd/user/openclaw-gateway.service.d
+   echo -e '[Service]\nEnvironment="GITEA_TOKEN=your_token"' > ~/.config/systemd/user/openclaw-gateway.service.d/override.conf
+   systemctl --user daemon-reload
+   systemctl --user restart openclaw-gateway
+   ```
+
+2. **Automatic Detection:**
+   - The Gitea provider automatically detects your Gitea instance from git remote URL
+   - Parse from `.git/config`: `https://your-gitea-domain.com/owner/repo.git`
+   - Fallback to default if parsing fails
+
+3. **Project Registration:**
+   When registering a project with DevClaw:
+   ```
+   /dev register my-project /path/to/repo development
+   ```
+   The provider auto-detects Gitea and configures accordingly.
+
+### Gitea-Specific Features
+
+- ✅ Auto-creates DevClaw workflow labels (Planning, To Do, Doing, To Test, Testing, To Improve, Refining, Done, To Design, Designing)
+- ✅ Dynamic label ID fetching with fallback
+- ✅ Issue creation, reading, and label transitions
+- ✅ Comment management
+- ✅ Retry logic with exponential backoff
+- ✅ Clear error messages for troubleshooting
+
+### Known Limitations
+
+- Label transitions sometimes require manual refresh (edge case under investigation)
+- Recommend checking Gitea UI if label doesn't update immediately
+- PR/MR detection not implemented for Gitea (use issue tracking only)
+
+**Prerequisites:** [OpenClaw](https://openclaw.ai) must be installed and running.
+
 Then start onboarding by chatting with your agent in any channel:
 ```
 "Hey, can you help me set up DevClaw?"