@quantumclaw/quantumclaw 2026.3.22
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +4601 -0
- package/LICENSE +21 -0
- package/README.md +559 -0
- package/assets/avatar-placeholder.svg +19 -0
- package/assets/chrome-extension/icons/icon128.png +0 -0
- package/assets/chrome-extension/icons/icon16.png +0 -0
- package/assets/chrome-extension/icons/icon32.png +0 -0
- package/assets/chrome-extension/icons/icon48.png +0 -0
- package/assets/dmg-background-small.png +0 -0
- package/assets/dmg-background.png +0 -0
- package/docs/.i18n/README.md +31 -0
- package/docs/.i18n/glossary.ja-JP.json +14 -0
- package/docs/.i18n/glossary.zh-CN.json +302 -0
- package/docs/.i18n/ja-JP.tm.jsonl +0 -0
- package/docs/assets/install-script.svg +1 -0
- package/docs/assets/macos-onboarding/01-macos-warning.jpeg +0 -0
- package/docs/assets/macos-onboarding/02-local-networks.jpeg +0 -0
- package/docs/assets/macos-onboarding/03-security-notice.png +0 -0
- package/docs/assets/macos-onboarding/04-choose-gateway.png +0 -0
- package/docs/assets/macos-onboarding/05-permissions.png +0 -0
- package/docs/assets/pixel-lobster.svg +60 -0
- package/docs/assets/quantumclaw-logo-text-dark.png +0 -0
- package/docs/assets/quantumclaw-logo-text-dark.svg +418 -0
- package/docs/assets/quantumclaw-logo-text.png +0 -0
- package/docs/assets/quantumclaw-logo-text.svg +418 -0
- package/docs/assets/showcase/agents-ui.jpg +0 -0
- package/docs/assets/showcase/bambu-cli.png +0 -0
- package/docs/assets/showcase/codexmonitor.png +0 -0
- package/docs/assets/showcase/gohome-grafana.png +0 -0
- package/docs/assets/showcase/ios-testflight.jpg +0 -0
- package/docs/assets/showcase/oura-health.png +0 -0
- package/docs/assets/showcase/padel-cli.svg +11 -0
- package/docs/assets/showcase/padel-screenshot.jpg +0 -0
- package/docs/assets/showcase/papla-tts.jpg +0 -0
- package/docs/assets/showcase/pr-review-telegram.jpg +0 -0
- package/docs/assets/showcase/roborock-screenshot.jpg +0 -0
- package/docs/assets/showcase/roborock-status.svg +13 -0
- package/docs/assets/showcase/roof-camera-sky.jpg +0 -0
- package/docs/assets/showcase/snag.png +0 -0
- package/docs/assets/showcase/tesco-shop.jpg +0 -0
- package/docs/assets/showcase/wienerlinien.png +0 -0
- package/docs/assets/showcase/wine-cellar-skill.jpg +0 -0
- package/docs/assets/showcase/winix-air-purifier.jpg +0 -0
- package/docs/assets/showcase/xuezh-pronunciation.jpeg +0 -0
- package/docs/assets/sponsors/blacksmith.svg +14 -0
- package/docs/assets/sponsors/convex.svg +16 -0
- package/docs/assets/sponsors/openai.svg +3 -0
- package/docs/assets/sponsors/vercel.svg +5 -0
- package/docs/auth-credential-semantics.md +53 -0
- package/docs/automation/auth-monitoring.md +44 -0
- package/docs/automation/cron-jobs.md +727 -0
- package/docs/automation/cron-vs-heartbeat.md +286 -0
- package/docs/automation/gmail-pubsub.md +256 -0
- package/docs/automation/hooks.md +1056 -0
- package/docs/automation/poll.md +86 -0
- package/docs/automation/standing-orders.md +251 -0
- package/docs/automation/troubleshooting.md +122 -0
- package/docs/automation/webhook.md +217 -0
- package/docs/brave-search.md +93 -0
- package/docs/channels/bluebubbles.md +347 -0
- package/docs/channels/broadcast-groups.md +442 -0
- package/docs/channels/channel-routing.md +139 -0
- package/docs/channels/discord.md +1229 -0
- package/docs/channels/feishu.md +747 -0
- package/docs/channels/googlechat.md +261 -0
- package/docs/channels/group-messages.md +84 -0
- package/docs/channels/groups.md +379 -0
- package/docs/channels/imessage.md +367 -0
- package/docs/channels/index.md +47 -0
- package/docs/channels/irc.md +242 -0
- package/docs/channels/line.md +194 -0
- package/docs/channels/location.md +56 -0
- package/docs/channels/matrix.md +677 -0
- package/docs/channels/mattermost.md +427 -0
- package/docs/channels/msteams.md +780 -0
- package/docs/channels/nextcloud-talk.md +138 -0
- package/docs/channels/nostr.md +249 -0
- package/docs/channels/pairing.md +114 -0
- package/docs/channels/signal.md +329 -0
- package/docs/channels/slack.md +603 -0
- package/docs/channels/synology-chat.md +134 -0
- package/docs/channels/telegram.md +987 -0
- package/docs/channels/tlon.md +276 -0
- package/docs/channels/troubleshooting.md +118 -0
- package/docs/channels/twitch.md +379 -0
- package/docs/channels/whatsapp.md +460 -0
- package/docs/channels/zalo.md +243 -0
- package/docs/channels/zalouser.md +181 -0
- package/docs/ci.md +55 -0
- package/docs/cli/acp.md +288 -0
- package/docs/cli/agent.md +29 -0
- package/docs/cli/agents.md +123 -0
- package/docs/cli/approvals.md +50 -0
- package/docs/cli/backup.md +76 -0
- package/docs/cli/browser.md +106 -0
- package/docs/cli/channels.md +102 -0
- package/docs/cli/clawbot.md +21 -0
- package/docs/cli/completion.md +35 -0
- package/docs/cli/config.md +295 -0
- package/docs/cli/configure.md +36 -0
- package/docs/cli/cron.md +77 -0
- package/docs/cli/daemon.md +53 -0
- package/docs/cli/dashboard.md +22 -0
- package/docs/cli/devices.md +139 -0
- package/docs/cli/directory.md +63 -0
- package/docs/cli/dns.md +23 -0
- package/docs/cli/docs.md +15 -0
- package/docs/cli/doctor.md +48 -0
- package/docs/cli/gateway.md +235 -0
- package/docs/cli/health.md +21 -0
- package/docs/cli/hooks.md +329 -0
- package/docs/cli/index.md +1150 -0
- package/docs/cli/logs.md +28 -0
- package/docs/cli/memory.md +66 -0
- package/docs/cli/message.md +278 -0
- package/docs/cli/models.md +81 -0
- package/docs/cli/node.md +127 -0
- package/docs/cli/nodes.md +75 -0
- package/docs/cli/onboard.md +157 -0
- package/docs/cli/pairing.md +32 -0
- package/docs/cli/plugins.md +210 -0
- package/docs/cli/qr.md +46 -0
- package/docs/cli/reset.md +20 -0
- package/docs/cli/sandbox.md +197 -0
- package/docs/cli/secrets.md +188 -0
- package/docs/cli/security.md +79 -0
- package/docs/cli/sessions.md +110 -0
- package/docs/cli/setup.md +29 -0
- package/docs/cli/skills.md +36 -0
- package/docs/cli/status.md +30 -0
- package/docs/cli/system.md +60 -0
- package/docs/cli/tui.md +30 -0
- package/docs/cli/uninstall.md +20 -0
- package/docs/cli/update.md +103 -0
- package/docs/cli/voicecall.md +34 -0
- package/docs/cli/webhooks.md +25 -0
- package/docs/concepts/agent-loop.md +148 -0
- package/docs/concepts/agent-workspace.md +236 -0
- package/docs/concepts/agent.md +122 -0
- package/docs/concepts/architecture.md +137 -0
- package/docs/concepts/compaction.md +123 -0
- package/docs/concepts/context-engine.md +268 -0
- package/docs/concepts/context.md +172 -0
- package/docs/concepts/delegate-architecture.md +296 -0
- package/docs/concepts/features.md +73 -0
- package/docs/concepts/markdown-formatting.md +130 -0
- package/docs/concepts/memory.md +108 -0
- package/docs/concepts/messages.md +154 -0
- package/docs/concepts/model-failover.md +152 -0
- package/docs/concepts/model-providers.md +607 -0
- package/docs/concepts/models.md +225 -0
- package/docs/concepts/multi-agent.md +552 -0
- package/docs/concepts/oauth.md +158 -0
- package/docs/concepts/presence.md +102 -0
- package/docs/concepts/queue.md +89 -0
- package/docs/concepts/retry.md +69 -0
- package/docs/concepts/session-pruning.md +121 -0
- package/docs/concepts/session-tool.md +242 -0
- package/docs/concepts/session.md +310 -0
- package/docs/concepts/streaming.md +155 -0
- package/docs/concepts/system-prompt.md +132 -0
- package/docs/concepts/timezone.md +91 -0
- package/docs/concepts/typebox.md +291 -0
- package/docs/concepts/typing-indicators.md +68 -0
- package/docs/concepts/usage-tracking.md +35 -0
- package/docs/date-time.md +128 -0
- package/docs/debug/node-issue.md +85 -0
- package/docs/diagnostics/flags.md +91 -0
- package/docs/docs.json +2078 -0
- package/docs/gateway/authentication.md +179 -0
- package/docs/gateway/background-process.md +97 -0
- package/docs/gateway/bonjour.md +177 -0
- package/docs/gateway/bridge-protocol.md +91 -0
- package/docs/gateway/cli-backends.md +225 -0
- package/docs/gateway/configuration-examples.md +651 -0
- package/docs/gateway/configuration-reference.md +3123 -0
- package/docs/gateway/configuration.md +633 -0
- package/docs/gateway/discovery.md +123 -0
- package/docs/gateway/doctor.md +362 -0
- package/docs/gateway/gateway-lock.md +34 -0
- package/docs/gateway/health.md +44 -0
- package/docs/gateway/heartbeat.md +393 -0
- package/docs/gateway/index.md +261 -0
- package/docs/gateway/local-models.md +152 -0
- package/docs/gateway/logging.md +113 -0
- package/docs/gateway/multiple-gateways.md +112 -0
- package/docs/gateway/network-model.md +22 -0
- package/docs/gateway/openai-http-api.md +132 -0
- package/docs/gateway/openresponses-http-api.md +295 -0
- package/docs/gateway/openshell.md +307 -0
- package/docs/gateway/pairing.md +99 -0
- package/docs/gateway/protocol.md +267 -0
- package/docs/gateway/remote-gateway-readme.md +158 -0
- package/docs/gateway/remote.md +153 -0
- package/docs/gateway/sandbox-vs-tool-policy-vs-elevated.md +134 -0
- package/docs/gateway/sandboxing.md +469 -0
- package/docs/gateway/secrets-plan-contract.md +116 -0
- package/docs/gateway/secrets.md +503 -0
- package/docs/gateway/security/index.md +1220 -0
- package/docs/gateway/tailscale.md +132 -0
- package/docs/gateway/tools-invoke-http-api.md +118 -0
- package/docs/gateway/troubleshooting.md +378 -0
- package/docs/gateway/trusted-proxy-auth.md +330 -0
- package/docs/help/debugging.md +168 -0
- package/docs/help/environment.md +163 -0
- package/docs/help/faq.md +2997 -0
- package/docs/help/index.md +28 -0
- package/docs/help/scripts.md +28 -0
- package/docs/help/testing.md +526 -0
- package/docs/help/troubleshooting.md +297 -0
- package/docs/images/configure-model-picker-unsearchable.png +0 -0
- package/docs/images/feishu-step2-create-app.png +0 -0
- package/docs/images/feishu-step3-credentials.png +0 -0
- package/docs/images/feishu-step4-permissions.png +0 -0
- package/docs/images/feishu-step5-bot-capability.png +0 -0
- package/docs/images/feishu-step6-event-subscription.png +0 -0
- package/docs/images/feishu-verification-token.png +0 -0
- package/docs/images/groups-flow.svg +52 -0
- package/docs/images/mobile-ui-screenshot.png +0 -0
- package/docs/index.md +196 -0
- package/docs/install/ansible.md +230 -0
- package/docs/install/azure.md +311 -0
- package/docs/install/bun.md +55 -0
- package/docs/install/development-channels.md +120 -0
- package/docs/install/digitalocean.md +129 -0
- package/docs/install/docker-vm-runtime.md +142 -0
- package/docs/install/docker.md +375 -0
- package/docs/install/exe-dev.md +126 -0
- package/docs/install/fly.md +501 -0
- package/docs/install/gcp.md +402 -0
- package/docs/install/hetzner.md +251 -0
- package/docs/install/index.md +183 -0
- package/docs/install/installer.md +415 -0
- package/docs/install/kubernetes.md +191 -0
- package/docs/install/macos-vm.md +281 -0
- package/docs/install/migrating-matrix.md +346 -0
- package/docs/install/migrating.md +110 -0
- package/docs/install/nix.md +89 -0
- package/docs/install/node.md +138 -0
- package/docs/install/northflank.mdx +54 -0
- package/docs/install/oracle.md +156 -0
- package/docs/install/podman.md +133 -0
- package/docs/install/railway.mdx +100 -0
- package/docs/install/raspberry-pi.md +159 -0
- package/docs/install/render.mdx +169 -0
- package/docs/install/uninstall.md +128 -0
- package/docs/install/updating.md +128 -0
- package/docs/ja-JP/index.md +186 -0
- package/docs/ja-JP/start/getting-started.md +125 -0
- package/docs/ja-JP/start/wizard.md +77 -0
- package/docs/logging.md +352 -0
- package/docs/nav-tabs-underline.js +100 -0
- package/docs/network.md +54 -0
- package/docs/nodes/audio.md +187 -0
- package/docs/nodes/camera.md +162 -0
- package/docs/nodes/images.md +72 -0
- package/docs/nodes/index.md +393 -0
- package/docs/nodes/location-command.md +98 -0
- package/docs/nodes/media-understanding.md +394 -0
- package/docs/nodes/talk.md +92 -0
- package/docs/nodes/troubleshooting.md +114 -0
- package/docs/nodes/voicewake.md +66 -0
- package/docs/perplexity.md +174 -0
- package/docs/pi-dev.md +80 -0
- package/docs/pi.md +567 -0
- package/docs/platforms/android.md +168 -0
- package/docs/platforms/digitalocean.md +266 -0
- package/docs/platforms/index.md +54 -0
- package/docs/platforms/ios.md +220 -0
- package/docs/platforms/linux.md +94 -0
- package/docs/platforms/mac/bundled-gateway.md +73 -0
- package/docs/platforms/mac/canvas.md +125 -0
- package/docs/platforms/mac/child-process.md +69 -0
- package/docs/platforms/mac/dev-setup.md +104 -0
- package/docs/platforms/mac/health.md +34 -0
- package/docs/platforms/mac/icon.md +31 -0
- package/docs/platforms/mac/logging.md +57 -0
- package/docs/platforms/mac/menu-bar.md +81 -0
- package/docs/platforms/mac/peekaboo.md +65 -0
- package/docs/platforms/mac/permissions.md +50 -0
- package/docs/platforms/mac/remote.md +84 -0
- package/docs/platforms/mac/signing.md +47 -0
- package/docs/platforms/mac/skills.md +33 -0
- package/docs/platforms/mac/voice-overlay.md +60 -0
- package/docs/platforms/mac/voicewake.md +67 -0
- package/docs/platforms/mac/webchat.md +43 -0
- package/docs/platforms/mac/xpc.md +61 -0
- package/docs/platforms/macos.md +226 -0
- package/docs/platforms/oracle.md +303 -0
- package/docs/platforms/raspberry-pi.md +412 -0
- package/docs/platforms/windows.md +241 -0
- package/docs/plugins/agent-tools.md +10 -0
- package/docs/plugins/architecture.md +1366 -0
- package/docs/plugins/building-extensions.md +10 -0
- package/docs/plugins/building-plugins.md +239 -0
- package/docs/plugins/bundles.md +181 -0
- package/docs/plugins/community.md +145 -0
- package/docs/plugins/manifest.md +241 -0
- package/docs/plugins/sdk-channel-plugins.md +370 -0
- package/docs/plugins/sdk-entrypoints.md +161 -0
- package/docs/plugins/sdk-migration.md +172 -0
- package/docs/plugins/sdk-overview.md +196 -0
- package/docs/plugins/sdk-provider-plugins.md +370 -0
- package/docs/plugins/sdk-runtime.md +345 -0
- package/docs/plugins/sdk-setup.md +331 -0
- package/docs/plugins/sdk-testing.md +263 -0
- package/docs/plugins/voice-call.md +380 -0
- package/docs/plugins/zalouser.md +77 -0
- package/docs/prose.md +134 -0
- package/docs/providers/anthropic.md +259 -0
- package/docs/providers/bedrock.md +176 -0
- package/docs/providers/claude-max-api-proxy.md +154 -0
- package/docs/providers/cloudflare-ai-gateway.md +71 -0
- package/docs/providers/deepgram.md +93 -0
- package/docs/providers/github-copilot.md +72 -0
- package/docs/providers/glm.md +43 -0
- package/docs/providers/google.md +78 -0
- package/docs/providers/groq.md +96 -0
- package/docs/providers/huggingface.md +209 -0
- package/docs/providers/index.md +69 -0
- package/docs/providers/kilocode.md +74 -0
- package/docs/providers/litellm.md +154 -0
- package/docs/providers/minimax.md +224 -0
- package/docs/providers/mistral.md +54 -0
- package/docs/providers/models.md +45 -0
- package/docs/providers/modelstudio.md +66 -0
- package/docs/providers/moonshot.md +175 -0
- package/docs/providers/nvidia.md +55 -0
- package/docs/providers/ollama.md +352 -0
- package/docs/providers/openai.md +303 -0
- package/docs/providers/opencode-go.md +45 -0
- package/docs/providers/opencode.md +64 -0
- package/docs/providers/openrouter.md +37 -0
- package/docs/providers/perplexity-provider.md +62 -0
- package/docs/providers/qianfan.md +38 -0
- package/docs/providers/qwen.md +53 -0
- package/docs/providers/sglang.md +104 -0
- package/docs/providers/synthetic.md +99 -0
- package/docs/providers/together.md +66 -0
- package/docs/providers/venice.md +282 -0
- package/docs/providers/vercel-ai-gateway.md +60 -0
- package/docs/providers/vllm.md +92 -0
- package/docs/providers/volcengine.md +74 -0
- package/docs/providers/xai.md +60 -0
- package/docs/providers/xiaomi.md +86 -0
- package/docs/providers/zai.md +46 -0
- package/docs/reference/AGENTS.default.md +126 -0
- package/docs/reference/RELEASING.md +42 -0
- package/docs/reference/api-usage-costs.md +144 -0
- package/docs/reference/credits.md +30 -0
- package/docs/reference/device-models.md +47 -0
- package/docs/reference/memory-config.md +711 -0
- package/docs/reference/prompt-caching.md +185 -0
- package/docs/reference/rpc.md +43 -0
- package/docs/reference/secretref-credential-surface.md +140 -0
- package/docs/reference/secretref-user-supplied-credentials-matrix.json +563 -0
- package/docs/reference/session-management-compaction.md +324 -0
- package/docs/reference/templates/AGENTS.dev.md +83 -0
- package/docs/reference/templates/AGENTS.md +219 -0
- package/docs/reference/templates/BOOT.md +11 -0
- package/docs/reference/templates/BOOTSTRAP.md +62 -0
- package/docs/reference/templates/HEARTBEAT.md +14 -0
- package/docs/reference/templates/IDENTITY.dev.md +47 -0
- package/docs/reference/templates/IDENTITY.md +29 -0
- package/docs/reference/templates/SOUL.dev.md +76 -0
- package/docs/reference/templates/SOUL.md +43 -0
- package/docs/reference/templates/TOOLS.dev.md +24 -0
- package/docs/reference/templates/TOOLS.md +47 -0
- package/docs/reference/templates/USER.dev.md +18 -0
- package/docs/reference/templates/USER.md +23 -0
- package/docs/reference/test.md +90 -0
- package/docs/reference/token-use.md +175 -0
- package/docs/reference/transcript-hygiene.md +151 -0
- package/docs/reference/wizard.md +235 -0
- package/docs/security/CONTRIBUTING-THREAT-MODEL.md +98 -0
- package/docs/security/THREAT-MODEL-ATLAS.md +611 -0
- package/docs/security/formal-verification.md +167 -0
- package/docs/start/bootstrapping.md +41 -0
- package/docs/start/docs-directory.md +66 -0
- package/docs/start/getting-started.md +116 -0
- package/docs/start/hubs.md +198 -0
- package/docs/start/lore.md +219 -0
- package/docs/start/onboarding-overview.md +67 -0
- package/docs/start/onboarding.md +91 -0
- package/docs/start/openclaw.md +221 -0
- package/docs/start/quickstart.md +22 -0
- package/docs/start/setup.md +164 -0
- package/docs/start/showcase.md +418 -0
- package/docs/start/wizard-cli-automation.md +215 -0
- package/docs/start/wizard-cli-reference.md +299 -0
- package/docs/start/wizard.md +125 -0
- package/docs/style.css +37 -0
- package/docs/tools/acp-agents.md +623 -0
- package/docs/tools/agent-send.md +100 -0
- package/docs/tools/apply-patch.md +51 -0
- package/docs/tools/brave-search.md +93 -0
- package/docs/tools/browser-linux-troubleshooting.md +138 -0
- package/docs/tools/browser-login.md +73 -0
- package/docs/tools/browser-wsl2-windows-remote-cdp-troubleshooting.md +211 -0
- package/docs/tools/browser.md +731 -0
- package/docs/tools/btw.md +142 -0
- package/docs/tools/capability-cookbook.md +119 -0
- package/docs/tools/clawhub.md +298 -0
- package/docs/tools/creating-skills.md +117 -0
- package/docs/tools/diffs.md +386 -0
- package/docs/tools/elevated.md +114 -0
- package/docs/tools/exec-approvals.md +430 -0
- package/docs/tools/exec.md +207 -0
- package/docs/tools/firecrawl.md +140 -0
- package/docs/tools/index.md +137 -0
- package/docs/tools/llm-task.md +119 -0
- package/docs/tools/lobster.md +340 -0
- package/docs/tools/loop-detection.md +100 -0
- package/docs/tools/multi-agent-sandbox-tools.md +364 -0
- package/docs/tools/pdf.md +156 -0
- package/docs/tools/perplexity-search.md +174 -0
- package/docs/tools/plugin.md +255 -0
- package/docs/tools/reactions.md +64 -0
- package/docs/tools/skills-config.md +86 -0
- package/docs/tools/skills.md +309 -0
- package/docs/tools/slash-commands.md +294 -0
- package/docs/tools/subagents.md +295 -0
- package/docs/tools/tavily.md +125 -0
- package/docs/tools/thinking.md +96 -0
- package/docs/tools/tts.md +406 -0
- package/docs/tools/web.md +516 -0
- package/docs/tts.md +406 -0
- package/docs/vps.md +112 -0
- package/docs/web/control-ui.md +275 -0
- package/docs/web/dashboard.md +54 -0
- package/docs/web/index.md +120 -0
- package/docs/web/tui.md +170 -0
- package/docs/web/webchat.md +61 -0
- package/docs/whatsapp-openclaw-ai-zh.jpg +0 -0
- package/docs/whatsapp-openclaw.jpg +0 -0
- package/docs/zh-CN/AGENTS.md +61 -0
- package/docs/zh-CN/automation/auth-monitoring.md +47 -0
- package/docs/zh-CN/automation/cron-jobs.md +435 -0
- package/docs/zh-CN/automation/cron-vs-heartbeat.md +286 -0
- package/docs/zh-CN/automation/gmail-pubsub.md +249 -0
- package/docs/zh-CN/automation/hooks.md +1051 -0
- package/docs/zh-CN/automation/poll.md +76 -0
- package/docs/zh-CN/automation/troubleshooting.md +8 -0
- package/docs/zh-CN/automation/webhook.md +163 -0
- package/docs/zh-CN/brave-search.md +60 -0
- package/docs/zh-CN/channels/bluebubbles.md +354 -0
- package/docs/zh-CN/channels/broadcast-groups.md +449 -0
- package/docs/zh-CN/channels/channel-routing.md +117 -0
- package/docs/zh-CN/channels/discord.md +468 -0
- package/docs/zh-CN/channels/feishu.md +728 -0
- package/docs/zh-CN/channels/googlechat.md +257 -0
- package/docs/zh-CN/channels/grammy.md +38 -0
- package/docs/zh-CN/channels/group-messages.md +91 -0
- package/docs/zh-CN/channels/groups.md +379 -0
- package/docs/zh-CN/channels/imessage.md +302 -0
- package/docs/zh-CN/channels/index.md +53 -0
- package/docs/zh-CN/channels/line.md +180 -0
- package/docs/zh-CN/channels/location.md +63 -0
- package/docs/zh-CN/channels/matrix.md +221 -0
- package/docs/zh-CN/channels/mattermost.md +144 -0
- package/docs/zh-CN/channels/msteams.md +775 -0
- package/docs/zh-CN/channels/nextcloud-talk.md +142 -0
- package/docs/zh-CN/channels/nostr.md +249 -0
- package/docs/zh-CN/channels/pairing.md +89 -0
- package/docs/zh-CN/channels/signal.md +209 -0
- package/docs/zh-CN/channels/slack.md +531 -0
- package/docs/zh-CN/channels/synology-chat.md +138 -0
- package/docs/zh-CN/channels/telegram.md +751 -0
- package/docs/zh-CN/channels/tlon.md +136 -0
- package/docs/zh-CN/channels/troubleshooting.md +36 -0
- package/docs/zh-CN/channels/twitch.md +385 -0
- package/docs/zh-CN/channels/whatsapp.md +411 -0
- package/docs/zh-CN/channels/zalo.md +196 -0
- package/docs/zh-CN/channels/zalouser.md +147 -0
- package/docs/zh-CN/cli/acp.md +173 -0
- package/docs/zh-CN/cli/agent.md +30 -0
- package/docs/zh-CN/cli/agents.md +82 -0
- package/docs/zh-CN/cli/approvals.md +57 -0
- package/docs/zh-CN/cli/browser.md +114 -0
- package/docs/zh-CN/cli/channels.md +86 -0
- package/docs/zh-CN/cli/config.md +57 -0
- package/docs/zh-CN/cli/configure.md +38 -0
- package/docs/zh-CN/cli/cron.md +43 -0
- package/docs/zh-CN/cli/dashboard.md +23 -0
- package/docs/zh-CN/cli/devices.md +74 -0
- package/docs/zh-CN/cli/directory.md +70 -0
- package/docs/zh-CN/cli/dns.md +30 -0
- package/docs/zh-CN/cli/docs.md +22 -0
- package/docs/zh-CN/cli/doctor.md +48 -0
- package/docs/zh-CN/cli/gateway.md +206 -0
- package/docs/zh-CN/cli/health.md +28 -0
- package/docs/zh-CN/cli/hooks.md +298 -0
- package/docs/zh-CN/cli/index.md +1143 -0
- package/docs/zh-CN/cli/logs.md +31 -0
- package/docs/zh-CN/cli/memory.md +52 -0
- package/docs/zh-CN/cli/message.md +246 -0
- package/docs/zh-CN/cli/models.md +85 -0
- package/docs/zh-CN/cli/node.md +115 -0
- package/docs/zh-CN/cli/nodes.md +80 -0
- package/docs/zh-CN/cli/onboard.md +164 -0
- package/docs/zh-CN/cli/pairing.md +28 -0
- package/docs/zh-CN/cli/plugins.md +66 -0
- package/docs/zh-CN/cli/reset.md +24 -0
- package/docs/zh-CN/cli/sandbox.md +158 -0
- package/docs/zh-CN/cli/security.md +33 -0
- package/docs/zh-CN/cli/sessions.md +23 -0
- package/docs/zh-CN/cli/setup.md +36 -0
- package/docs/zh-CN/cli/skills.md +33 -0
- package/docs/zh-CN/cli/status.md +33 -0
- package/docs/zh-CN/cli/system.md +63 -0
- package/docs/zh-CN/cli/tui.md +30 -0
- package/docs/zh-CN/cli/uninstall.md +24 -0
- package/docs/zh-CN/cli/update.md +101 -0
- package/docs/zh-CN/cli/voicecall.md +41 -0
- package/docs/zh-CN/cli/webhooks.md +32 -0
- package/docs/zh-CN/concepts/agent-loop.md +146 -0
- package/docs/zh-CN/concepts/agent-workspace.md +219 -0
- package/docs/zh-CN/concepts/agent.md +115 -0
- package/docs/zh-CN/concepts/architecture.md +123 -0
- package/docs/zh-CN/concepts/compaction.md +67 -0
- package/docs/zh-CN/concepts/context.md +168 -0
- package/docs/zh-CN/concepts/features.md +59 -0
- package/docs/zh-CN/concepts/markdown-formatting.md +117 -0
- package/docs/zh-CN/concepts/memory.md +412 -0
- package/docs/zh-CN/concepts/messages.md +141 -0
- package/docs/zh-CN/concepts/model-failover.md +145 -0
- package/docs/zh-CN/concepts/model-providers.md +606 -0
- package/docs/zh-CN/concepts/models.md +225 -0
- package/docs/zh-CN/concepts/multi-agent.md +372 -0
- package/docs/zh-CN/concepts/oauth.md +164 -0
- package/docs/zh-CN/concepts/presence.md +99 -0
- package/docs/zh-CN/concepts/queue.md +94 -0
- package/docs/zh-CN/concepts/retry.md +76 -0
- package/docs/zh-CN/concepts/session-pruning.md +129 -0
- package/docs/zh-CN/concepts/session-tool.md +200 -0
- package/docs/zh-CN/concepts/session.md +166 -0
- package/docs/zh-CN/concepts/streaming.md +133 -0
- package/docs/zh-CN/concepts/system-prompt.md +101 -0
- package/docs/zh-CN/concepts/timezone.md +96 -0
- package/docs/zh-CN/concepts/typebox.md +284 -0
- package/docs/zh-CN/concepts/typing-indicators.md +74 -0
- package/docs/zh-CN/concepts/usage-tracking.md +42 -0
- package/docs/zh-CN/date-time.md +129 -0
- package/docs/zh-CN/debug/node-issue.md +90 -0
- package/docs/zh-CN/diagnostics/flags.md +98 -0
- package/docs/zh-CN/gateway/authentication.md +184 -0
- package/docs/zh-CN/gateway/background-process.md +100 -0
- package/docs/zh-CN/gateway/bonjour.md +174 -0
- package/docs/zh-CN/gateway/bridge-protocol.md +86 -0
- package/docs/zh-CN/gateway/cli-backends.md +213 -0
- package/docs/zh-CN/gateway/configuration-examples.md +587 -0
- package/docs/zh-CN/gateway/configuration-reference.md +3103 -0
- package/docs/zh-CN/gateway/configuration.md +640 -0
- package/docs/zh-CN/gateway/discovery.md +123 -0
- package/docs/zh-CN/gateway/doctor.md +238 -0
- package/docs/zh-CN/gateway/gateway-lock.md +41 -0
- package/docs/zh-CN/gateway/health.md +42 -0
- package/docs/zh-CN/gateway/heartbeat.md +274 -0
- package/docs/zh-CN/gateway/index.md +335 -0
- package/docs/zh-CN/gateway/local-models.md +159 -0
- package/docs/zh-CN/gateway/logging.md +114 -0
- package/docs/zh-CN/gateway/multiple-gateways.md +119 -0
- package/docs/zh-CN/gateway/network-model.md +23 -0
- package/docs/zh-CN/gateway/openai-http-api.md +125 -0
- package/docs/zh-CN/gateway/openresponses-http-api.md +317 -0
- package/docs/zh-CN/gateway/pairing.md +99 -0
- package/docs/zh-CN/gateway/protocol.md +220 -0
- package/docs/zh-CN/gateway/remote-gateway-readme.md +164 -0
- package/docs/zh-CN/gateway/remote.md +133 -0
- package/docs/zh-CN/gateway/sandbox-vs-tool-policy-vs-elevated.md +135 -0
- package/docs/zh-CN/gateway/sandboxing.md +188 -0
- package/docs/zh-CN/gateway/security/index.md +777 -0
- package/docs/zh-CN/gateway/tailscale.md +124 -0
- package/docs/zh-CN/gateway/tools-invoke-http-api.md +92 -0
- package/docs/zh-CN/gateway/troubleshooting.md +771 -0
- package/docs/zh-CN/help/debugging.md +160 -0
- package/docs/zh-CN/help/environment.md +88 -0
- package/docs/zh-CN/help/faq.md +2640 -0
- package/docs/zh-CN/help/index.md +28 -0
- package/docs/zh-CN/help/scripts.md +35 -0
- package/docs/zh-CN/help/testing.md +375 -0
- package/docs/zh-CN/help/troubleshooting.md +104 -0
- package/docs/zh-CN/index.md +186 -0
- package/docs/zh-CN/install/ansible.md +215 -0
- package/docs/zh-CN/install/bun.md +65 -0
- package/docs/zh-CN/install/development-channels.md +81 -0
- package/docs/zh-CN/install/docker.md +532 -0
- package/docs/zh-CN/install/exe-dev.md +133 -0
- package/docs/zh-CN/install/fly.md +490 -0
- package/docs/zh-CN/install/gcp.md +510 -0
- package/docs/zh-CN/install/hetzner.md +337 -0
- package/docs/zh-CN/install/index.md +235 -0
- package/docs/zh-CN/install/installer.md +422 -0
- package/docs/zh-CN/install/macos-vm.md +288 -0
- package/docs/zh-CN/install/migrating.md +199 -0
- package/docs/zh-CN/install/nix.md +99 -0
- package/docs/zh-CN/install/node.md +8 -0
- package/docs/zh-CN/install/northflank.mdx +60 -0
- package/docs/zh-CN/install/railway.mdx +106 -0
- package/docs/zh-CN/install/render.mdx +169 -0
- package/docs/zh-CN/install/uninstall.md +135 -0
- package/docs/zh-CN/install/updating.md +233 -0
- package/docs/zh-CN/logging.md +329 -0
- package/docs/zh-CN/network.md +59 -0
- package/docs/zh-CN/nodes/audio.md +120 -0
- package/docs/zh-CN/nodes/camera.md +162 -0
- package/docs/zh-CN/nodes/images.md +79 -0
- package/docs/zh-CN/nodes/index.md +348 -0
- package/docs/zh-CN/nodes/location-command.md +120 -0
- package/docs/zh-CN/nodes/media-understanding.md +380 -0
- package/docs/zh-CN/nodes/talk.md +97 -0
- package/docs/zh-CN/nodes/troubleshooting.md +8 -0
- package/docs/zh-CN/nodes/voicewake.md +72 -0
- package/docs/zh-CN/perplexity.md +102 -0
- package/docs/zh-CN/pi-dev.md +77 -0
- package/docs/zh-CN/pi.md +619 -0
- package/docs/zh-CN/platforms/android.md +155 -0
- package/docs/zh-CN/platforms/digitalocean.md +273 -0
- package/docs/zh-CN/platforms/index.md +60 -0
- package/docs/zh-CN/platforms/ios.md +114 -0
- package/docs/zh-CN/platforms/linux.md +100 -0
- package/docs/zh-CN/platforms/mac/bundled-gateway.md +75 -0
- package/docs/zh-CN/platforms/mac/canvas.md +128 -0
- package/docs/zh-CN/platforms/mac/child-process.md +73 -0
- package/docs/zh-CN/platforms/mac/dev-setup.md +109 -0
- package/docs/zh-CN/platforms/mac/health.md +41 -0
- package/docs/zh-CN/platforms/mac/icon.md +38 -0
- package/docs/zh-CN/platforms/mac/logging.md +64 -0
- package/docs/zh-CN/platforms/mac/menu-bar.md +88 -0
- package/docs/zh-CN/platforms/mac/peekaboo.md +62 -0
- package/docs/zh-CN/platforms/mac/permissions.md +46 -0
- package/docs/zh-CN/platforms/mac/remote.md +90 -0
- package/docs/zh-CN/platforms/mac/signing.md +54 -0
- package/docs/zh-CN/platforms/mac/skills.md +40 -0
- package/docs/zh-CN/platforms/mac/voice-overlay.md +67 -0
- package/docs/zh-CN/platforms/mac/voicewake.md +74 -0
- package/docs/zh-CN/platforms/mac/webchat.md +43 -0
- package/docs/zh-CN/platforms/mac/xpc.md +68 -0
- package/docs/zh-CN/platforms/macos.md +193 -0
- package/docs/zh-CN/platforms/oracle.md +310 -0
- package/docs/zh-CN/platforms/raspberry-pi.md +416 -0
- package/docs/zh-CN/platforms/windows.md +247 -0
- package/docs/zh-CN/plugins/agent-tools.md +99 -0
- package/docs/zh-CN/plugins/manifest.md +68 -0
- package/docs/zh-CN/plugins/voice-call.md +250 -0
- package/docs/zh-CN/plugins/zalouser.md +88 -0
- package/docs/zh-CN/prose.md +141 -0
- package/docs/zh-CN/providers/anthropic.md +265 -0
- package/docs/zh-CN/providers/bedrock.md +170 -0
- package/docs/zh-CN/providers/claude-max-api-proxy.md +155 -0
- package/docs/zh-CN/providers/cloudflare-ai-gateway.md +78 -0
- package/docs/zh-CN/providers/deepgram.md +97 -0
- package/docs/zh-CN/providers/github-copilot.md +67 -0
- package/docs/zh-CN/providers/glm.md +50 -0
- package/docs/zh-CN/providers/huggingface.md +216 -0
- package/docs/zh-CN/providers/index.md +69 -0
- package/docs/zh-CN/providers/kilocode.md +80 -0
- package/docs/zh-CN/providers/litellm.md +160 -0
- package/docs/zh-CN/providers/minimax.md +222 -0
- package/docs/zh-CN/providers/mistral.md +61 -0
- package/docs/zh-CN/providers/models.md +51 -0
- package/docs/zh-CN/providers/moonshot.md +182 -0
- package/docs/zh-CN/providers/nvidia.md +62 -0
- package/docs/zh-CN/providers/ollama.md +359 -0
- package/docs/zh-CN/providers/openai.md +308 -0
- package/docs/zh-CN/providers/opencode-go.md +52 -0
- package/docs/zh-CN/providers/opencode.md +71 -0
- package/docs/zh-CN/providers/openrouter.md +44 -0
- package/docs/zh-CN/providers/qianfan.md +45 -0
- package/docs/zh-CN/providers/qwen.md +55 -0
- package/docs/zh-CN/providers/sglang.md +111 -0
- package/docs/zh-CN/providers/synthetic.md +106 -0
- package/docs/zh-CN/providers/together.md +72 -0
- package/docs/zh-CN/providers/venice.md +289 -0
- package/docs/zh-CN/providers/vercel-ai-gateway.md +66 -0
- package/docs/zh-CN/providers/xiaomi.md +93 -0
- package/docs/zh-CN/providers/zai.md +53 -0
- package/docs/zh-CN/reference/AGENTS.default.md +131 -0
- package/docs/zh-CN/reference/RELEASING.md +48 -0
- package/docs/zh-CN/reference/api-usage-costs.md +141 -0
- package/docs/zh-CN/reference/credits.md +34 -0
- package/docs/zh-CN/reference/device-models.md +54 -0
- package/docs/zh-CN/reference/rpc.md +48 -0
- package/docs/zh-CN/reference/session-management-compaction.md +287 -0
- package/docs/zh-CN/reference/templates/AGENTS.dev.md +89 -0
- package/docs/zh-CN/reference/templates/AGENTS.md +225 -0
- package/docs/zh-CN/reference/templates/BOOT.md +17 -0
- package/docs/zh-CN/reference/templates/BOOTSTRAP.md +68 -0
- package/docs/zh-CN/reference/templates/HEARTBEAT.md +18 -0
- package/docs/zh-CN/reference/templates/IDENTITY.dev.md +54 -0
- package/docs/zh-CN/reference/templates/IDENTITY.md +36 -0
- package/docs/zh-CN/reference/templates/SOUL.dev.md +83 -0
- package/docs/zh-CN/reference/templates/SOUL.md +49 -0
- package/docs/zh-CN/reference/templates/TOOLS.dev.md +31 -0
- package/docs/zh-CN/reference/templates/TOOLS.md +53 -0
- package/docs/zh-CN/reference/templates/USER.dev.md +25 -0
- package/docs/zh-CN/reference/templates/USER.md +30 -0
- package/docs/zh-CN/reference/test.md +57 -0
- package/docs/zh-CN/reference/token-use.md +119 -0
- package/docs/zh-CN/reference/transcript-hygiene.md +109 -0
- package/docs/zh-CN/reference/wizard.md +242 -0
- package/docs/zh-CN/security/formal-verification.md +171 -0
- package/docs/zh-CN/start/bootstrapping.md +9 -0
- package/docs/zh-CN/start/docs-directory.md +70 -0
- package/docs/zh-CN/start/getting-started.md +143 -0
- package/docs/zh-CN/start/hubs.md +194 -0
- package/docs/zh-CN/start/lore.md +226 -0
- package/docs/zh-CN/start/onboarding-overview.md +58 -0
- package/docs/zh-CN/start/onboarding.md +105 -0
- package/docs/zh-CN/start/openclaw.md +248 -0
- package/docs/zh-CN/start/quickstart.md +88 -0
- package/docs/zh-CN/start/setup.md +153 -0
- package/docs/zh-CN/start/showcase.md +423 -0
- package/docs/zh-CN/start/wizard-cli-automation.md +222 -0
- package/docs/zh-CN/start/wizard-cli-reference.md +306 -0
- package/docs/zh-CN/start/wizard.md +132 -0
- package/docs/zh-CN/tools/agent-send.md +59 -0
- package/docs/zh-CN/tools/apply-patch.md +57 -0
- package/docs/zh-CN/tools/browser-linux-troubleshooting.md +144 -0
- package/docs/zh-CN/tools/browser-login.md +75 -0
- package/docs/zh-CN/tools/browser.md +553 -0
- package/docs/zh-CN/tools/chrome-extension.md +183 -0
- package/docs/zh-CN/tools/clawhub.md +209 -0
- package/docs/zh-CN/tools/creating-skills.md +61 -0
- package/docs/zh-CN/tools/elevated.md +64 -0
- package/docs/zh-CN/tools/exec-approvals.md +234 -0
- package/docs/zh-CN/tools/exec.md +169 -0
- package/docs/zh-CN/tools/firecrawl.md +68 -0
- package/docs/zh-CN/tools/index.md +515 -0
- package/docs/zh-CN/tools/llm-task.md +117 -0
- package/docs/zh-CN/tools/lobster.md +349 -0
- package/docs/zh-CN/tools/multi-agent-sandbox-tools.md +401 -0
- package/docs/zh-CN/tools/plugin.md +1612 -0
- package/docs/zh-CN/tools/reactions.md +29 -0
- package/docs/zh-CN/tools/skills-config.md +78 -0
- package/docs/zh-CN/tools/skills.md +279 -0
- package/docs/zh-CN/tools/slash-commands.md +205 -0
- package/docs/zh-CN/tools/subagents.md +167 -0
- package/docs/zh-CN/tools/thinking.md +80 -0
- package/docs/zh-CN/tools/web.md +289 -0
- package/docs/zh-CN/tts.md +375 -0
- package/docs/zh-CN/vps.md +47 -0
- package/docs/zh-CN/web/control-ui.md +191 -0
- package/docs/zh-CN/web/dashboard.md +53 -0
- package/docs/zh-CN/web/index.md +118 -0
- package/docs/zh-CN/web/tui.md +166 -0
- package/docs/zh-CN/web/webchat.md +56 -0
- package/package.json +841 -0
- package/quantumclaw.mjs +135 -0
- package/skills/1password/SKILL.md +70 -0
- package/skills/1password/references/cli-examples.md +29 -0
- package/skills/1password/references/get-started.md +17 -0
- package/skills/apple-notes/SKILL.md +77 -0
- package/skills/apple-reminders/SKILL.md +118 -0
- package/skills/bear-notes/SKILL.md +107 -0
- package/skills/blogwatcher/SKILL.md +69 -0
- package/skills/blucli/SKILL.md +47 -0
- package/skills/bluebubbles/SKILL.md +131 -0
- package/skills/camsnap/SKILL.md +45 -0
- package/skills/canvas/SKILL.md +198 -0
- package/skills/clawhub/SKILL.md +77 -0
- package/skills/coding-agent/SKILL.md +295 -0
- package/skills/discord/SKILL.md +197 -0
- package/skills/eightctl/SKILL.md +50 -0
- package/skills/gemini/SKILL.md +43 -0
- package/skills/gh-issues/SKILL.md +865 -0
- package/skills/gifgrep/SKILL.md +79 -0
- package/skills/github/SKILL.md +163 -0
- package/skills/gog/SKILL.md +116 -0
- package/skills/goplaces/SKILL.md +52 -0
- package/skills/healthcheck/SKILL.md +245 -0
- package/skills/himalaya/SKILL.md +257 -0
- package/skills/himalaya/references/configuration.md +184 -0
- package/skills/himalaya/references/message-composition.md +199 -0
- package/skills/imsg/SKILL.md +122 -0
- package/skills/mcporter/SKILL.md +61 -0
- package/skills/model-usage/SKILL.md +69 -0
- package/skills/model-usage/references/codexbar-cli.md +33 -0
- package/skills/model-usage/scripts/model_usage.py +320 -0
- package/skills/model-usage/scripts/test_model_usage.py +40 -0
- package/skills/nano-pdf/SKILL.md +38 -0
- package/skills/node-connect/SKILL.md +142 -0
- package/skills/notion/SKILL.md +174 -0
- package/skills/obsidian/SKILL.md +81 -0
- package/skills/openai-image-gen/SKILL.md +92 -0
- package/skills/openai-image-gen/scripts/gen.py +328 -0
- package/skills/openai-image-gen/scripts/test_gen.py +140 -0
- package/skills/openai-whisper/SKILL.md +38 -0
- package/skills/openai-whisper-api/SKILL.md +52 -0
- package/skills/openai-whisper-api/scripts/transcribe.sh +85 -0
- package/skills/openhue/SKILL.md +112 -0
- package/skills/oracle/SKILL.md +125 -0
- package/skills/ordercli/SKILL.md +78 -0
- package/skills/peekaboo/SKILL.md +190 -0
- package/skills/sag/SKILL.md +87 -0
- package/skills/session-logs/SKILL.md +115 -0
- package/skills/sherpa-onnx-tts/SKILL.md +103 -0
- package/skills/sherpa-onnx-tts/bin/sherpa-onnx-tts +178 -0
- package/skills/skill-creator/SKILL.md +372 -0
- package/skills/skill-creator/license.txt +202 -0
- package/skills/skill-creator/scripts/init_skill.py +378 -0
- package/skills/skill-creator/scripts/package_skill.py +139 -0
- package/skills/skill-creator/scripts/quick_validate.py +159 -0
- package/skills/skill-creator/scripts/test_package_skill.py +160 -0
- package/skills/skill-creator/scripts/test_quick_validate.py +72 -0
- package/skills/slack/SKILL.md +144 -0
- package/skills/songsee/SKILL.md +49 -0
- package/skills/sonoscli/SKILL.md +65 -0
- package/skills/spotify-player/SKILL.md +64 -0
- package/skills/summarize/SKILL.md +87 -0
- package/skills/things-mac/SKILL.md +86 -0
- package/skills/tmux/SKILL.md +153 -0
- package/skills/tmux/scripts/find-sessions.sh +112 -0
- package/skills/tmux/scripts/wait-for-text.sh +83 -0
- package/skills/trello/SKILL.md +95 -0
- package/skills/video-frames/SKILL.md +46 -0
- package/skills/video-frames/scripts/frame.sh +81 -0
- package/skills/voice-call/SKILL.md +45 -0
- package/skills/wacli/SKILL.md +72 -0
- package/skills/weather/SKILL.md +112 -0
- package/skills/xurl/SKILL.md +461 -0
|
@@ -0,0 +1,160 @@
|
|
|
1
|
+
---
|
|
2
|
+
read_when:
|
|
3
|
+
- 你想通过 LiteLLM 代理路由 QuantumClaw
|
|
4
|
+
- 你需要通过 LiteLLM 进行成本跟踪、日志记录或模型路由
|
|
5
|
+
summary: 通过 LiteLLM Proxy 运行 QuantumClaw,以实现统一模型访问和成本跟踪
|
|
6
|
+
x-i18n:
|
|
7
|
+
generated_at: "2026-03-16T06:25:50Z"
|
|
8
|
+
model: gpt-5.4
|
|
9
|
+
provider: openai
|
|
10
|
+
source_hash: 269529671c60864972441606c730b5ca327546a45d3b264dbd03204c4401936f
|
|
11
|
+
source_path: providers/litellm.md
|
|
12
|
+
workflow: 15
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
# LiteLLM
|
|
16
|
+
|
|
17
|
+
[LiteLLM](https://litellm.ai) 是一个开源 LLM 网关,可为 100+ 模型提供商提供统一 API。通过 LiteLLM 路由 QuantumClaw,你可以获得集中式成本跟踪、日志记录,以及在不更改 QuantumClaw 配置的情况下切换后端的灵活性。
|
|
18
|
+
|
|
19
|
+
## 为什么要将 LiteLLM 与 QuantumClaw 搭配使用?
|
|
20
|
+
|
|
21
|
+
- **成本跟踪** —— 精确查看 QuantumClaw 在所有模型上的花费
|
|
22
|
+
- **模型路由** —— 无需更改配置,即可在 Claude、GPT-4、Gemini、Bedrock 之间切换
|
|
23
|
+
- **虚拟密钥** —— 为 QuantumClaw 创建带有支出限制的密钥
|
|
24
|
+
- **日志记录** —— 提供完整的请求/响应日志,便于调试
|
|
25
|
+
- **回退** —— 如果你的主要提供商宕机,可自动故障切换
|
|
26
|
+
|
|
27
|
+
## 快速开始
|
|
28
|
+
|
|
29
|
+
### 通过新手引导
|
|
30
|
+
|
|
31
|
+
```bash
|
|
32
|
+
quantumclaw onboard --auth-choice litellm-api-key
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
### 手动设置
|
|
36
|
+
|
|
37
|
+
1. 启动 LiteLLM Proxy:
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
pip install 'litellm[proxy]'
|
|
41
|
+
litellm --model claude-opus-4-6
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
2. 将 QuantumClaw 指向 LiteLLM:
|
|
45
|
+
|
|
46
|
+
```bash
|
|
47
|
+
export LITELLM_API_KEY="your-litellm-key"
|
|
48
|
+
|
|
49
|
+
quantumclaw
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
就是这样。QuantumClaw 现在会通过 LiteLLM 进行路由。
|
|
53
|
+
|
|
54
|
+
## 配置
|
|
55
|
+
|
|
56
|
+
### 环境变量
|
|
57
|
+
|
|
58
|
+
```bash
|
|
59
|
+
export LITELLM_API_KEY="sk-litellm-key"
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
### 配置文件
|
|
63
|
+
|
|
64
|
+
```json5
|
|
65
|
+
{
|
|
66
|
+
models: {
|
|
67
|
+
providers: {
|
|
68
|
+
litellm: {
|
|
69
|
+
baseUrl: "http://localhost:4000",
|
|
70
|
+
apiKey: "${LITELLM_API_KEY}",
|
|
71
|
+
api: "openai-completions",
|
|
72
|
+
models: [
|
|
73
|
+
{
|
|
74
|
+
id: "claude-opus-4-6",
|
|
75
|
+
name: "Claude Opus 4.6",
|
|
76
|
+
reasoning: true,
|
|
77
|
+
input: ["text", "image"],
|
|
78
|
+
contextWindow: 200000,
|
|
79
|
+
maxTokens: 64000,
|
|
80
|
+
},
|
|
81
|
+
{
|
|
82
|
+
id: "gpt-4o",
|
|
83
|
+
name: "GPT-4o",
|
|
84
|
+
reasoning: false,
|
|
85
|
+
input: ["text", "image"],
|
|
86
|
+
contextWindow: 128000,
|
|
87
|
+
maxTokens: 8192,
|
|
88
|
+
},
|
|
89
|
+
],
|
|
90
|
+
},
|
|
91
|
+
},
|
|
92
|
+
},
|
|
93
|
+
agents: {
|
|
94
|
+
defaults: {
|
|
95
|
+
model: { primary: "litellm/claude-opus-4-6" },
|
|
96
|
+
},
|
|
97
|
+
},
|
|
98
|
+
}
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
## 虚拟密钥
|
|
102
|
+
|
|
103
|
+
为 QuantumClaw 创建一个带支出限制的专用密钥:
|
|
104
|
+
|
|
105
|
+
```bash
|
|
106
|
+
curl -X POST "http://localhost:4000/key/generate" \
|
|
107
|
+
-H "Authorization: Bearer $LITELLM_MASTER_KEY" \
|
|
108
|
+
-H "Content-Type: application/json" \
|
|
109
|
+
-d '{
|
|
110
|
+
"key_alias": "quantumclaw",
|
|
111
|
+
"max_budget": 50.00,
|
|
112
|
+
"budget_duration": "monthly"
|
|
113
|
+
}'
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
将生成的密钥用作 `LITELLM_API_KEY`。
|
|
117
|
+
|
|
118
|
+
## 模型路由
|
|
119
|
+
|
|
120
|
+
LiteLLM 可以将模型请求路由到不同后端。在你的 LiteLLM `config.yaml` 中进行配置:
|
|
121
|
+
|
|
122
|
+
```yaml
|
|
123
|
+
model_list:
|
|
124
|
+
- model_name: claude-opus-4-6
|
|
125
|
+
litellm_params:
|
|
126
|
+
model: claude-opus-4-6
|
|
127
|
+
api_key: os.environ/ANTHROPIC_API_KEY
|
|
128
|
+
|
|
129
|
+
- model_name: gpt-4o
|
|
130
|
+
litellm_params:
|
|
131
|
+
model: gpt-4o
|
|
132
|
+
api_key: os.environ/OPENAI_API_KEY
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
QuantumClaw 会继续请求 `claude-opus-4-6` —— 路由由 LiteLLM 处理。
|
|
136
|
+
|
|
137
|
+
## 查看使用情况
|
|
138
|
+
|
|
139
|
+
检查 LiteLLM 的仪表板或 API:
|
|
140
|
+
|
|
141
|
+
```bash
|
|
142
|
+
# 密钥信息
|
|
143
|
+
curl "http://localhost:4000/key/info" \
|
|
144
|
+
-H "Authorization: Bearer sk-litellm-key"
|
|
145
|
+
|
|
146
|
+
# 支出日志
|
|
147
|
+
curl "http://localhost:4000/spend/logs" \
|
|
148
|
+
-H "Authorization: Bearer $LITELLM_MASTER_KEY"
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
## 说明
|
|
152
|
+
|
|
153
|
+
- LiteLLM 默认运行在 `http://localhost:4000`
|
|
154
|
+
- QuantumClaw 通过兼容 OpenAI 的 `/v1/chat/completions` 端点连接
|
|
155
|
+
- 所有 QuantumClaw 功能都可通过 LiteLLM 使用 —— 没有限制
|
|
156
|
+
|
|
157
|
+
## 另请参见
|
|
158
|
+
|
|
159
|
+
- [LiteLLM 文档](https://docs.litellm.ai)
|
|
160
|
+
- [模型提供商](/concepts/model-providers)
|
|
@@ -0,0 +1,222 @@
|
|
|
1
|
+
---
|
|
2
|
+
read_when:
|
|
3
|
+
- 你想在 QuantumClaw 中使用 MiniMax 模型
|
|
4
|
+
- 你需要 MiniMax 设置指南
|
|
5
|
+
summary: 在 QuantumClaw 中使用 MiniMax M2.5
|
|
6
|
+
title: MiniMax
|
|
7
|
+
x-i18n:
|
|
8
|
+
generated_at: "2026-03-16T06:26:04Z"
|
|
9
|
+
model: gpt-5.4
|
|
10
|
+
provider: openai
|
|
11
|
+
source_hash: ffed28de9ecc5a1d2ad9f18adc08dd9cf39df40674b14c7ef078b16c92faacf2
|
|
12
|
+
source_path: providers/minimax.md
|
|
13
|
+
workflow: 15
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
# MiniMax
|
|
17
|
+
|
|
18
|
+
MiniMax 是一家 AI 公司,构建了 **M2/M2.5** 模型家族。当前
|
|
19
|
+
面向编码的版本是 **MiniMax M2.5**(2025 年 12 月 23 日),专为
|
|
20
|
+
现实世界中的复杂任务打造。
|
|
21
|
+
|
|
22
|
+
来源:[MiniMax M2.5 发布说明](https://www.minimax.io/news/minimax-m25)
|
|
23
|
+
|
|
24
|
+
## 模型概览(M2.5)
|
|
25
|
+
|
|
26
|
+
MiniMax 在 M2.5 中重点强调了以下改进:
|
|
27
|
+
|
|
28
|
+
- 更强的**多语言编码**能力(Rust、Java、Go、C++、Kotlin、Objective-C、TS/JS)。
|
|
29
|
+
- 更好的**Web/应用开发**和美学输出质量(包括原生移动端)。
|
|
30
|
+
- 在交错思考和集成约束执行的基础上,改进了面向办公类工作流的**复合指令**处理。
|
|
31
|
+
- **更简洁的响应**,token 使用量更低,迭代循环更快。
|
|
32
|
+
- 更强的**工具/智能体框架**兼容性和上下文管理能力(Claude Code、
|
|
33
|
+
Droid/Factory AI、Cline、Kilo Code、Roo Code、BlackBox)。
|
|
34
|
+
- 更高质量的**对话和技术写作**输出。
|
|
35
|
+
|
|
36
|
+
## MiniMax M2.5 与 MiniMax M2.5 Highspeed
|
|
37
|
+
|
|
38
|
+
- **速度:** `MiniMax-M2.5-highspeed` 是 MiniMax 文档中的官方高速层级。
|
|
39
|
+
- **成本:** MiniMax 定价显示,高速版的输入成本相同,而输出成本更高。
|
|
40
|
+
- **当前模型 ID:** 使用 `MiniMax-M2.5` 或 `MiniMax-M2.5-highspeed`。
|
|
41
|
+
|
|
42
|
+
## 选择一种设置方式
|
|
43
|
+
|
|
44
|
+
### MiniMax OAuth(Coding Plan)—— 推荐
|
|
45
|
+
|
|
46
|
+
**最适合:** 通过 OAuth 使用 MiniMax Coding Plan 快速设置,无需 API key。
|
|
47
|
+
|
|
48
|
+
启用内置 OAuth 插件并完成认证:
|
|
49
|
+
|
|
50
|
+
```bash
|
|
51
|
+
quantumclaw plugins enable minimax # 如果已加载则跳过。
|
|
52
|
+
quantumclaw gateway restart # 如果 gateway 已在运行,则重启
|
|
53
|
+
quantumclaw onboard --auth-choice minimax-portal
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
系统会提示你选择一个端点:
|
|
57
|
+
|
|
58
|
+
- **Global** - 国际用户(`api.minimax.io`)
|
|
59
|
+
- **CN** - 中国用户(`api.minimaxi.com`)
|
|
60
|
+
|
|
61
|
+
详情请参阅 [MiniMax plugin README](https://github.com/quantumclaw/quantumclaw/tree/main/extensions/minimax)。
|
|
62
|
+
|
|
63
|
+
### MiniMax M2.5(API key)
|
|
64
|
+
|
|
65
|
+
**最适合:** 使用与 Anthropic 兼容 API 的托管 MiniMax。
|
|
66
|
+
|
|
67
|
+
通过 CLI 配置:
|
|
68
|
+
|
|
69
|
+
- 运行 `quantumclaw configure`
|
|
70
|
+
- 选择 **Model/auth**
|
|
71
|
+
- 选择 **MiniMax M2.5**
|
|
72
|
+
|
|
73
|
+
```json5
|
|
74
|
+
{
|
|
75
|
+
env: { MINIMAX_API_KEY: "sk-..." },
|
|
76
|
+
agents: { defaults: { model: { primary: "minimax/MiniMax-M2.5" } } },
|
|
77
|
+
models: {
|
|
78
|
+
mode: "merge",
|
|
79
|
+
providers: {
|
|
80
|
+
minimax: {
|
|
81
|
+
baseUrl: "https://api.minimax.io/anthropic",
|
|
82
|
+
apiKey: "${MINIMAX_API_KEY}",
|
|
83
|
+
api: "anthropic-messages",
|
|
84
|
+
models: [
|
|
85
|
+
{
|
|
86
|
+
id: "MiniMax-M2.5",
|
|
87
|
+
name: "MiniMax M2.5",
|
|
88
|
+
reasoning: true,
|
|
89
|
+
input: ["text"],
|
|
90
|
+
cost: { input: 0.3, output: 1.2, cacheRead: 0.03, cacheWrite: 0.12 },
|
|
91
|
+
contextWindow: 200000,
|
|
92
|
+
maxTokens: 8192,
|
|
93
|
+
},
|
|
94
|
+
{
|
|
95
|
+
id: "MiniMax-M2.5-highspeed",
|
|
96
|
+
name: "MiniMax M2.5 Highspeed",
|
|
97
|
+
reasoning: true,
|
|
98
|
+
input: ["text"],
|
|
99
|
+
cost: { input: 0.3, output: 1.2, cacheRead: 0.03, cacheWrite: 0.12 },
|
|
100
|
+
contextWindow: 200000,
|
|
101
|
+
maxTokens: 8192,
|
|
102
|
+
},
|
|
103
|
+
],
|
|
104
|
+
},
|
|
105
|
+
},
|
|
106
|
+
},
|
|
107
|
+
}
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
### 将 MiniMax M2.5 作为回退模型(示例)
|
|
111
|
+
|
|
112
|
+
**最适合:** 保持你最强的最新一代模型作为主模型,并在失败时回退到 MiniMax M2.5。
|
|
113
|
+
下面的示例使用 Opus 作为具体主模型;你可以替换成自己偏好的最新一代主模型。
|
|
114
|
+
|
|
115
|
+
```json5
|
|
116
|
+
{
|
|
117
|
+
env: { MINIMAX_API_KEY: "sk-..." },
|
|
118
|
+
agents: {
|
|
119
|
+
defaults: {
|
|
120
|
+
models: {
|
|
121
|
+
"anthropic/claude-opus-4-6": { alias: "primary" },
|
|
122
|
+
"minimax/MiniMax-M2.5": { alias: "minimax" },
|
|
123
|
+
},
|
|
124
|
+
model: {
|
|
125
|
+
primary: "anthropic/claude-opus-4-6",
|
|
126
|
+
fallbacks: ["minimax/MiniMax-M2.5"],
|
|
127
|
+
},
|
|
128
|
+
},
|
|
129
|
+
},
|
|
130
|
+
}
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
### 可选:通过 LM Studio 本地运行(手动)
|
|
134
|
+
|
|
135
|
+
**最适合:** 通过 LM Studio 进行本地推理。
|
|
136
|
+
我们已经看到,在强力硬件上(例如台式机/服务器)使用 LM Studio 的本地服务器运行 MiniMax M2.5 时,效果非常强。
|
|
137
|
+
|
|
138
|
+
通过 `quantumclaw.json` 手动配置:
|
|
139
|
+
|
|
140
|
+
```json5
|
|
141
|
+
{
|
|
142
|
+
agents: {
|
|
143
|
+
defaults: {
|
|
144
|
+
model: { primary: "lmstudio/minimax-m2.5-gs32" },
|
|
145
|
+
models: { "lmstudio/minimax-m2.5-gs32": { alias: "Minimax" } },
|
|
146
|
+
},
|
|
147
|
+
},
|
|
148
|
+
models: {
|
|
149
|
+
mode: "merge",
|
|
150
|
+
providers: {
|
|
151
|
+
lmstudio: {
|
|
152
|
+
baseUrl: "http://127.0.0.1:1234/v1",
|
|
153
|
+
apiKey: "lmstudio",
|
|
154
|
+
api: "openai-responses",
|
|
155
|
+
models: [
|
|
156
|
+
{
|
|
157
|
+
id: "minimax-m2.5-gs32",
|
|
158
|
+
name: "MiniMax M2.5 GS32",
|
|
159
|
+
reasoning: true,
|
|
160
|
+
input: ["text"],
|
|
161
|
+
cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
|
|
162
|
+
contextWindow: 196608,
|
|
163
|
+
maxTokens: 8192,
|
|
164
|
+
},
|
|
165
|
+
],
|
|
166
|
+
},
|
|
167
|
+
},
|
|
168
|
+
},
|
|
169
|
+
}
|
|
170
|
+
```
|
|
171
|
+
|
|
172
|
+
## 通过 `quantumclaw configure` 配置
|
|
173
|
+
|
|
174
|
+
使用交互式配置向导设置 MiniMax,而无需编辑 JSON:
|
|
175
|
+
|
|
176
|
+
1. 运行 `quantumclaw configure`。
|
|
177
|
+
2. 选择 **Model/auth**。
|
|
178
|
+
3. 选择 **MiniMax M2.5**。
|
|
179
|
+
4. 在提示时选择你的默认模型。
|
|
180
|
+
|
|
181
|
+
## 配置选项
|
|
182
|
+
|
|
183
|
+
- `models.providers.minimax.baseUrl`:优先使用 `https://api.minimax.io/anthropic`(与 Anthropic 兼容);`https://api.minimax.io/v1` 可选,用于与 OpenAI 兼容的负载。
|
|
184
|
+
- `models.providers.minimax.api`:优先使用 `anthropic-messages`;`openai-completions` 可选,用于与 OpenAI 兼容的负载。
|
|
185
|
+
- `models.providers.minimax.apiKey`:MiniMax API key(`MINIMAX_API_KEY`)。
|
|
186
|
+
- `models.providers.minimax.models`:定义 `id`、`name`、`reasoning`、`contextWindow`、`maxTokens`、`cost`。
|
|
187
|
+
- `agents.defaults.models`:为你希望放入允许列表的模型设置别名。
|
|
188
|
+
- `models.mode`:如果你希望在内置模型之外添加 MiniMax,请保持为 `merge`。
|
|
189
|
+
|
|
190
|
+
## 说明
|
|
191
|
+
|
|
192
|
+
- 模型引用格式为 `minimax/<model>`。
|
|
193
|
+
- 推荐模型 ID:`MiniMax-M2.5` 和 `MiniMax-M2.5-highspeed`。
|
|
194
|
+
- Coding Plan 用量 API:`https://api.minimaxi.com/v1/api/openplatform/coding_plan/remains`(需要 coding plan key)。
|
|
195
|
+
- 如果你需要精确成本跟踪,请更新 `models.json` 中的定价值。
|
|
196
|
+
- MiniMax Coding Plan 推荐链接(九折):[https://platform.minimax.io/subscribe/coding-plan?code=DbXJTRClnb&source=link](https://platform.minimax.io/subscribe/coding-plan?code=DbXJTRClnb&source=link)
|
|
197
|
+
- 关于提供商规则,请参阅 [/concepts/model-providers](/concepts/model-providers)。
|
|
198
|
+
- 使用 `quantumclaw models list` 和 `quantumclaw models set minimax/MiniMax-M2.5` 进行切换。
|
|
199
|
+
|
|
200
|
+
## 故障排除
|
|
201
|
+
|
|
202
|
+
### “Unknown model: minimax/MiniMax-M2.5”
|
|
203
|
+
|
|
204
|
+
这通常意味着 **MiniMax 提供商未配置**(没有提供商条目,
|
|
205
|
+
并且也未找到 MiniMax 凭证配置文件/环境变量 key)。对此检测问题的修复已包含在
|
|
206
|
+
**2026.1.12** 中(在撰写本文时尚未发布)。修复方法:
|
|
207
|
+
|
|
208
|
+
- 升级到 **2026.1.12**(或从源码运行 `main`),然后重启 gateway。
|
|
209
|
+
- 运行 `quantumclaw configure` 并选择 **MiniMax M2.5**,或者
|
|
210
|
+
- 手动添加 `models.providers.minimax` 配置块,或者
|
|
211
|
+
- 设置 `MINIMAX_API_KEY`(或 MiniMax 凭证配置文件),以便注入该提供商。
|
|
212
|
+
|
|
213
|
+
请确保模型 id **区分大小写**:
|
|
214
|
+
|
|
215
|
+
- `minimax/MiniMax-M2.5`
|
|
216
|
+
- `minimax/MiniMax-M2.5-highspeed`
|
|
217
|
+
|
|
218
|
+
然后使用以下命令重新检查:
|
|
219
|
+
|
|
220
|
+
```bash
|
|
221
|
+
quantumclaw models list
|
|
222
|
+
```
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
---
|
|
2
|
+
read_when:
|
|
3
|
+
- 你想在 QuantumClaw 中使用 Mistral 模型
|
|
4
|
+
- 你需要 Mistral API 密钥新手引导和模型引用
|
|
5
|
+
summary: 在 QuantumClaw 中使用 Mistral 模型和 Voxtral 转录
|
|
6
|
+
title: Mistral
|
|
7
|
+
x-i18n:
|
|
8
|
+
generated_at: "2026-03-16T06:25:57Z"
|
|
9
|
+
model: gpt-5.4
|
|
10
|
+
provider: openai
|
|
11
|
+
source_hash: 4f3efe060cbaeb14e20439ade040e57d27e7d98fb9dd06e657f6a69ae808f24f
|
|
12
|
+
source_path: providers/mistral.md
|
|
13
|
+
workflow: 15
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
# Mistral
|
|
17
|
+
|
|
18
|
+
QuantumClaw 支持 Mistral,用于文本/图像模型路由(`mistral/...`)以及
|
|
19
|
+
通过媒体理解中的 Voxtral 进行音频转录。
|
|
20
|
+
Mistral 还可用于记忆嵌入(`memorySearch.provider = "mistral"`)。
|
|
21
|
+
|
|
22
|
+
## CLI 设置
|
|
23
|
+
|
|
24
|
+
```bash
|
|
25
|
+
quantumclaw onboard --auth-choice mistral-api-key
|
|
26
|
+
# or non-interactive
|
|
27
|
+
quantumclaw onboard --mistral-api-key "$MISTRAL_API_KEY"
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
## 配置片段(LLM 提供商)
|
|
31
|
+
|
|
32
|
+
```json5
|
|
33
|
+
{
|
|
34
|
+
env: { MISTRAL_API_KEY: "sk-..." },
|
|
35
|
+
agents: { defaults: { model: { primary: "mistral/mistral-large-latest" } } },
|
|
36
|
+
}
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
## 配置片段(使用 Voxtral 进行音频转录)
|
|
40
|
+
|
|
41
|
+
```json5
|
|
42
|
+
{
|
|
43
|
+
tools: {
|
|
44
|
+
media: {
|
|
45
|
+
audio: {
|
|
46
|
+
enabled: true,
|
|
47
|
+
models: [{ provider: "mistral", model: "voxtral-mini-latest" }],
|
|
48
|
+
},
|
|
49
|
+
},
|
|
50
|
+
},
|
|
51
|
+
}
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
## 说明
|
|
55
|
+
|
|
56
|
+
- Mistral 身份验证使用 `MISTRAL_API_KEY`。
|
|
57
|
+
- 提供商基础 URL 默认为 `https://api.mistral.ai/v1`。
|
|
58
|
+
- 新手引导默认模型为 `mistral/mistral-large-latest`。
|
|
59
|
+
- Mistral 的媒体理解默认音频模型为 `voxtral-mini-latest`。
|
|
60
|
+
- 媒体转录路径使用 `/v1/audio/transcriptions`。
|
|
61
|
+
- 记忆嵌入路径使用 `/v1/embeddings`(默认模型:`mistral-embed`)。
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
---
|
|
2
|
+
read_when:
|
|
3
|
+
- 你想选择一个模型提供商
|
|
4
|
+
- 你想要 LLM 身份验证 + 模型选择的快速设置示例
|
|
5
|
+
summary: QuantumClaw 支持的模型提供商(LLM)
|
|
6
|
+
title: 模型提供商快速开始
|
|
7
|
+
x-i18n:
|
|
8
|
+
generated_at: "2026-03-16T06:26:02Z"
|
|
9
|
+
model: gpt-5.4
|
|
10
|
+
provider: openai
|
|
11
|
+
source_hash: 7a868ba56e93e6332f0e9dd3d3e2c79a08f369dbc96c400dfba141f347d40e8f
|
|
12
|
+
source_path: providers/models.md
|
|
13
|
+
workflow: 15
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
# 模型提供商
|
|
17
|
+
|
|
18
|
+
QuantumClaw 可以使用许多 LLM 提供商。选择一个,完成身份验证,然后将默认
|
|
19
|
+
模型设置为 `provider/model`。
|
|
20
|
+
|
|
21
|
+
## 快速开始(两步)
|
|
22
|
+
|
|
23
|
+
1. 使用该提供商进行身份验证(通常通过 `quantumclaw onboard`)。
|
|
24
|
+
2. 设置默认模型:
|
|
25
|
+
|
|
26
|
+
```json5
|
|
27
|
+
{
|
|
28
|
+
agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
|
|
29
|
+
}
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
## 支持的提供商(入门集合)
|
|
33
|
+
|
|
34
|
+
- [OpenAI(API + Codex)](/providers/openai)
|
|
35
|
+
- [Anthropic(API + Claude Code CLI)](/providers/anthropic)
|
|
36
|
+
- [OpenRouter](/providers/openrouter)
|
|
37
|
+
- [Vercel AI Gateway](/providers/vercel-ai-gateway)
|
|
38
|
+
- [Cloudflare AI Gateway](/providers/cloudflare-ai-gateway)
|
|
39
|
+
- [Moonshot AI(Kimi + Kimi Coding)](/providers/moonshot)
|
|
40
|
+
- [Mistral](/providers/mistral)
|
|
41
|
+
- [Synthetic](/providers/synthetic)
|
|
42
|
+
- [OpenCode(Zen + Go)](/providers/opencode)
|
|
43
|
+
- [Z.AI](/providers/zai)
|
|
44
|
+
- [GLM 模型](/providers/glm)
|
|
45
|
+
- [MiniMax](/providers/minimax)
|
|
46
|
+
- [Venice(Venice AI)](/providers/venice)
|
|
47
|
+
- [Amazon Bedrock](/providers/bedrock)
|
|
48
|
+
- [Qianfan](/providers/qianfan)
|
|
49
|
+
|
|
50
|
+
有关完整的提供商目录(xAI、Groq、Mistral 等)和高级配置,
|
|
51
|
+
请参见 [模型提供商](/concepts/model-providers)。
|
|
@@ -0,0 +1,182 @@
|
|
|
1
|
+
---
|
|
2
|
+
read_when:
|
|
3
|
+
- 你想了解 Moonshot K2(Moonshot Open Platform)与 Kimi Coding 的设置方式
|
|
4
|
+
- 你需要理解独立的端点、密钥和模型引用
|
|
5
|
+
- 你想要任一提供商的可直接复制粘贴配置
|
|
6
|
+
summary: 配置 Moonshot K2 与 Kimi Coding(独立提供商 + 密钥)
|
|
7
|
+
title: Moonshot AI
|
|
8
|
+
x-i18n:
|
|
9
|
+
generated_at: "2026-03-16T06:26:20Z"
|
|
10
|
+
model: gpt-5.4
|
|
11
|
+
provider: openai
|
|
12
|
+
source_hash: f95e6ffa9397e0c2bdbc247e6fb6f2892ca6a34b276ca9b773e6b875233539e3
|
|
13
|
+
source_path: providers/moonshot.md
|
|
14
|
+
workflow: 15
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
# Moonshot AI(Kimi)
|
|
18
|
+
|
|
19
|
+
Moonshot 提供带有 OpenAI 兼容端点的 Kimi API。配置该
|
|
20
|
+
提供商,并将默认模型设置为 `moonshot/kimi-k2.5`,或者使用
|
|
21
|
+
`kimi-coding/k2p5` 作为 Kimi Coding。
|
|
22
|
+
|
|
23
|
+
当前 Kimi K2 模型 ID:
|
|
24
|
+
|
|
25
|
+
[//]: # "moonshot-kimi-k2-ids:start"
|
|
26
|
+
|
|
27
|
+
- `kimi-k2.5`
|
|
28
|
+
- `kimi-k2-0905-preview`
|
|
29
|
+
- `kimi-k2-turbo-preview`
|
|
30
|
+
- `kimi-k2-thinking`
|
|
31
|
+
- `kimi-k2-thinking-turbo`
|
|
32
|
+
|
|
33
|
+
[//]: # "moonshot-kimi-k2-ids:end"
|
|
34
|
+
|
|
35
|
+
```bash
|
|
36
|
+
quantumclaw onboard --auth-choice moonshot-api-key
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
Kimi Coding:
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
quantumclaw onboard --auth-choice kimi-code-api-key
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
注意:Moonshot 和 Kimi Coding 是独立提供商。密钥不可互换,端点不同,模型引用也不同(Moonshot 使用 `moonshot/...`,Kimi Coding 使用 `kimi-coding/...`)。
|
|
46
|
+
|
|
47
|
+
## 配置片段(Moonshot API)
|
|
48
|
+
|
|
49
|
+
```json5
|
|
50
|
+
{
|
|
51
|
+
env: { MOONSHOT_API_KEY: "sk-..." },
|
|
52
|
+
agents: {
|
|
53
|
+
defaults: {
|
|
54
|
+
model: { primary: "moonshot/kimi-k2.5" },
|
|
55
|
+
models: {
|
|
56
|
+
// moonshot-kimi-k2-aliases:start
|
|
57
|
+
"moonshot/kimi-k2.5": { alias: "Kimi K2.5" },
|
|
58
|
+
"moonshot/kimi-k2-0905-preview": { alias: "Kimi K2" },
|
|
59
|
+
"moonshot/kimi-k2-turbo-preview": { alias: "Kimi K2 Turbo" },
|
|
60
|
+
"moonshot/kimi-k2-thinking": { alias: "Kimi K2 Thinking" },
|
|
61
|
+
"moonshot/kimi-k2-thinking-turbo": { alias: "Kimi K2 Thinking Turbo" },
|
|
62
|
+
// moonshot-kimi-k2-aliases:end
|
|
63
|
+
},
|
|
64
|
+
},
|
|
65
|
+
},
|
|
66
|
+
models: {
|
|
67
|
+
mode: "merge",
|
|
68
|
+
providers: {
|
|
69
|
+
moonshot: {
|
|
70
|
+
baseUrl: "https://api.moonshot.ai/v1",
|
|
71
|
+
apiKey: "${MOONSHOT_API_KEY}",
|
|
72
|
+
api: "openai-completions",
|
|
73
|
+
models: [
|
|
74
|
+
// moonshot-kimi-k2-models:start
|
|
75
|
+
{
|
|
76
|
+
id: "kimi-k2.5",
|
|
77
|
+
name: "Kimi K2.5",
|
|
78
|
+
reasoning: false,
|
|
79
|
+
input: ["text"],
|
|
80
|
+
cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
|
|
81
|
+
contextWindow: 256000,
|
|
82
|
+
maxTokens: 8192,
|
|
83
|
+
},
|
|
84
|
+
{
|
|
85
|
+
id: "kimi-k2-0905-preview",
|
|
86
|
+
name: "Kimi K2 0905 Preview",
|
|
87
|
+
reasoning: false,
|
|
88
|
+
input: ["text"],
|
|
89
|
+
cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
|
|
90
|
+
contextWindow: 256000,
|
|
91
|
+
maxTokens: 8192,
|
|
92
|
+
},
|
|
93
|
+
{
|
|
94
|
+
id: "kimi-k2-turbo-preview",
|
|
95
|
+
name: "Kimi K2 Turbo",
|
|
96
|
+
reasoning: false,
|
|
97
|
+
input: ["text"],
|
|
98
|
+
cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
|
|
99
|
+
contextWindow: 256000,
|
|
100
|
+
maxTokens: 8192,
|
|
101
|
+
},
|
|
102
|
+
{
|
|
103
|
+
id: "kimi-k2-thinking",
|
|
104
|
+
name: "Kimi K2 Thinking",
|
|
105
|
+
reasoning: true,
|
|
106
|
+
input: ["text"],
|
|
107
|
+
cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
|
|
108
|
+
contextWindow: 256000,
|
|
109
|
+
maxTokens: 8192,
|
|
110
|
+
},
|
|
111
|
+
{
|
|
112
|
+
id: "kimi-k2-thinking-turbo",
|
|
113
|
+
name: "Kimi K2 Thinking Turbo",
|
|
114
|
+
reasoning: true,
|
|
115
|
+
input: ["text"],
|
|
116
|
+
cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
|
|
117
|
+
contextWindow: 256000,
|
|
118
|
+
maxTokens: 8192,
|
|
119
|
+
},
|
|
120
|
+
// moonshot-kimi-k2-models:end
|
|
121
|
+
],
|
|
122
|
+
},
|
|
123
|
+
},
|
|
124
|
+
},
|
|
125
|
+
}
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
## Kimi Coding
|
|
129
|
+
|
|
130
|
+
```json5
|
|
131
|
+
{
|
|
132
|
+
env: { KIMI_API_KEY: "sk-..." },
|
|
133
|
+
agents: {
|
|
134
|
+
defaults: {
|
|
135
|
+
model: { primary: "kimi-coding/k2p5" },
|
|
136
|
+
models: {
|
|
137
|
+
"kimi-coding/k2p5": { alias: "Kimi K2.5" },
|
|
138
|
+
},
|
|
139
|
+
},
|
|
140
|
+
},
|
|
141
|
+
}
|
|
142
|
+
```
|
|
143
|
+
|
|
144
|
+
## 说明
|
|
145
|
+
|
|
146
|
+
- Moonshot 模型引用使用 `moonshot/<modelId>`。Kimi Coding 模型引用使用 `kimi-coding/<modelId>`。
|
|
147
|
+
- 如有需要,可在 `models.providers` 中覆盖定价和上下文元数据。
|
|
148
|
+
- 如果 Moonshot 为某个模型发布了不同的上下文限制,请相应调整
|
|
149
|
+
`contextWindow`。
|
|
150
|
+
- 国际端点使用 `https://api.moonshot.ai/v1`,中国端点使用 `https://api.moonshot.cn/v1`。
|
|
151
|
+
|
|
152
|
+
## 原生 thinking 模式(Moonshot)
|
|
153
|
+
|
|
154
|
+
Moonshot Kimi 支持二元原生 thinking:
|
|
155
|
+
|
|
156
|
+
- `thinking: { type: "enabled" }`
|
|
157
|
+
- `thinking: { type: "disabled" }`
|
|
158
|
+
|
|
159
|
+
通过 `agents.defaults.models.<provider/model>.params` 为每个模型进行配置:
|
|
160
|
+
|
|
161
|
+
```json5
|
|
162
|
+
{
|
|
163
|
+
agents: {
|
|
164
|
+
defaults: {
|
|
165
|
+
models: {
|
|
166
|
+
"moonshot/kimi-k2.5": {
|
|
167
|
+
params: {
|
|
168
|
+
thinking: { type: "disabled" },
|
|
169
|
+
},
|
|
170
|
+
},
|
|
171
|
+
},
|
|
172
|
+
},
|
|
173
|
+
},
|
|
174
|
+
}
|
|
175
|
+
```
|
|
176
|
+
|
|
177
|
+
QuantumClaw 还会为 Moonshot 映射运行时 `/think` 级别:
|
|
178
|
+
|
|
179
|
+
- `/think off` -> `thinking.type=disabled`
|
|
180
|
+
- 任何非 off 的 thinking 级别 -> `thinking.type=enabled`
|
|
181
|
+
|
|
182
|
+
当启用 Moonshot thinking 时,`tool_choice` 必须为 `auto` 或 `none`。为保持兼容性,QuantumClaw 会将不兼容的 `tool_choice` 值标准化为 `auto`。
|