# Pitfall Log

Project: openclaw/openclaw

Summary: Found 22 structured pitfall item(s), including 2 high/blocking item(s). Top priority: Installation risk - Installation risk requires verification.

## 1. Installation risk - Installation risk requires verification

- Severity: high
- Evidence strength: source_linked
- Finding: Project evidence flags a installation risk. Review the linked source before relying on this workflow.
- User impact: May increase setup, validation, or first-run risk for the user.
- Suggested check: Reproduce the official install and quickstart path in an isolated environment.
- Evidence: community_evidence:github | cevd_1e9d3aadd9b7439891ac5a663c132e20 | https://github.com/openclaw/openclaw/issues/90953

## 2. Security or permission risk - Security or permission risk requires verification

- Severity: high
- Evidence strength: source_linked
- Finding: Project evidence flags a security or permission risk. Review the linked source before relying on this workflow.
- User impact: May increase setup, validation, or first-run risk for the user.
- Suggested check: Reproduce the official install and quickstart path in an isolated environment.
- Evidence: community_evidence:github | cevd_ebe1d77d782b4c4381cb60880e73e967 | https://github.com/openclaw/openclaw/issues/91079

## 3. Installation risk - Installation risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Developers should check this installation risk before relying on the project: [Bug]: requiresReasoningContentOnAssistantMessages missing from ModelCompatSchema — can't replicate native DeepSeek behavior on custom providers
- User impact: Developers may fail before the first successful local run: [Bug]: requiresReasoningContentOnAssistantMessages missing from ModelCompatSchema — can't replicate native DeepSeek behavior on custom providers
- Suggested check: Before packaging this project, run the relevant install/config/quickstart check for: [Bug]: requiresReasoningContentOnAssistantMessages missing from ModelCompatSchema — can't replicate native DeepSeek behavior on custom providers. Context: Observed when using node, linux
- Guardrail: State this as source-backed community evidence, not as Doramagic reproduction.
- Evidence: failure_mode_cluster:github_issue | fmev_d724d043b4cac87bb34d373786f48074 | https://github.com/openclaw/openclaw/issues/89660

## 4. Installation risk - Installation risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Developers should check this installation risk before relying on the project: [Feature]: [Feature Request] Native payment support for AI agents via HTTP 402
- User impact: Developers may fail before the first successful local run: [Feature]: [Feature Request] Native payment support for AI agents via HTTP 402
- Suggested check: Before packaging this project, run the relevant install/config/quickstart check for: [Feature]: [Feature Request] Native payment support for AI agents via HTTP 402. Context: Observed when using node, python
- Guardrail: State this as source-backed community evidence, not as Doramagic reproduction.
- Evidence: failure_mode_cluster:github_issue | fmev_89a313a658203bd90540bbd4ca78130e | https://github.com/openclaw/openclaw/issues/91079

## 5. Installation risk - Installation risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Developers should check this installation risk before relying on the project: openclaw 2026.5.31-beta.2
- User impact: Upgrade or migration may change expected behavior: openclaw 2026.5.31-beta.2
- Suggested check: Before packaging this project, run the relevant install/config/quickstart check for: openclaw 2026.5.31-beta.2. Context: Observed when using node, docker
- Guardrail: State this as source-backed community evidence, not as Doramagic reproduction.
- Evidence: failure_mode_cluster:github_release | fmev_37cd300e078cb36a2813e08c0ca6dae0 | https://github.com/openclaw/openclaw/releases/tag/v2026.5.31-beta.2

## 6. Installation risk - Installation risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Developers should check this installation risk before relying on the project: openclaw 2026.5.31-beta.3
- User impact: Upgrade or migration may change expected behavior: openclaw 2026.5.31-beta.3
- Suggested check: Before packaging this project, run the relevant install/config/quickstart check for: openclaw 2026.5.31-beta.3. Context: Observed when using node, docker
- Guardrail: State this as source-backed community evidence, not as Doramagic reproduction.
- Evidence: failure_mode_cluster:github_release | fmev_a7b475dddb59089369065fedac8f4999 | https://github.com/openclaw/openclaw/releases/tag/v2026.5.31-beta.3

