Skip to content

The docs only knew about one of our two editions - #300

Merged
KrasimirKralev merged 4 commits into
mainfrom
docs/hermes-agent-support
Aug 8, 2026
Merged

KrasimirKralev merged 4 commits into
mainfrom
docs/hermes-agent-support

Conversation

@yalexx

@yalexx yalexx commented Aug 8, 2026

Copy link
Copy Markdown
Collaborator

ClawBox Hermes Edition went on sale 3 August and took its first order last night. 22 of the 23 published doc pages describe ClawBox as an OpenClaw device, and none mentioned Hermes Agent at all.

What changed

Four pages — the ones where a buyer forms their idea of the product:

Page Change
index.mdx Summary and hero now cover both editions; new "Two editions, same hardware" table
quickstart.mdx Note that the steps are identical and the box arrives running the agent you chose
hardware/clawbox-connect.mdx Second buy card for Hermes Edition; every spec on the page applies to both
support/faq.mdx Two new questions at the top: which agent, and whether Hermes Edition needs a subscription

What I deliberately did not write

Any suggestion that you can switch agents on the device. The original request was to say customers can switch between Hermes and OpenClaw with one click. That is not true of the product today, and I verified it three ways:

  1. public/hermes.md — our own live product page — states "the choice is made at checkout, not after delivery" and "An order is one edition or the other."
  2. The device repo contains zero references to Hermes outside two lockfiles. There is no switching mechanism in the shipped software.
  3. connect and hermes are separate Stripe SKUs; metadata.sku drives fulfilment, invoicing, customs and GA4.

The docs now say what is true: two editions, chosen when you order.

Trademark

Every mention is "Hermes Agent" or "ClawBox Hermes Edition" — never a bare standalone "Hermes", never "Hermes Box". src/config/products.ts in the website repo carries an explicit warning that Hermès International is a litigious trademark holder.

Left alone

technical/agent-interface, technical/networking, technical/filesystem — these describe OpenClaw internals that are still accurate for the Connect edition. Making them edition-neutral needs someone who knows how the Hermes image differs, which I could not determine from the repo.

Verification

  • docs.json parses; nav untouched, no new pages added
  • Frontmatter intact and JSX components balanced on all four files
  • No build step run locally: docs deploy via .github/workflows/docs-deploy.yml on merge

🤖 Generated with Claude Code

Summary by CodeRabbit

  • New Features

    • Added the €549 Hermes Edition, featuring the same hardware and specifications as ClawBox Connect with Hermes Agent preinstalled.
    • Customers can choose between OpenClaw and Hermes Agent editions at checkout and switch agents on-device without reflashing.
    • Clarified edition-specific subscriptions and fulfilment arrangements.
  • Documentation

    • Updated the homepage, quickstart guide, and FAQs with pricing, preconfigured setup, agent selection, and subscription details.

22 of the 23 published pages describe ClawBox as an OpenClaw device. None
mentioned Hermes Agent at all, even though ClawBox Hermes Edition has been
on sale since 3 August and has now taken its first order.

Added to the four pages where a buyer actually forms their idea of the
product: the landing page, the quickstart, the Connect hardware page and
the FAQ. Left the technical internals alone -- agent-interface, networking
and filesystem describe OpenClaw specifics that are still accurate.

Deliberately NOT written: any suggestion that you can switch agents on the
device. There is no such feature. The device repo contains zero references
to Hermes, connect and hermes are separate Stripe SKUs, and our own product
page states in writing that "the choice is made at checkout, not after
delivery". The docs now say the same thing: two editions, chosen when you
order.

Every mention is "Hermes Agent" or "ClawBox Hermes Edition", never a bare
standalone "Hermes". Hermès International is a litigious trademark holder
and products.ts carries an explicit warning about it.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@yalexx
yalexx requested a review from a team as a code owner August 8, 2026 04:23
@coderabbitai

coderabbitai Bot commented Aug 8, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro

Run ID: fd263efd-630b-4033-901a-55c8bc77a299

📥 Commits

Reviewing files that changed from the base of the PR and between 543ff08 and dd1db62.

📒 Files selected for processing (3)
  • docs-site/hardware/clawbox-connect.mdx
  • docs-site/index.mdx
  • docs-site/support/faq.mdx

📝 Walkthrough

Walkthrough

The documentation presents ClawBox Connect and ClawBox Hermes Edition as same-hardware products with different preinstalled agents. It documents checkout selection, setup behavior, pricing, fulfilment identities, and subscription requirements.

Changes

ClawBox edition documentation

Layer / File(s) Summary
Product editions and checkout selection
docs-site/index.mdx, docs-site/hardware/clawbox-connect.mdx
The homepage and hardware page describe Hermes Edition, its Hermes Agent software, shared hardware, €549 price, and checkout selection.
Setup and subscription guidance
docs-site/quickstart.mdx, docs-site/support/faq.mdx
The documentation states that both editions arrive preconfigured. The FAQ explains edition switching and subscription requirements.

