5db883b453
Some OpenAI models (o1, o3, o4, gpt-5 variants) only accept temperature=1.0 and return errors with other values like 0.7. This change automatically adjusts the temperature parameter based on the model being used. Changes: - Add adjust_temperature_for_model() function to detect reasoning models - Apply temperature adjustment in chat_with_system(), chat(), and chat_with_tools() - Preserve user-specified temperature for standard models (gpt-4o, gpt-4-turbo, etc.) - Force temperature=1.0 for reasoning models (o1, o3, o4, gpt-5, gpt-5-mini, gpt-5-nano, gpt-5.x-chat-latest) Testing: - Add 7 unit tests covering reasoning models, standard models, and edge cases - All tests pass successfully - Empirical testing documented in docs/openai-temperature-compatibility.md Impact: - Fixes temperature errors when using o1, o3, o4, and gpt-5 model families - No breaking changes - transparent adjustment for end users - Standard models continue to work with flexible temperature values Risk: Low - isolated change within OpenAI provider, well-tested Rollback: Revert this commit to restore previous behavior Co-authored-by: Argenis <theonlyhennygod@gmail.com> |
||
|---|---|---|
| .. | ||
| assets | ||
| contributing | ||
| hardware | ||
| i18n | ||
| maintainers | ||
| ops | ||
| reference | ||
| security | ||
| setup-guides | ||
| vi | ||
| openai-temperature-compatibility.md | ||
| README.ar.md | ||
| README.bn.md | ||
| README.cs.md | ||
| README.da.md | ||
| README.de.md | ||
| README.el.md | ||
| README.es.md | ||
| README.fi.md | ||
| README.fr.md | ||
| README.he.md | ||
| README.hi.md | ||
| README.hu.md | ||
| README.id.md | ||
| README.it.md | ||
| README.ja.md | ||
| README.ko.md | ||
| README.md | ||
| README.nb.md | ||
| README.nl.md | ||
| README.pl.md | ||
| README.pt.md | ||
| README.ro.md | ||
| README.ru.md | ||
| README.sv.md | ||
| README.th.md | ||
| README.tl.md | ||
| README.tr.md | ||
| README.uk.md | ||
| README.ur.md | ||
| README.vi.md | ||
| README.zh-CN.md | ||
| SUMMARY.ar.md | ||
| SUMMARY.bn.md | ||
| SUMMARY.cs.md | ||
| SUMMARY.da.md | ||
| SUMMARY.de.md | ||
| SUMMARY.el.md | ||
| SUMMARY.es.md | ||
| SUMMARY.fi.md | ||
| SUMMARY.fr.md | ||
| SUMMARY.he.md | ||
| SUMMARY.hi.md | ||
| SUMMARY.hu.md | ||
| SUMMARY.id.md | ||
| SUMMARY.it.md | ||
| SUMMARY.ja.md | ||
| SUMMARY.ko.md | ||
| SUMMARY.md | ||
| SUMMARY.nb.md | ||
| SUMMARY.nl.md | ||
| SUMMARY.pl.md | ||
| SUMMARY.pt.md | ||
| SUMMARY.ro.md | ||
| SUMMARY.ru.md | ||
| SUMMARY.sv.md | ||
| SUMMARY.th.md | ||
| SUMMARY.tl.md | ||
| SUMMARY.tr.md | ||
| SUMMARY.uk.md | ||
| SUMMARY.ur.md | ||
| SUMMARY.vi.md | ||
| SUMMARY.zh-CN.md | ||
ZeroClaw Documentation Hub
This page is the primary entry point for the documentation system.
Last refreshed: February 21, 2026.
Localized hubs: العربية · বাংলা · Čeština · Dansk · Deutsch · Ελληνικά · Español · Suomi · Français · עברית · हिन्दी · Magyar · Bahasa Indonesia · Italiano · 日本語 · 한국어 · Norsk Bokmål · Nederlands · Polski · Português · Română · Русский · Svenska · ไทย · Tagalog · Türkçe · Українська · اردو · Tiếng Việt · 简体中文.
Start Here
| I want to… | Read this |
|---|---|
| Install and run ZeroClaw quickly | README.md (Quick Start) |
| Bootstrap in one command | one-click-bootstrap.md |
| Update or uninstall on macOS | macos-update-uninstall.md |
| Find commands by task | commands-reference.md |
| Check config defaults and keys quickly | config-reference.md |
| Configure custom providers/endpoints | custom-providers.md |
| Configure Z.AI / GLM provider | zai-glm-setup.md |
| Use LangGraph integration patterns | langgraph-integration.md |
| Operate runtime (day-2 runbook) | operations-runbook.md |
| Troubleshoot install/runtime/channel issues | troubleshooting.md |
| Run Matrix encrypted-room setup and diagnostics | matrix-e2ee-guide.md |
| Browse docs by category | SUMMARY.md |
| See project PR/issue docs snapshot | project-triage-snapshot-2026-02-18.md |
Quick Decision Tree (10 seconds)
- Need first-time setup or install? → setup-guides/README.md
- Need exact CLI/config keys? → reference/README.md
- Need production/service operations? → ops/README.md
- Seeing failures or regressions? → troubleshooting.md
- Working on security hardening or roadmap? → security/README.md
- Working with boards/peripherals? → hardware/README.md
- Contributing/reviewing/CI workflow? → contributing/README.md
- Want the full map? → SUMMARY.md
Collections (Recommended)
- Getting started: setup-guides/README.md
- Reference catalogs: reference/README.md
- Operations & deployment: ops/README.md
- Security docs: security/README.md
- Hardware/peripherals: hardware/README.md
- Contributing/CI: contributing/README.md
- Project snapshots: maintainers/README.md
By Audience
Users / Operators
- commands-reference.md — command lookup by workflow
- providers-reference.md — provider IDs, aliases, credential env vars
- channels-reference.md — channel capabilities and setup paths
- matrix-e2ee-guide.md — Matrix encrypted-room (E2EE) setup and no-response diagnostics
- config-reference.md — high-signal config keys and secure defaults
- custom-providers.md — custom provider/base URL integration templates
- zai-glm-setup.md — Z.AI/GLM setup and endpoint matrix
- langgraph-integration.md — fallback integration for model/tool-calling edge cases
- operations-runbook.md — day-2 runtime operations and rollback flow
- troubleshooting.md — common failure signatures and recovery steps
Contributors / Maintainers
Security / Reliability
Note: this area includes proposal/roadmap docs. For current behavior, start with config-reference.md, operations-runbook.md, and troubleshooting.md.
- security/README.md
- agnostic-security.md
- frictionless-security.md
- sandboxing.md
- audit-logging.md
- resource-limits.md
- security-roadmap.md
System Navigation & Governance
- Unified TOC: SUMMARY.md
- Docs structure map (language/part/function): structure/README.md
- Documentation inventory/classification: docs-inventory.md
- i18n docs index: i18n/README.md
- i18n coverage map: i18n-coverage.md
- Project triage snapshot: project-triage-snapshot-2026-02-18.md