## 7. Installation risk - Installation risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Developers should check this installation risk before relying on the project: openclaw 2026.5.31-beta.4
- User impact: Upgrade or migration may change expected behavior: openclaw 2026.5.31-beta.4
- Suggested check: Before packaging this project, run the relevant install/config/quickstart check for: openclaw 2026.5.31-beta.4. Context: Observed when using node, docker
- Guardrail: State this as source-backed community evidence, not as Doramagic reproduction.
- Evidence: failure_mode_cluster:github_release | fmev_607d979b3caf7dae4f8f7d260d061ea8 | https://github.com/openclaw/openclaw/releases/tag/v2026.5.31-beta.4

## 8. Installation risk - Installation risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Developers should check this installation risk before relying on the project: openclaw 2026.6.1
- User impact: Upgrade or migration may change expected behavior: openclaw 2026.6.1
- Suggested check: Before packaging this project, run the relevant install/config/quickstart check for: openclaw 2026.6.1. Context: Observed when using node, docker, linux
- Guardrail: State this as source-backed community evidence, not as Doramagic reproduction.
- Evidence: failure_mode_cluster:github_release | fmev_6b9ef70fc1d9b84229d0ce9eea9e9b4d | https://github.com/openclaw/openclaw/releases/tag/v2026.6.1

## 9. Installation risk - Installation risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Developers should check this installation risk before relying on the project: openclaw 2026.6.1-beta.1
- User impact: Upgrade or migration may change expected behavior: openclaw 2026.6.1-beta.1
- Suggested check: Before packaging this project, run the relevant install/config/quickstart check for: openclaw 2026.6.1-beta.1. Context: Observed when using node, docker
- Guardrail: State this as source-backed community evidence, not as Doramagic reproduction.
- Evidence: failure_mode_cluster:github_release | fmev_9473262162f57db73e84e3cf9bb5b6a5 | https://github.com/openclaw/openclaw/releases/tag/v2026.6.1-beta.1

## 10. Installation risk - Installation risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Developers should check this installation risk before relying on the project: openclaw 2026.6.1-beta.2
- User impact: Upgrade or migration may change expected behavior: openclaw 2026.6.1-beta.2
- Suggested check: Before packaging this project, run the relevant install/config/quickstart check for: openclaw 2026.6.1-beta.2. Context: Observed when using node, docker, linux
- Guardrail: State this as source-backed community evidence, not as Doramagic reproduction.
- Evidence: failure_mode_cluster:github_release | fmev_71093596cc37d4d64e5bb8cd3e060330 | https://github.com/openclaw/openclaw/releases/tag/v2026.6.1-beta.2

## 11. Installation risk - Installation risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Developers should check this installation risk before relying on the project: openclaw 2026.6.1-beta.3
- User impact: Upgrade or migration may change expected behavior: openclaw 2026.6.1-beta.3
- Suggested check: Before packaging this project, run the relevant install/config/quickstart check for: openclaw 2026.6.1-beta.3. Context: Observed when using node, docker, linux
- Guardrail: State this as source-backed community evidence, not as Doramagic reproduction.
- Evidence: failure_mode_cluster:github_release | fmev_e98ec8b4469a7d77c603d3ae8ceef0e1 | https://github.com/openclaw/openclaw/releases/tag/v2026.6.1-beta.3

## 12. Installation risk - Installation risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Developers should check this installation risk before relying on the project: openclaw 2026.6.2-beta.1
- User impact: Upgrade or migration may change expected behavior: openclaw 2026.6.2-beta.1
- Suggested check: Before packaging this project, run the relevant install/config/quickstart check for: openclaw 2026.6.2-beta.1. Context: Observed when using node, docker, windows, macos
- Guardrail: State this as source-backed community evidence, not as Doramagic reproduction.
- Evidence: failure_mode_cluster:github_release | fmev_c540b672ef221deb20719b44d5f31830 | https://github.com/openclaw/openclaw/releases/tag/v2026.6.2-beta.1

