docs(kiloclaw): update pricing FAQ and add recover-with-kilo guide

packages/kilo-docs/lib/nav/kiloclaw.ts

@@ -16,6 +16,7 @@ export const KiloClawNav: NavSection[] = [
           { href: "/kiloclaw/control-ui/changing-models", children: "Changing Models" },
           { href: "/kiloclaw/control-ui/exec-approvals", children: "Exec Approvals" },
           { href: "/kiloclaw/control-ui/version-pinning", children: "Version Pinning" },
+          { href: "/kiloclaw/control-ui/recover-with-kilo", children: "Recover with Kilo" },
         ],
       },
       {

packages/kilo-docs/pages/kiloclaw/control-ui/recover-with-kilo.md

@@ -0,0 +1,53 @@
+---
+title: "Recover with Kilo"
+description: "How to use Recover with Kilo to fix KiloClaw instances"
+---
+
+# Recover with Kilo
+
+## What is Recover with Kilo?
+
+Recover with Kilo is a self-repair capability built into KiloClaw. When your instance has configuration issues, broken integrations, or other operational problems, you can launch a Kilo CLI Run — an AI-powered repair agent that diagnoses and fixes the issue directly on your KiloClaw machine, without needing to contact support.
+
+Think of it as an automated sysadmin that runs inside your instance. You describe the problem in plain English, and the agent investigates, identifies the root cause, and applies fixes.
+
+## When to Use It
+
+Use Recover with Kilo when your KiloClaw instance is behaving unexpectedly, for example:
+
+- A channel (Slack, Discord, Telegram) stopped working
+- Gateway connections failing or timing out
+- Model provider errors or configuration issues
+- Missing or corrupted OpenClaw config
+- Environment variables not propagating correctly
+- Integration setup problems (GitHub, Linear, etc.)
+- The instance is running but something isn't working as expected
+
+
+## How to Use It
+
+1. Go to the [KiloClaw dashboard](https://app.kiloclaw.com)
+2. Click on the "Recover with Kilo" button in the top right corner
+3. Describe the problem you're experiencing in plain English
+4. Click "Run" to launch the repair agent
+5. Wait for the agent to complete its investigation and apply fixes
+6. Refresh your browser to see the changes
+
+## Limitations
+
+- Recover with Kilo can only fix issues that are within its scope of knowledge
+- It cannot access or modify files outside of the KiloClaw instance
+- Some complex issues may require manual intervention
+- The agent may not be able to fix issues that require human judgment
+
+## Troubleshooting
+
+If Recover with Kilo doesn't resolve your issue:
+
+1. Try describing the problem in more detail
+2. Check the logs for any error messages
+3. Contact support for manual assistance
+
+## Feedback
+
+We're constantly improving Recover with Kilo. If you have suggestions or encounter issues, please let us know through the in-app feedback system.

packages/kilo-docs/pages/kiloclaw/faq/pricing.md

@@ -9,10 +9,15 @@ KiloClaw uses Kilo Gateway credits by default — if you route requests through
 
 ## Instance Hosting
 
-KiloClaw hosting is **free during the beta period**. Each user gets a dedicated machine (2 shared vCPUs, 3 GB RAM, 10 GB SSD) at no cost.
+KiloClaw hosting uses a per-billing-period flat charge, not per-minute or per-action. A KiloClaw subscription is a recurring credit deduction tied to a specific instance. There is no metered hourly/per-minute hosting bill — the deduction happens once at the start of each billing period.
 
-> ℹ️ **Info**
-> Beta pricing is subject to change. Paid hosting tiers may be introduced after the beta period ends. Any changes will be announced in advance.
+Each instance is a dedicated machine (`performance-cpu-1x`, 3 GB RAM, 10 GB SSD).
+
+| Plan | Period | Cost per period |
+|---|---|---|
+| Standard | 1 month | $9.00 |
+| Commit | 6 months (paid upfront) | $48.00 |
+| Trial | 7 days | $0 |
 
 ## Model Inference
 
@@ -29,3 +34,26 @@ To see which models are currently free, check the [Kilo Leaderboard](https://kil
 You can add Gateway credits from your [Kilo account](https://app.kilo.ai). Credits are shared across all Kilo products (VSCode extension, CLI, Cloud Agents, and KiloClaw).
 
 See [Adding Credits](/docs/getting-started/adding-credits) and [Gateway Usage and Billing](/docs/gateway/usage-and-billing) for details.
+
+## Frequently Asked Questions
+
+**How am I billed for a KiloClaw instance?**
+A flat $9/month (Standard) or $48 prepaid for 6 months (Commit, ≈$8/mo). Hardware tier doesn't change the price. Inference (LLM token) usage is billed separately from your Kilo credit balance.
+
+**Do I pay per minute or only when active?**
+No. Hosting is a flat per-period charge. Stopping an instance does not pause hosting billing.
+
+**Is there a free trial?**
+Yes — 7 days, no credit card required, automatic on your first instance.
+
+**What if I run out of credits?**
+If auto top-up is on, we top up automatically. Otherwise, your subscription goes past-due. After 14 days past-due, your instance is stopped and you have 7 more days to pay before the instance is destroyed. Paying any time before destruction auto-restarts the instance.
+
+**Will my data be lost?**
+Only after instance destruction (14 + 7 = up to 21 days after the failed renewal). Records of the instance and subscription are retained for audit, but the underlying compute and volume are torn down.
+
+**Can I see my usage?**
+Yes — your Kilo credit ledger shows each KiloClaw hosting deduction as a separate `kiloclaw-subscription:...` entry. You'll also receive emails at every milestone (renewal failed, suspension, destruction warning, destroyed).
+
+**Are there caps?**
+One active instance per personal context and per organization.