@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.
Files changed (821) hide show
  1. package/CHANGELOG.md +4601 -0
  2. package/LICENSE +21 -0
  3. package/README.md +559 -0
  4. package/assets/avatar-placeholder.svg +19 -0
  5. package/assets/chrome-extension/icons/icon128.png +0 -0
  6. package/assets/chrome-extension/icons/icon16.png +0 -0
  7. package/assets/chrome-extension/icons/icon32.png +0 -0
  8. package/assets/chrome-extension/icons/icon48.png +0 -0
  9. package/assets/dmg-background-small.png +0 -0
  10. package/assets/dmg-background.png +0 -0
  11. package/docs/.i18n/README.md +31 -0
  12. package/docs/.i18n/glossary.ja-JP.json +14 -0
  13. package/docs/.i18n/glossary.zh-CN.json +302 -0
  14. package/docs/.i18n/ja-JP.tm.jsonl +0 -0
  15. package/docs/assets/install-script.svg +1 -0
  16. package/docs/assets/macos-onboarding/01-macos-warning.jpeg +0 -0
  17. package/docs/assets/macos-onboarding/02-local-networks.jpeg +0 -0
  18. package/docs/assets/macos-onboarding/03-security-notice.png +0 -0
  19. package/docs/assets/macos-onboarding/04-choose-gateway.png +0 -0
  20. package/docs/assets/macos-onboarding/05-permissions.png +0 -0
  21. package/docs/assets/pixel-lobster.svg +60 -0
  22. package/docs/assets/quantumclaw-logo-text-dark.png +0 -0
  23. package/docs/assets/quantumclaw-logo-text-dark.svg +418 -0
  24. package/docs/assets/quantumclaw-logo-text.png +0 -0
  25. package/docs/assets/quantumclaw-logo-text.svg +418 -0
  26. package/docs/assets/showcase/agents-ui.jpg +0 -0
  27. package/docs/assets/showcase/bambu-cli.png +0 -0
  28. package/docs/assets/showcase/codexmonitor.png +0 -0
  29. package/docs/assets/showcase/gohome-grafana.png +0 -0
  30. package/docs/assets/showcase/ios-testflight.jpg +0 -0
  31. package/docs/assets/showcase/oura-health.png +0 -0
  32. package/docs/assets/showcase/padel-cli.svg +11 -0
  33. package/docs/assets/showcase/padel-screenshot.jpg +0 -0
  34. package/docs/assets/showcase/papla-tts.jpg +0 -0
  35. package/docs/assets/showcase/pr-review-telegram.jpg +0 -0
  36. package/docs/assets/showcase/roborock-screenshot.jpg +0 -0
  37. package/docs/assets/showcase/roborock-status.svg +13 -0
  38. package/docs/assets/showcase/roof-camera-sky.jpg +0 -0
  39. package/docs/assets/showcase/snag.png +0 -0
  40. package/docs/assets/showcase/tesco-shop.jpg +0 -0
  41. package/docs/assets/showcase/wienerlinien.png +0 -0
  42. package/docs/assets/showcase/wine-cellar-skill.jpg +0 -0
  43. package/docs/assets/showcase/winix-air-purifier.jpg +0 -0
  44. package/docs/assets/showcase/xuezh-pronunciation.jpeg +0 -0
  45. package/docs/assets/sponsors/blacksmith.svg +14 -0
  46. package/docs/assets/sponsors/convex.svg +16 -0
  47. package/docs/assets/sponsors/openai.svg +3 -0
  48. package/docs/assets/sponsors/vercel.svg +5 -0
  49. package/docs/auth-credential-semantics.md +53 -0
  50. package/docs/automation/auth-monitoring.md +44 -0
  51. package/docs/automation/cron-jobs.md +727 -0
  52. package/docs/automation/cron-vs-heartbeat.md +286 -0
  53. package/docs/automation/gmail-pubsub.md +256 -0
  54. package/docs/automation/hooks.md +1056 -0
  55. package/docs/automation/poll.md +86 -0
  56. package/docs/automation/standing-orders.md +251 -0
  57. package/docs/automation/troubleshooting.md +122 -0
  58. package/docs/automation/webhook.md +217 -0
  59. package/docs/brave-search.md +93 -0
  60. package/docs/channels/bluebubbles.md +347 -0
  61. package/docs/channels/broadcast-groups.md +442 -0
  62. package/docs/channels/channel-routing.md +139 -0
  63. package/docs/channels/discord.md +1229 -0
  64. package/docs/channels/feishu.md +747 -0
  65. package/docs/channels/googlechat.md +261 -0
  66. package/docs/channels/group-messages.md +84 -0
  67. package/docs/channels/groups.md +379 -0
  68. package/docs/channels/imessage.md +367 -0
  69. package/docs/channels/index.md +47 -0
  70. package/docs/channels/irc.md +242 -0
  71. package/docs/channels/line.md +194 -0
  72. package/docs/channels/location.md +56 -0
  73. package/docs/channels/matrix.md +677 -0
  74. package/docs/channels/mattermost.md +427 -0
  75. package/docs/channels/msteams.md +780 -0
  76. package/docs/channels/nextcloud-talk.md +138 -0
  77. package/docs/channels/nostr.md +249 -0
  78. package/docs/channels/pairing.md +114 -0
  79. package/docs/channels/signal.md +329 -0
  80. package/docs/channels/slack.md +603 -0
  81. package/docs/channels/synology-chat.md +134 -0
  82. package/docs/channels/telegram.md +987 -0
  83. package/docs/channels/tlon.md +276 -0
  84. package/docs/channels/troubleshooting.md +118 -0
  85. package/docs/channels/twitch.md +379 -0
  86. package/docs/channels/whatsapp.md +460 -0
  87. package/docs/channels/zalo.md +243 -0
  88. package/docs/channels/zalouser.md +181 -0
  89. package/docs/ci.md +55 -0
  90. package/docs/cli/acp.md +288 -0
  91. package/docs/cli/agent.md +29 -0
  92. package/docs/cli/agents.md +123 -0
  93. package/docs/cli/approvals.md +50 -0
  94. package/docs/cli/backup.md +76 -0
  95. package/docs/cli/browser.md +106 -0
  96. package/docs/cli/channels.md +102 -0
  97. package/docs/cli/clawbot.md +21 -0
  98. package/docs/cli/completion.md +35 -0
  99. package/docs/cli/config.md +295 -0
  100. package/docs/cli/configure.md +36 -0
  101. package/docs/cli/cron.md +77 -0
  102. package/docs/cli/daemon.md +53 -0
  103. package/docs/cli/dashboard.md +22 -0
  104. package/docs/cli/devices.md +139 -0
  105. package/docs/cli/directory.md +63 -0
  106. package/docs/cli/dns.md +23 -0
  107. package/docs/cli/docs.md +15 -0
  108. package/docs/cli/doctor.md +48 -0
  109. package/docs/cli/gateway.md +235 -0
  110. package/docs/cli/health.md +21 -0
  111. package/docs/cli/hooks.md +329 -0
  112. package/docs/cli/index.md +1150 -0
  113. package/docs/cli/logs.md +28 -0
  114. package/docs/cli/memory.md +66 -0
  115. package/docs/cli/message.md +278 -0
  116. package/docs/cli/models.md +81 -0
  117. package/docs/cli/node.md +127 -0
  118. package/docs/cli/nodes.md +75 -0
  119. package/docs/cli/onboard.md +157 -0
  120. package/docs/cli/pairing.md +32 -0
  121. package/docs/cli/plugins.md +210 -0
  122. package/docs/cli/qr.md +46 -0
  123. package/docs/cli/reset.md +20 -0
  124. package/docs/cli/sandbox.md +197 -0
  125. package/docs/cli/secrets.md +188 -0
  126. package/docs/cli/security.md +79 -0
  127. package/docs/cli/sessions.md +110 -0
  128. package/docs/cli/setup.md +29 -0
  129. package/docs/cli/skills.md +36 -0
  130. package/docs/cli/status.md +30 -0
  131. package/docs/cli/system.md +60 -0
  132. package/docs/cli/tui.md +30 -0
  133. package/docs/cli/uninstall.md +20 -0
  134. package/docs/cli/update.md +103 -0
  135. package/docs/cli/voicecall.md +34 -0
  136. package/docs/cli/webhooks.md +25 -0
  137. package/docs/concepts/agent-loop.md +148 -0
  138. package/docs/concepts/agent-workspace.md +236 -0
  139. package/docs/concepts/agent.md +122 -0
  140. package/docs/concepts/architecture.md +137 -0
  141. package/docs/concepts/compaction.md +123 -0
  142. package/docs/concepts/context-engine.md +268 -0
  143. package/docs/concepts/context.md +172 -0
  144. package/docs/concepts/delegate-architecture.md +296 -0
  145. package/docs/concepts/features.md +73 -0
  146. package/docs/concepts/markdown-formatting.md +130 -0
  147. package/docs/concepts/memory.md +108 -0
  148. package/docs/concepts/messages.md +154 -0
  149. package/docs/concepts/model-failover.md +152 -0
  150. package/docs/concepts/model-providers.md +607 -0
  151. package/docs/concepts/models.md +225 -0
  152. package/docs/concepts/multi-agent.md +552 -0
  153. package/docs/concepts/oauth.md +158 -0
  154. package/docs/concepts/presence.md +102 -0
  155. package/docs/concepts/queue.md +89 -0
  156. package/docs/concepts/retry.md +69 -0
  157. package/docs/concepts/session-pruning.md +121 -0
  158. package/docs/concepts/session-tool.md +242 -0
  159. package/docs/concepts/session.md +310 -0
  160. package/docs/concepts/streaming.md +155 -0
  161. package/docs/concepts/system-prompt.md +132 -0
  162. package/docs/concepts/timezone.md +91 -0
  163. package/docs/concepts/typebox.md +291 -0
  164. package/docs/concepts/typing-indicators.md +68 -0
  165. package/docs/concepts/usage-tracking.md +35 -0
  166. package/docs/date-time.md +128 -0
  167. package/docs/debug/node-issue.md +85 -0
  168. package/docs/diagnostics/flags.md +91 -0
  169. package/docs/docs.json +2078 -0
  170. package/docs/gateway/authentication.md +179 -0
  171. package/docs/gateway/background-process.md +97 -0
  172. package/docs/gateway/bonjour.md +177 -0
  173. package/docs/gateway/bridge-protocol.md +91 -0
  174. package/docs/gateway/cli-backends.md +225 -0
  175. package/docs/gateway/configuration-examples.md +651 -0
  176. package/docs/gateway/configuration-reference.md +3123 -0
  177. package/docs/gateway/configuration.md +633 -0
  178. package/docs/gateway/discovery.md +123 -0
  179. package/docs/gateway/doctor.md +362 -0
  180. package/docs/gateway/gateway-lock.md +34 -0
  181. package/docs/gateway/health.md +44 -0
  182. package/docs/gateway/heartbeat.md +393 -0
  183. package/docs/gateway/index.md +261 -0
  184. package/docs/gateway/local-models.md +152 -0
  185. package/docs/gateway/logging.md +113 -0
  186. package/docs/gateway/multiple-gateways.md +112 -0
  187. package/docs/gateway/network-model.md +22 -0
  188. package/docs/gateway/openai-http-api.md +132 -0
  189. package/docs/gateway/openresponses-http-api.md +295 -0
  190. package/docs/gateway/openshell.md +307 -0
  191. package/docs/gateway/pairing.md +99 -0
  192. package/docs/gateway/protocol.md +267 -0
  193. package/docs/gateway/remote-gateway-readme.md +158 -0
  194. package/docs/gateway/remote.md +153 -0
  195. package/docs/gateway/sandbox-vs-tool-policy-vs-elevated.md +134 -0
  196. package/docs/gateway/sandboxing.md +469 -0
  197. package/docs/gateway/secrets-plan-contract.md +116 -0
  198. package/docs/gateway/secrets.md +503 -0
  199. package/docs/gateway/security/index.md +1220 -0
  200. package/docs/gateway/tailscale.md +132 -0
  201. package/docs/gateway/tools-invoke-http-api.md +118 -0
  202. package/docs/gateway/troubleshooting.md +378 -0
  203. package/docs/gateway/trusted-proxy-auth.md +330 -0
  204. package/docs/help/debugging.md +168 -0
  205. package/docs/help/environment.md +163 -0
  206. package/docs/help/faq.md +2997 -0
  207. package/docs/help/index.md +28 -0
  208. package/docs/help/scripts.md +28 -0
  209. package/docs/help/testing.md +526 -0
  210. package/docs/help/troubleshooting.md +297 -0
  211. package/docs/images/configure-model-picker-unsearchable.png +0 -0
  212. package/docs/images/feishu-step2-create-app.png +0 -0
  213. package/docs/images/feishu-step3-credentials.png +0 -0
  214. package/docs/images/feishu-step4-permissions.png +0 -0
  215. package/docs/images/feishu-step5-bot-capability.png +0 -0
  216. package/docs/images/feishu-step6-event-subscription.png +0 -0
  217. package/docs/images/feishu-verification-token.png +0 -0
  218. package/docs/images/groups-flow.svg +52 -0
  219. package/docs/images/mobile-ui-screenshot.png +0 -0
  220. package/docs/index.md +196 -0
  221. package/docs/install/ansible.md +230 -0
  222. package/docs/install/azure.md +311 -0
  223. package/docs/install/bun.md +55 -0
  224. package/docs/install/development-channels.md +120 -0
  225. package/docs/install/digitalocean.md +129 -0
  226. package/docs/install/docker-vm-runtime.md +142 -0
  227. package/docs/install/docker.md +375 -0
  228. package/docs/install/exe-dev.md +126 -0
  229. package/docs/install/fly.md +501 -0
  230. package/docs/install/gcp.md +402 -0
  231. package/docs/install/hetzner.md +251 -0
  232. package/docs/install/index.md +183 -0
  233. package/docs/install/installer.md +415 -0
  234. package/docs/install/kubernetes.md +191 -0
  235. package/docs/install/macos-vm.md +281 -0
  236. package/docs/install/migrating-matrix.md +346 -0
  237. package/docs/install/migrating.md +110 -0
  238. package/docs/install/nix.md +89 -0
  239. package/docs/install/node.md +138 -0
  240. package/docs/install/northflank.mdx +54 -0
  241. package/docs/install/oracle.md +156 -0
  242. package/docs/install/podman.md +133 -0
  243. package/docs/install/railway.mdx +100 -0
  244. package/docs/install/raspberry-pi.md +159 -0
  245. package/docs/install/render.mdx +169 -0
  246. package/docs/install/uninstall.md +128 -0
  247. package/docs/install/updating.md +128 -0
  248. package/docs/ja-JP/index.md +186 -0
  249. package/docs/ja-JP/start/getting-started.md +125 -0
  250. package/docs/ja-JP/start/wizard.md +77 -0
  251. package/docs/logging.md +352 -0
  252. package/docs/nav-tabs-underline.js +100 -0
  253. package/docs/network.md +54 -0
  254. package/docs/nodes/audio.md +187 -0
  255. package/docs/nodes/camera.md +162 -0
  256. package/docs/nodes/images.md +72 -0
  257. package/docs/nodes/index.md +393 -0
  258. package/docs/nodes/location-command.md +98 -0
  259. package/docs/nodes/media-understanding.md +394 -0
  260. package/docs/nodes/talk.md +92 -0
  261. package/docs/nodes/troubleshooting.md +114 -0
  262. package/docs/nodes/voicewake.md +66 -0
  263. package/docs/perplexity.md +174 -0
  264. package/docs/pi-dev.md +80 -0
  265. package/docs/pi.md +567 -0
  266. package/docs/platforms/android.md +168 -0
  267. package/docs/platforms/digitalocean.md +266 -0
  268. package/docs/platforms/index.md +54 -0
  269. package/docs/platforms/ios.md +220 -0
  270. package/docs/platforms/linux.md +94 -0
  271. package/docs/platforms/mac/bundled-gateway.md +73 -0
  272. package/docs/platforms/mac/canvas.md +125 -0
  273. package/docs/platforms/mac/child-process.md +69 -0
  274. package/docs/platforms/mac/dev-setup.md +104 -0
  275. package/docs/platforms/mac/health.md +34 -0
  276. package/docs/platforms/mac/icon.md +31 -0
  277. package/docs/platforms/mac/logging.md +57 -0
  278. package/docs/platforms/mac/menu-bar.md +81 -0
  279. package/docs/platforms/mac/peekaboo.md +65 -0
  280. package/docs/platforms/mac/permissions.md +50 -0
  281. package/docs/platforms/mac/remote.md +84 -0
  282. package/docs/platforms/mac/signing.md +47 -0
  283. package/docs/platforms/mac/skills.md +33 -0
  284. package/docs/platforms/mac/voice-overlay.md +60 -0
  285. package/docs/platforms/mac/voicewake.md +67 -0
  286. package/docs/platforms/mac/webchat.md +43 -0
  287. package/docs/platforms/mac/xpc.md +61 -0
  288. package/docs/platforms/macos.md +226 -0
  289. package/docs/platforms/oracle.md +303 -0
  290. package/docs/platforms/raspberry-pi.md +412 -0
  291. package/docs/platforms/windows.md +241 -0
  292. package/docs/plugins/agent-tools.md +10 -0
  293. package/docs/plugins/architecture.md +1366 -0
  294. package/docs/plugins/building-extensions.md +10 -0
  295. package/docs/plugins/building-plugins.md +239 -0
  296. package/docs/plugins/bundles.md +181 -0
  297. package/docs/plugins/community.md +145 -0
  298. package/docs/plugins/manifest.md +241 -0
  299. package/docs/plugins/sdk-channel-plugins.md +370 -0
  300. package/docs/plugins/sdk-entrypoints.md +161 -0
  301. package/docs/plugins/sdk-migration.md +172 -0
  302. package/docs/plugins/sdk-overview.md +196 -0
  303. package/docs/plugins/sdk-provider-plugins.md +370 -0
  304. package/docs/plugins/sdk-runtime.md +345 -0
  305. package/docs/plugins/sdk-setup.md +331 -0
  306. package/docs/plugins/sdk-testing.md +263 -0
  307. package/docs/plugins/voice-call.md +380 -0
  308. package/docs/plugins/zalouser.md +77 -0
  309. package/docs/prose.md +134 -0
  310. package/docs/providers/anthropic.md +259 -0
  311. package/docs/providers/bedrock.md +176 -0
  312. package/docs/providers/claude-max-api-proxy.md +154 -0
  313. package/docs/providers/cloudflare-ai-gateway.md +71 -0
  314. package/docs/providers/deepgram.md +93 -0
  315. package/docs/providers/github-copilot.md +72 -0
  316. package/docs/providers/glm.md +43 -0
  317. package/docs/providers/google.md +78 -0
  318. package/docs/providers/groq.md +96 -0
  319. package/docs/providers/huggingface.md +209 -0
  320. package/docs/providers/index.md +69 -0
  321. package/docs/providers/kilocode.md +74 -0
  322. package/docs/providers/litellm.md +154 -0
  323. package/docs/providers/minimax.md +224 -0
  324. package/docs/providers/mistral.md +54 -0
  325. package/docs/providers/models.md +45 -0
  326. package/docs/providers/modelstudio.md +66 -0
  327. package/docs/providers/moonshot.md +175 -0
  328. package/docs/providers/nvidia.md +55 -0
  329. package/docs/providers/ollama.md +352 -0
  330. package/docs/providers/openai.md +303 -0
  331. package/docs/providers/opencode-go.md +45 -0
  332. package/docs/providers/opencode.md +64 -0
  333. package/docs/providers/openrouter.md +37 -0
  334. package/docs/providers/perplexity-provider.md +62 -0
  335. package/docs/providers/qianfan.md +38 -0
  336. package/docs/providers/qwen.md +53 -0
  337. package/docs/providers/sglang.md +104 -0
  338. package/docs/providers/synthetic.md +99 -0
  339. package/docs/providers/together.md +66 -0
  340. package/docs/providers/venice.md +282 -0
  341. package/docs/providers/vercel-ai-gateway.md +60 -0
  342. package/docs/providers/vllm.md +92 -0
  343. package/docs/providers/volcengine.md +74 -0
  344. package/docs/providers/xai.md +60 -0
  345. package/docs/providers/xiaomi.md +86 -0
  346. package/docs/providers/zai.md +46 -0
  347. package/docs/reference/AGENTS.default.md +126 -0
  348. package/docs/reference/RELEASING.md +42 -0
  349. package/docs/reference/api-usage-costs.md +144 -0
  350. package/docs/reference/credits.md +30 -0
  351. package/docs/reference/device-models.md +47 -0
  352. package/docs/reference/memory-config.md +711 -0
  353. package/docs/reference/prompt-caching.md +185 -0
  354. package/docs/reference/rpc.md +43 -0
  355. package/docs/reference/secretref-credential-surface.md +140 -0
  356. package/docs/reference/secretref-user-supplied-credentials-matrix.json +563 -0
  357. package/docs/reference/session-management-compaction.md +324 -0
  358. package/docs/reference/templates/AGENTS.dev.md +83 -0
  359. package/docs/reference/templates/AGENTS.md +219 -0
  360. package/docs/reference/templates/BOOT.md +11 -0
  361. package/docs/reference/templates/BOOTSTRAP.md +62 -0
  362. package/docs/reference/templates/HEARTBEAT.md +14 -0
  363. package/docs/reference/templates/IDENTITY.dev.md +47 -0
  364. package/docs/reference/templates/IDENTITY.md +29 -0
  365. package/docs/reference/templates/SOUL.dev.md +76 -0
  366. package/docs/reference/templates/SOUL.md +43 -0
  367. package/docs/reference/templates/TOOLS.dev.md +24 -0
  368. package/docs/reference/templates/TOOLS.md +47 -0
  369. package/docs/reference/templates/USER.dev.md +18 -0
  370. package/docs/reference/templates/USER.md +23 -0
  371. package/docs/reference/test.md +90 -0
  372. package/docs/reference/token-use.md +175 -0
  373. package/docs/reference/transcript-hygiene.md +151 -0
  374. package/docs/reference/wizard.md +235 -0
  375. package/docs/security/CONTRIBUTING-THREAT-MODEL.md +98 -0
  376. package/docs/security/THREAT-MODEL-ATLAS.md +611 -0
  377. package/docs/security/formal-verification.md +167 -0
  378. package/docs/start/bootstrapping.md +41 -0
  379. package/docs/start/docs-directory.md +66 -0
  380. package/docs/start/getting-started.md +116 -0
  381. package/docs/start/hubs.md +198 -0
  382. package/docs/start/lore.md +219 -0
  383. package/docs/start/onboarding-overview.md +67 -0
  384. package/docs/start/onboarding.md +91 -0
  385. package/docs/start/openclaw.md +221 -0
  386. package/docs/start/quickstart.md +22 -0
  387. package/docs/start/setup.md +164 -0
  388. package/docs/start/showcase.md +418 -0
  389. package/docs/start/wizard-cli-automation.md +215 -0
  390. package/docs/start/wizard-cli-reference.md +299 -0
  391. package/docs/start/wizard.md +125 -0
  392. package/docs/style.css +37 -0
  393. package/docs/tools/acp-agents.md +623 -0
  394. package/docs/tools/agent-send.md +100 -0
  395. package/docs/tools/apply-patch.md +51 -0
  396. package/docs/tools/brave-search.md +93 -0
  397. package/docs/tools/browser-linux-troubleshooting.md +138 -0
  398. package/docs/tools/browser-login.md +73 -0
  399. package/docs/tools/browser-wsl2-windows-remote-cdp-troubleshooting.md +211 -0
  400. package/docs/tools/browser.md +731 -0
  401. package/docs/tools/btw.md +142 -0
  402. package/docs/tools/capability-cookbook.md +119 -0
  403. package/docs/tools/clawhub.md +298 -0
  404. package/docs/tools/creating-skills.md +117 -0
  405. package/docs/tools/diffs.md +386 -0
  406. package/docs/tools/elevated.md +114 -0
  407. package/docs/tools/exec-approvals.md +430 -0
  408. package/docs/tools/exec.md +207 -0
  409. package/docs/tools/firecrawl.md +140 -0
  410. package/docs/tools/index.md +137 -0
  411. package/docs/tools/llm-task.md +119 -0
  412. package/docs/tools/lobster.md +340 -0
  413. package/docs/tools/loop-detection.md +100 -0
  414. package/docs/tools/multi-agent-sandbox-tools.md +364 -0
  415. package/docs/tools/pdf.md +156 -0
  416. package/docs/tools/perplexity-search.md +174 -0
  417. package/docs/tools/plugin.md +255 -0
  418. package/docs/tools/reactions.md +64 -0
  419. package/docs/tools/skills-config.md +86 -0
  420. package/docs/tools/skills.md +309 -0
  421. package/docs/tools/slash-commands.md +294 -0
  422. package/docs/tools/subagents.md +295 -0
  423. package/docs/tools/tavily.md +125 -0
  424. package/docs/tools/thinking.md +96 -0
  425. package/docs/tools/tts.md +406 -0
  426. package/docs/tools/web.md +516 -0
  427. package/docs/tts.md +406 -0
  428. package/docs/vps.md +112 -0
  429. package/docs/web/control-ui.md +275 -0
  430. package/docs/web/dashboard.md +54 -0
  431. package/docs/web/index.md +120 -0
  432. package/docs/web/tui.md +170 -0
  433. package/docs/web/webchat.md +61 -0
  434. package/docs/whatsapp-openclaw-ai-zh.jpg +0 -0
  435. package/docs/whatsapp-openclaw.jpg +0 -0
  436. package/docs/zh-CN/AGENTS.md +61 -0
  437. package/docs/zh-CN/automation/auth-monitoring.md +47 -0
  438. package/docs/zh-CN/automation/cron-jobs.md +435 -0
  439. package/docs/zh-CN/automation/cron-vs-heartbeat.md +286 -0
  440. package/docs/zh-CN/automation/gmail-pubsub.md +249 -0
  441. package/docs/zh-CN/automation/hooks.md +1051 -0
  442. package/docs/zh-CN/automation/poll.md +76 -0
  443. package/docs/zh-CN/automation/troubleshooting.md +8 -0
  444. package/docs/zh-CN/automation/webhook.md +163 -0
  445. package/docs/zh-CN/brave-search.md +60 -0
  446. package/docs/zh-CN/channels/bluebubbles.md +354 -0
  447. package/docs/zh-CN/channels/broadcast-groups.md +449 -0
  448. package/docs/zh-CN/channels/channel-routing.md +117 -0
  449. package/docs/zh-CN/channels/discord.md +468 -0
  450. package/docs/zh-CN/channels/feishu.md +728 -0
  451. package/docs/zh-CN/channels/googlechat.md +257 -0
  452. package/docs/zh-CN/channels/grammy.md +38 -0
  453. package/docs/zh-CN/channels/group-messages.md +91 -0
  454. package/docs/zh-CN/channels/groups.md +379 -0
  455. package/docs/zh-CN/channels/imessage.md +302 -0
  456. package/docs/zh-CN/channels/index.md +53 -0
  457. package/docs/zh-CN/channels/line.md +180 -0
  458. package/docs/zh-CN/channels/location.md +63 -0
  459. package/docs/zh-CN/channels/matrix.md +221 -0
  460. package/docs/zh-CN/channels/mattermost.md +144 -0
  461. package/docs/zh-CN/channels/msteams.md +775 -0
  462. package/docs/zh-CN/channels/nextcloud-talk.md +142 -0
  463. package/docs/zh-CN/channels/nostr.md +249 -0
  464. package/docs/zh-CN/channels/pairing.md +89 -0
  465. package/docs/zh-CN/channels/signal.md +209 -0
  466. package/docs/zh-CN/channels/slack.md +531 -0
  467. package/docs/zh-CN/channels/synology-chat.md +138 -0
  468. package/docs/zh-CN/channels/telegram.md +751 -0
  469. package/docs/zh-CN/channels/tlon.md +136 -0
  470. package/docs/zh-CN/channels/troubleshooting.md +36 -0
  471. package/docs/zh-CN/channels/twitch.md +385 -0
  472. package/docs/zh-CN/channels/whatsapp.md +411 -0
  473. package/docs/zh-CN/channels/zalo.md +196 -0
  474. package/docs/zh-CN/channels/zalouser.md +147 -0
  475. package/docs/zh-CN/cli/acp.md +173 -0
  476. package/docs/zh-CN/cli/agent.md +30 -0
  477. package/docs/zh-CN/cli/agents.md +82 -0
  478. package/docs/zh-CN/cli/approvals.md +57 -0
  479. package/docs/zh-CN/cli/browser.md +114 -0
  480. package/docs/zh-CN/cli/channels.md +86 -0
  481. package/docs/zh-CN/cli/config.md +57 -0
  482. package/docs/zh-CN/cli/configure.md +38 -0
  483. package/docs/zh-CN/cli/cron.md +43 -0
  484. package/docs/zh-CN/cli/dashboard.md +23 -0
  485. package/docs/zh-CN/cli/devices.md +74 -0
  486. package/docs/zh-CN/cli/directory.md +70 -0
  487. package/docs/zh-CN/cli/dns.md +30 -0
  488. package/docs/zh-CN/cli/docs.md +22 -0
  489. package/docs/zh-CN/cli/doctor.md +48 -0
  490. package/docs/zh-CN/cli/gateway.md +206 -0
  491. package/docs/zh-CN/cli/health.md +28 -0
  492. package/docs/zh-CN/cli/hooks.md +298 -0
  493. package/docs/zh-CN/cli/index.md +1143 -0
  494. package/docs/zh-CN/cli/logs.md +31 -0
  495. package/docs/zh-CN/cli/memory.md +52 -0
  496. package/docs/zh-CN/cli/message.md +246 -0
  497. package/docs/zh-CN/cli/models.md +85 -0
  498. package/docs/zh-CN/cli/node.md +115 -0
  499. package/docs/zh-CN/cli/nodes.md +80 -0
  500. package/docs/zh-CN/cli/onboard.md +164 -0
  501. package/docs/zh-CN/cli/pairing.md +28 -0
  502. package/docs/zh-CN/cli/plugins.md +66 -0
  503. package/docs/zh-CN/cli/reset.md +24 -0
  504. package/docs/zh-CN/cli/sandbox.md +158 -0
  505. package/docs/zh-CN/cli/security.md +33 -0
  506. package/docs/zh-CN/cli/sessions.md +23 -0
  507. package/docs/zh-CN/cli/setup.md +36 -0
  508. package/docs/zh-CN/cli/skills.md +33 -0
  509. package/docs/zh-CN/cli/status.md +33 -0
  510. package/docs/zh-CN/cli/system.md +63 -0
  511. package/docs/zh-CN/cli/tui.md +30 -0
  512. package/docs/zh-CN/cli/uninstall.md +24 -0
  513. package/docs/zh-CN/cli/update.md +101 -0
  514. package/docs/zh-CN/cli/voicecall.md +41 -0
  515. package/docs/zh-CN/cli/webhooks.md +32 -0
  516. package/docs/zh-CN/concepts/agent-loop.md +146 -0
  517. package/docs/zh-CN/concepts/agent-workspace.md +219 -0
  518. package/docs/zh-CN/concepts/agent.md +115 -0
  519. package/docs/zh-CN/concepts/architecture.md +123 -0
  520. package/docs/zh-CN/concepts/compaction.md +67 -0
  521. package/docs/zh-CN/concepts/context.md +168 -0
  522. package/docs/zh-CN/concepts/features.md +59 -0
  523. package/docs/zh-CN/concepts/markdown-formatting.md +117 -0
  524. package/docs/zh-CN/concepts/memory.md +412 -0
  525. package/docs/zh-CN/concepts/messages.md +141 -0
  526. package/docs/zh-CN/concepts/model-failover.md +145 -0
  527. package/docs/zh-CN/concepts/model-providers.md +606 -0
  528. package/docs/zh-CN/concepts/models.md +225 -0
  529. package/docs/zh-CN/concepts/multi-agent.md +372 -0
  530. package/docs/zh-CN/concepts/oauth.md +164 -0
  531. package/docs/zh-CN/concepts/presence.md +99 -0
  532. package/docs/zh-CN/concepts/queue.md +94 -0
  533. package/docs/zh-CN/concepts/retry.md +76 -0
  534. package/docs/zh-CN/concepts/session-pruning.md +129 -0
  535. package/docs/zh-CN/concepts/session-tool.md +200 -0
  536. package/docs/zh-CN/concepts/session.md +166 -0
  537. package/docs/zh-CN/concepts/streaming.md +133 -0
  538. package/docs/zh-CN/concepts/system-prompt.md +101 -0
  539. package/docs/zh-CN/concepts/timezone.md +96 -0
  540. package/docs/zh-CN/concepts/typebox.md +284 -0
  541. package/docs/zh-CN/concepts/typing-indicators.md +74 -0
  542. package/docs/zh-CN/concepts/usage-tracking.md +42 -0
  543. package/docs/zh-CN/date-time.md +129 -0
  544. package/docs/zh-CN/debug/node-issue.md +90 -0
  545. package/docs/zh-CN/diagnostics/flags.md +98 -0
  546. package/docs/zh-CN/gateway/authentication.md +184 -0
  547. package/docs/zh-CN/gateway/background-process.md +100 -0
  548. package/docs/zh-CN/gateway/bonjour.md +174 -0
  549. package/docs/zh-CN/gateway/bridge-protocol.md +86 -0
  550. package/docs/zh-CN/gateway/cli-backends.md +213 -0
  551. package/docs/zh-CN/gateway/configuration-examples.md +587 -0
  552. package/docs/zh-CN/gateway/configuration-reference.md +3103 -0
  553. package/docs/zh-CN/gateway/configuration.md +640 -0
  554. package/docs/zh-CN/gateway/discovery.md +123 -0
  555. package/docs/zh-CN/gateway/doctor.md +238 -0
  556. package/docs/zh-CN/gateway/gateway-lock.md +41 -0
  557. package/docs/zh-CN/gateway/health.md +42 -0
  558. package/docs/zh-CN/gateway/heartbeat.md +274 -0
  559. package/docs/zh-CN/gateway/index.md +335 -0
  560. package/docs/zh-CN/gateway/local-models.md +159 -0
  561. package/docs/zh-CN/gateway/logging.md +114 -0
  562. package/docs/zh-CN/gateway/multiple-gateways.md +119 -0
  563. package/docs/zh-CN/gateway/network-model.md +23 -0
  564. package/docs/zh-CN/gateway/openai-http-api.md +125 -0
  565. package/docs/zh-CN/gateway/openresponses-http-api.md +317 -0
  566. package/docs/zh-CN/gateway/pairing.md +99 -0
  567. package/docs/zh-CN/gateway/protocol.md +220 -0
  568. package/docs/zh-CN/gateway/remote-gateway-readme.md +164 -0
  569. package/docs/zh-CN/gateway/remote.md +133 -0
  570. package/docs/zh-CN/gateway/sandbox-vs-tool-policy-vs-elevated.md +135 -0
  571. package/docs/zh-CN/gateway/sandboxing.md +188 -0
  572. package/docs/zh-CN/gateway/security/index.md +777 -0
  573. package/docs/zh-CN/gateway/tailscale.md +124 -0
  574. package/docs/zh-CN/gateway/tools-invoke-http-api.md +92 -0
  575. package/docs/zh-CN/gateway/troubleshooting.md +771 -0
  576. package/docs/zh-CN/help/debugging.md +160 -0
  577. package/docs/zh-CN/help/environment.md +88 -0
  578. package/docs/zh-CN/help/faq.md +2640 -0
  579. package/docs/zh-CN/help/index.md +28 -0
  580. package/docs/zh-CN/help/scripts.md +35 -0
  581. package/docs/zh-CN/help/testing.md +375 -0
  582. package/docs/zh-CN/help/troubleshooting.md +104 -0
  583. package/docs/zh-CN/index.md +186 -0
  584. package/docs/zh-CN/install/ansible.md +215 -0
  585. package/docs/zh-CN/install/bun.md +65 -0
  586. package/docs/zh-CN/install/development-channels.md +81 -0
  587. package/docs/zh-CN/install/docker.md +532 -0
  588. package/docs/zh-CN/install/exe-dev.md +133 -0
  589. package/docs/zh-CN/install/fly.md +490 -0
  590. package/docs/zh-CN/install/gcp.md +510 -0
  591. package/docs/zh-CN/install/hetzner.md +337 -0
  592. package/docs/zh-CN/install/index.md +235 -0
  593. package/docs/zh-CN/install/installer.md +422 -0
  594. package/docs/zh-CN/install/macos-vm.md +288 -0
  595. package/docs/zh-CN/install/migrating.md +199 -0
  596. package/docs/zh-CN/install/nix.md +99 -0
  597. package/docs/zh-CN/install/node.md +8 -0
  598. package/docs/zh-CN/install/northflank.mdx +60 -0
  599. package/docs/zh-CN/install/railway.mdx +106 -0
  600. package/docs/zh-CN/install/render.mdx +169 -0
  601. package/docs/zh-CN/install/uninstall.md +135 -0
  602. package/docs/zh-CN/install/updating.md +233 -0
  603. package/docs/zh-CN/logging.md +329 -0
  604. package/docs/zh-CN/network.md +59 -0
  605. package/docs/zh-CN/nodes/audio.md +120 -0
  606. package/docs/zh-CN/nodes/camera.md +162 -0
  607. package/docs/zh-CN/nodes/images.md +79 -0
  608. package/docs/zh-CN/nodes/index.md +348 -0
  609. package/docs/zh-CN/nodes/location-command.md +120 -0
  610. package/docs/zh-CN/nodes/media-understanding.md +380 -0
  611. package/docs/zh-CN/nodes/talk.md +97 -0
  612. package/docs/zh-CN/nodes/troubleshooting.md +8 -0
  613. package/docs/zh-CN/nodes/voicewake.md +72 -0
  614. package/docs/zh-CN/perplexity.md +102 -0
  615. package/docs/zh-CN/pi-dev.md +77 -0
  616. package/docs/zh-CN/pi.md +619 -0
  617. package/docs/zh-CN/platforms/android.md +155 -0
  618. package/docs/zh-CN/platforms/digitalocean.md +273 -0
  619. package/docs/zh-CN/platforms/index.md +60 -0
  620. package/docs/zh-CN/platforms/ios.md +114 -0
  621. package/docs/zh-CN/platforms/linux.md +100 -0
  622. package/docs/zh-CN/platforms/mac/bundled-gateway.md +75 -0
  623. package/docs/zh-CN/platforms/mac/canvas.md +128 -0
  624. package/docs/zh-CN/platforms/mac/child-process.md +73 -0
  625. package/docs/zh-CN/platforms/mac/dev-setup.md +109 -0
  626. package/docs/zh-CN/platforms/mac/health.md +41 -0
  627. package/docs/zh-CN/platforms/mac/icon.md +38 -0
  628. package/docs/zh-CN/platforms/mac/logging.md +64 -0
  629. package/docs/zh-CN/platforms/mac/menu-bar.md +88 -0
  630. package/docs/zh-CN/platforms/mac/peekaboo.md +62 -0
  631. package/docs/zh-CN/platforms/mac/permissions.md +46 -0
  632. package/docs/zh-CN/platforms/mac/remote.md +90 -0
  633. package/docs/zh-CN/platforms/mac/signing.md +54 -0
  634. package/docs/zh-CN/platforms/mac/skills.md +40 -0
  635. package/docs/zh-CN/platforms/mac/voice-overlay.md +67 -0
  636. package/docs/zh-CN/platforms/mac/voicewake.md +74 -0
  637. package/docs/zh-CN/platforms/mac/webchat.md +43 -0
  638. package/docs/zh-CN/platforms/mac/xpc.md +68 -0
  639. package/docs/zh-CN/platforms/macos.md +193 -0
  640. package/docs/zh-CN/platforms/oracle.md +310 -0
  641. package/docs/zh-CN/platforms/raspberry-pi.md +416 -0
  642. package/docs/zh-CN/platforms/windows.md +247 -0
  643. package/docs/zh-CN/plugins/agent-tools.md +99 -0
  644. package/docs/zh-CN/plugins/manifest.md +68 -0
  645. package/docs/zh-CN/plugins/voice-call.md +250 -0
  646. package/docs/zh-CN/plugins/zalouser.md +88 -0
  647. package/docs/zh-CN/prose.md +141 -0
  648. package/docs/zh-CN/providers/anthropic.md +265 -0
  649. package/docs/zh-CN/providers/bedrock.md +170 -0
  650. package/docs/zh-CN/providers/claude-max-api-proxy.md +155 -0
  651. package/docs/zh-CN/providers/cloudflare-ai-gateway.md +78 -0
  652. package/docs/zh-CN/providers/deepgram.md +97 -0
  653. package/docs/zh-CN/providers/github-copilot.md +67 -0
  654. package/docs/zh-CN/providers/glm.md +50 -0
  655. package/docs/zh-CN/providers/huggingface.md +216 -0
  656. package/docs/zh-CN/providers/index.md +69 -0
  657. package/docs/zh-CN/providers/kilocode.md +80 -0
  658. package/docs/zh-CN/providers/litellm.md +160 -0
  659. package/docs/zh-CN/providers/minimax.md +222 -0
  660. package/docs/zh-CN/providers/mistral.md +61 -0
  661. package/docs/zh-CN/providers/models.md +51 -0
  662. package/docs/zh-CN/providers/moonshot.md +182 -0
  663. package/docs/zh-CN/providers/nvidia.md +62 -0
  664. package/docs/zh-CN/providers/ollama.md +359 -0
  665. package/docs/zh-CN/providers/openai.md +308 -0
  666. package/docs/zh-CN/providers/opencode-go.md +52 -0
  667. package/docs/zh-CN/providers/opencode.md +71 -0
  668. package/docs/zh-CN/providers/openrouter.md +44 -0
  669. package/docs/zh-CN/providers/qianfan.md +45 -0
  670. package/docs/zh-CN/providers/qwen.md +55 -0
  671. package/docs/zh-CN/providers/sglang.md +111 -0
  672. package/docs/zh-CN/providers/synthetic.md +106 -0
  673. package/docs/zh-CN/providers/together.md +72 -0
  674. package/docs/zh-CN/providers/venice.md +289 -0
  675. package/docs/zh-CN/providers/vercel-ai-gateway.md +66 -0
  676. package/docs/zh-CN/providers/xiaomi.md +93 -0
  677. package/docs/zh-CN/providers/zai.md +53 -0
  678. package/docs/zh-CN/reference/AGENTS.default.md +131 -0
  679. package/docs/zh-CN/reference/RELEASING.md +48 -0
  680. package/docs/zh-CN/reference/api-usage-costs.md +141 -0
  681. package/docs/zh-CN/reference/credits.md +34 -0
  682. package/docs/zh-CN/reference/device-models.md +54 -0
  683. package/docs/zh-CN/reference/rpc.md +48 -0
  684. package/docs/zh-CN/reference/session-management-compaction.md +287 -0
  685. package/docs/zh-CN/reference/templates/AGENTS.dev.md +89 -0
  686. package/docs/zh-CN/reference/templates/AGENTS.md +225 -0
  687. package/docs/zh-CN/reference/templates/BOOT.md +17 -0
  688. package/docs/zh-CN/reference/templates/BOOTSTRAP.md +68 -0
  689. package/docs/zh-CN/reference/templates/HEARTBEAT.md +18 -0
  690. package/docs/zh-CN/reference/templates/IDENTITY.dev.md +54 -0
  691. package/docs/zh-CN/reference/templates/IDENTITY.md +36 -0
  692. package/docs/zh-CN/reference/templates/SOUL.dev.md +83 -0
  693. package/docs/zh-CN/reference/templates/SOUL.md +49 -0
  694. package/docs/zh-CN/reference/templates/TOOLS.dev.md +31 -0
  695. package/docs/zh-CN/reference/templates/TOOLS.md +53 -0
  696. package/docs/zh-CN/reference/templates/USER.dev.md +25 -0
  697. package/docs/zh-CN/reference/templates/USER.md +30 -0
  698. package/docs/zh-CN/reference/test.md +57 -0
  699. package/docs/zh-CN/reference/token-use.md +119 -0
  700. package/docs/zh-CN/reference/transcript-hygiene.md +109 -0
  701. package/docs/zh-CN/reference/wizard.md +242 -0
  702. package/docs/zh-CN/security/formal-verification.md +171 -0
  703. package/docs/zh-CN/start/bootstrapping.md +9 -0
  704. package/docs/zh-CN/start/docs-directory.md +70 -0
  705. package/docs/zh-CN/start/getting-started.md +143 -0
  706. package/docs/zh-CN/start/hubs.md +194 -0
  707. package/docs/zh-CN/start/lore.md +226 -0
  708. package/docs/zh-CN/start/onboarding-overview.md +58 -0
  709. package/docs/zh-CN/start/onboarding.md +105 -0
  710. package/docs/zh-CN/start/openclaw.md +248 -0
  711. package/docs/zh-CN/start/quickstart.md +88 -0
  712. package/docs/zh-CN/start/setup.md +153 -0
  713. package/docs/zh-CN/start/showcase.md +423 -0
  714. package/docs/zh-CN/start/wizard-cli-automation.md +222 -0
  715. package/docs/zh-CN/start/wizard-cli-reference.md +306 -0
  716. package/docs/zh-CN/start/wizard.md +132 -0
  717. package/docs/zh-CN/tools/agent-send.md +59 -0
  718. package/docs/zh-CN/tools/apply-patch.md +57 -0
  719. package/docs/zh-CN/tools/browser-linux-troubleshooting.md +144 -0
  720. package/docs/zh-CN/tools/browser-login.md +75 -0
  721. package/docs/zh-CN/tools/browser.md +553 -0
  722. package/docs/zh-CN/tools/chrome-extension.md +183 -0
  723. package/docs/zh-CN/tools/clawhub.md +209 -0
  724. package/docs/zh-CN/tools/creating-skills.md +61 -0
  725. package/docs/zh-CN/tools/elevated.md +64 -0
  726. package/docs/zh-CN/tools/exec-approvals.md +234 -0
  727. package/docs/zh-CN/tools/exec.md +169 -0
  728. package/docs/zh-CN/tools/firecrawl.md +68 -0
  729. package/docs/zh-CN/tools/index.md +515 -0
  730. package/docs/zh-CN/tools/llm-task.md +117 -0
  731. package/docs/zh-CN/tools/lobster.md +349 -0
  732. package/docs/zh-CN/tools/multi-agent-sandbox-tools.md +401 -0
  733. package/docs/zh-CN/tools/plugin.md +1612 -0
  734. package/docs/zh-CN/tools/reactions.md +29 -0
  735. package/docs/zh-CN/tools/skills-config.md +78 -0
  736. package/docs/zh-CN/tools/skills.md +279 -0
  737. package/docs/zh-CN/tools/slash-commands.md +205 -0
  738. package/docs/zh-CN/tools/subagents.md +167 -0
  739. package/docs/zh-CN/tools/thinking.md +80 -0
  740. package/docs/zh-CN/tools/web.md +289 -0
  741. package/docs/zh-CN/tts.md +375 -0
  742. package/docs/zh-CN/vps.md +47 -0
  743. package/docs/zh-CN/web/control-ui.md +191 -0
  744. package/docs/zh-CN/web/dashboard.md +53 -0
  745. package/docs/zh-CN/web/index.md +118 -0
  746. package/docs/zh-CN/web/tui.md +166 -0
  747. package/docs/zh-CN/web/webchat.md +56 -0
  748. package/package.json +841 -0
  749. package/quantumclaw.mjs +135 -0
  750. package/skills/1password/SKILL.md +70 -0
  751. package/skills/1password/references/cli-examples.md +29 -0
  752. package/skills/1password/references/get-started.md +17 -0
  753. package/skills/apple-notes/SKILL.md +77 -0
  754. package/skills/apple-reminders/SKILL.md +118 -0
  755. package/skills/bear-notes/SKILL.md +107 -0
  756. package/skills/blogwatcher/SKILL.md +69 -0
  757. package/skills/blucli/SKILL.md +47 -0
  758. package/skills/bluebubbles/SKILL.md +131 -0
  759. package/skills/camsnap/SKILL.md +45 -0
  760. package/skills/canvas/SKILL.md +198 -0
  761. package/skills/clawhub/SKILL.md +77 -0
  762. package/skills/coding-agent/SKILL.md +295 -0
  763. package/skills/discord/SKILL.md +197 -0
  764. package/skills/eightctl/SKILL.md +50 -0
  765. package/skills/gemini/SKILL.md +43 -0
  766. package/skills/gh-issues/SKILL.md +865 -0
  767. package/skills/gifgrep/SKILL.md +79 -0
  768. package/skills/github/SKILL.md +163 -0
  769. package/skills/gog/SKILL.md +116 -0
  770. package/skills/goplaces/SKILL.md +52 -0
  771. package/skills/healthcheck/SKILL.md +245 -0
  772. package/skills/himalaya/SKILL.md +257 -0
  773. package/skills/himalaya/references/configuration.md +184 -0
  774. package/skills/himalaya/references/message-composition.md +199 -0
  775. package/skills/imsg/SKILL.md +122 -0
  776. package/skills/mcporter/SKILL.md +61 -0
  777. package/skills/model-usage/SKILL.md +69 -0
  778. package/skills/model-usage/references/codexbar-cli.md +33 -0
  779. package/skills/model-usage/scripts/model_usage.py +320 -0
  780. package/skills/model-usage/scripts/test_model_usage.py +40 -0
  781. package/skills/nano-pdf/SKILL.md +38 -0
  782. package/skills/node-connect/SKILL.md +142 -0
  783. package/skills/notion/SKILL.md +174 -0
  784. package/skills/obsidian/SKILL.md +81 -0
  785. package/skills/openai-image-gen/SKILL.md +92 -0
  786. package/skills/openai-image-gen/scripts/gen.py +328 -0
  787. package/skills/openai-image-gen/scripts/test_gen.py +140 -0
  788. package/skills/openai-whisper/SKILL.md +38 -0
  789. package/skills/openai-whisper-api/SKILL.md +52 -0
  790. package/skills/openai-whisper-api/scripts/transcribe.sh +85 -0
  791. package/skills/openhue/SKILL.md +112 -0
  792. package/skills/oracle/SKILL.md +125 -0
  793. package/skills/ordercli/SKILL.md +78 -0
  794. package/skills/peekaboo/SKILL.md +190 -0
  795. package/skills/sag/SKILL.md +87 -0
  796. package/skills/session-logs/SKILL.md +115 -0
  797. package/skills/sherpa-onnx-tts/SKILL.md +103 -0
  798. package/skills/sherpa-onnx-tts/bin/sherpa-onnx-tts +178 -0
  799. package/skills/skill-creator/SKILL.md +372 -0
  800. package/skills/skill-creator/license.txt +202 -0
  801. package/skills/skill-creator/scripts/init_skill.py +378 -0
  802. package/skills/skill-creator/scripts/package_skill.py +139 -0
  803. package/skills/skill-creator/scripts/quick_validate.py +159 -0
  804. package/skills/skill-creator/scripts/test_package_skill.py +160 -0
  805. package/skills/skill-creator/scripts/test_quick_validate.py +72 -0
  806. package/skills/slack/SKILL.md +144 -0
  807. package/skills/songsee/SKILL.md +49 -0
  808. package/skills/sonoscli/SKILL.md +65 -0
  809. package/skills/spotify-player/SKILL.md +64 -0
  810. package/skills/summarize/SKILL.md +87 -0
  811. package/skills/things-mac/SKILL.md +86 -0
  812. package/skills/tmux/SKILL.md +153 -0
  813. package/skills/tmux/scripts/find-sessions.sh +112 -0
  814. package/skills/tmux/scripts/wait-for-text.sh +83 -0
  815. package/skills/trello/SKILL.md +95 -0
  816. package/skills/video-frames/SKILL.md +46 -0
  817. package/skills/video-frames/scripts/frame.sh +81 -0
  818. package/skills/voice-call/SKILL.md +45 -0
  819. package/skills/wacli/SKILL.md +72 -0
  820. package/skills/weather/SKILL.md +112 -0
  821. 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`。