## 13. Installation risk - Installation risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Developers should check this installation risk before relying on the project: openclaw 2026.6.5-beta.1
- User impact: Upgrade or migration may change expected behavior: openclaw 2026.6.5-beta.1
- Suggested check: Before packaging this project, run the relevant install/config/quickstart check for: openclaw 2026.6.5-beta.1. Context: Observed when using node, docker, macos
- Guardrail: State this as source-backed community evidence, not as Doramagic reproduction.
- Evidence: failure_mode_cluster:github_release | fmev_88bbbbf8ea900eb74c242cf56903de46 | https://github.com/openclaw/openclaw/releases/tag/v2026.6.5-beta.1

## 14. Installation risk - Installation risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Developers should check this installation risk before relying on the project: openclaw 2026.6.5-beta.2
- User impact: Upgrade or migration may change expected behavior: openclaw 2026.6.5-beta.2
- Suggested check: Before packaging this project, run the relevant install/config/quickstart check for: openclaw 2026.6.5-beta.2. Context: Observed when using node, docker, macos
- Guardrail: State this as source-backed community evidence, not as Doramagic reproduction.
- Evidence: failure_mode_cluster:github_release | fmev_eaa1479876c76a20379fd470e9e4733b | https://github.com/openclaw/openclaw/releases/tag/v2026.6.5-beta.2

## 15. Capability evidence risk - Capability evidence risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: README/documentation is current enough for a first validation pass.
- User impact: May increase setup, validation, or first-run risk for the user.
- Suggested check: Reproduce the official install and quickstart path in an isolated environment.
- Evidence: capability.assumptions | github_repo:1103012935 | https://github.com/openclaw/openclaw

## 16. Maintenance risk - Maintenance risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Project evidence flags a maintenance risk. Review the linked source before relying on this workflow.
- User impact: May increase setup, validation, or first-run risk for the user.
- Suggested check: Reproduce the official install and quickstart path in an isolated environment.
- Evidence: evidence.maintainer_signals | github_repo:1103012935 | https://github.com/openclaw/openclaw

## 17. Security or permission risk - Security or permission risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: no_demo
- User impact: May increase setup, validation, or first-run risk for the user.
- Suggested check: Reproduce the official install and quickstart path in an isolated environment.
- Evidence: downstream_validation.risk_items | github_repo:1103012935 | https://github.com/openclaw/openclaw

## 18. Security or permission risk - Security or permission risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: no_demo
- User impact: May increase setup, validation, or first-run risk for the user.
- Suggested check: Reproduce the official install and quickstart path in an isolated environment.
- Evidence: risks.scoring_risks | github_repo:1103012935 | https://github.com/openclaw/openclaw

## 19. Security or permission risk - Security or permission risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Project evidence flags a security or permission risk. Review the linked source before relying on this workflow.
- User impact: May increase setup, validation, or first-run risk for the user.
- Suggested check: Reproduce the official install and quickstart path in an isolated environment.
- Evidence: community_evidence:github | cevd_68a0769a516140f08636035f16f38c58 | https://github.com/openclaw/openclaw/issues/91090

## 20. Security or permission risk - Security or permission risk requires verification

- Severity: medium
- Evidence strength: source_linked
- Finding: Project evidence flags a security or permission risk. Review the linked source before relying on this workflow.
- User impact: May increase setup, validation, or first-run risk for the user.
- Suggested check: Reproduce the official install and quickstart path in an isolated environment.
- Evidence: community_evidence:github | cevd_ad548e2553b54d0880227fee57de5404 | https://github.com/openclaw/openclaw/issues/89660

## 21. Maintenance risk - Maintenance risk requires verification

- Severity: low
- Evidence strength: source_linked
- Finding: issue_or_pr_quality=unknown。
- User impact: May increase setup, validation, or first-run risk for the user.
- Suggested check: Reproduce the official install and quickstart path in an isolated environment.
- Evidence: evidence.maintainer_signals | github_repo:1103012935 | https://github.com/openclaw/openclaw

## 22. Maintenance risk - Maintenance risk requires verification

- Severity: low
- Evidence strength: source_linked
- Finding: release_recency=unknown。
- User impact: May increase setup, validation, or first-run risk for the user.
- Suggested check: Reproduce the official install and quickstart path in an isolated environment.
- Evidence: evidence.maintainer_signals | github_repo:1103012935 | https://github.com/openclaw/openclaw