Estimated code review effort: 2 (Simple) | ~10 minutes

Suggested reviewers: georgik77, krasimirkralev

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Description check ⚠️ Warning The description explains the documentation changes and verification, but it contradicts the stated one-click switching objective and omits the required change type and checklist sections. Update the description to reflect one-click switching and complete the required Type of change and Checklist sections.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly summarizes that the documentation was updated to cover the second ClawBox edition.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/hermes-agent-support

Comment @coderabbitai help to get the list of available commands.

@github-actions

github-actions Bot commented Aug 8, 2026

Copy link
Copy Markdown

🦀 ClawReview

Scuttled over to say hello and get you oriented 🦀

This PR updates four documentation pages to acknowledge that ClawBox ships in two editions — ClawBox (Connect) running OpenClaw, and ClawBox Hermes Edition running Hermes Agent by Nous Research — following the Hermes Edition going on sale 3 August. Changes add an edition-comparison table to the index, a note in the quickstart, a second buy card on the hardware page, and two new FAQ entries covering agent choice and subscription requirements.

At a glance

  • 📖 Docs · touches docs-site (index, quickstart, hardware/clawbox-connect, support/faq)
  • Base branch: main · +40 source / +0 tests across 4 files
  • ✅ base main matches the beta-first convention (docs/meta-only change)
  • 🟡 title doesn't follow type: description (feat/fix/chore/docs/…)

Good to know

  • 🟡 The diff adds single-click agent-switching language in both index.mdx and faq.mdx, while the PR description explicitly states this was intentionally omitted because the feature doesn't exist in the shipped software. The two contradict each other.
  • ℹ️ No local build was run; the docs deploy via .github/workflows/docs-deploy.yml on merge — CI will be the first real validation.
  • ℹ️ Technical docs pages (agent-interface, networking, filesystem) remain OpenClaw-specific and are out of scope for this PR; the author flagged them as needing someone with Hermes image knowledge.

— ClawReview 🦀, your resident reef crab. Just orientation — CodeRabbit does the line-by-line, humans do the merge. Conventions: docs.

@github-actions github-actions Bot added the area: docs Auto-triage area label Aug 8, 2026
@github-actions

github-actions Bot commented Aug 8, 2026

Copy link
Copy Markdown

CI Summary

✅ Tests

  • Result: passed
  • View run
  • Coverage: statements 70.34%, branches 60.26%, functions 65.71%, lines 72.32%

✅ E2E

✅ E2E Install

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs-site/hardware/clawbox-connect.mdx`:
- Around line 13-15: Update the OS specification row in the hardware
specifications section to accurately cover both editions, replacing the
OpenClaw-only wording with wording that names the selected pre-installed agent
for each edition or otherwise distinguishes the Hermes and OpenClaw variants.
Keep the surrounding shared specifications unchanged.

In `@docs-site/index.mdx`:
- Line 40: In the sentence beginning “The agent is chosen,” replace “afterwards”
with the American English spelling “afterward,” leaving the rest of the sentence
unchanged.
🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro

Run ID: 9064738f-d62a-4d8c-b589-674651eca770

📥 Commits

Reviewing files that changed from the base of the PR and between 8cb6a43 and 543ff08.

📒 Files selected for processing (4)
  • docs-site/hardware/clawbox-connect.mdx
  • docs-site/index.mdx
  • docs-site/quickstart.mdx
  • docs-site/support/faq.mdx

Comment thread docs-site/hardware/clawbox-connect.mdx
Comment thread docs-site/index.mdx Outdated
yalexx and others added 3 commits August 8, 2026 07:48
The first version of these pages said the agent choice was made "at
checkout, not after delivery" and that wanting the other one later meant
buying a second box. I wrote that because the device repo contains no
Hermes code and our product page said the same thing, so I had no way to
support a switching claim.

Yanko has since confirmed the device gained a one-click switch between
OpenClaw and Hermes Agent. Correcting the two places that now read as
wrong, so the docs match the homepage rather than contradicting it.

Stating plainly what this rests on: the confirmation, not code I read.
… 'afterward'

- clawbox-connect.mdx: the shared OS spec said 'OpenClaw pre-installed', which
  is wrong for Hermes Edition buyers — make it 'selected agent pre-installed'.
- index.mdx: 'afterwards' -> 'afterward' (US English).
@KrasimirKralev
KrasimirKralev merged commit e34bed6 into main Aug 8, 2026
9 checks passed
@KrasimirKralev
KrasimirKralev deleted the docs/hermes-agent-support branch August 8, 2026 17:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: docs Auto-triage area

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants