oceanbase · knqiufan · Aug 21, 2026 · Aug 21, 2026 · Aug 24, 2026
diff --git a/docs/en/docs/how-to/install-and-run.md b/docs/en/docs/how-to/install-and-run.md
@@ -25,6 +25,20 @@ powercontext setup dsh --source oceanbase/powercontext --ref <ref>
 powercontext setup pi --source oceanbase/powercontext --ref <ref>
 ```
 
+Per-host commands remain the explicit path. The first-class catalog contains `codex`, `claude-code`, `dsh`,
+`openclaw`, `pi`, and `hermes`. To install more than one in one run, pass `--host` repeatedly, or omit `--host` on a
+TTY to choose from the catalog. `powercontext setup` with no subcommand still prints help:
+
+```bash
+powercontext setup select --host codex --host dsh --source oceanbase/powercontext --ref <ref>
+```
+
+Without `--server-url`, Claude Code keeps its `http://127.0.0.1:8000` default and OpenClaw keeps its
+`http://127.0.0.1:8765` default. An explicit `--server-url` overrides both selected hosts. OpenClaw's
+`--scope-mode` defaults to `agent`. Selected Codex, DSH, Pi, and Hermes integrations pass their existing post-install
+diagnostics before they are reported as installed. After installing Hermes, run `hermes memory setup` and select
+PowerContext before starting Hermes.
+
 For host-specific options, see [Configure Codex](configure-codex.md) and
 [Configure DeepSeek Harness](configure-dsh.md).
 

diff --git a/docs/en/docs/how-to/troubleshoot.md b/docs/en/docs/how-to/troubleshoot.md
@@ -33,7 +33,7 @@ git ls-remote https://github.com/oceanbase/powercontext.git HEAD
 If this fails, configure the credential helper or SSH key used by Git, then rerun `uv tool install`. `uv` uses Git's
 credential configuration; PowerContext does not accept or store repository credentials.
 
-## `powercontext`, `codex`, `claude`, `dsh`, or `pi` is not found
+## A PowerContext or host CLI is not found
 
 Run:
 
@@ -43,12 +43,16 @@ command -v powercontext
 command -v codex
 command -v claude
 command -v dsh
+command -v openclaw
 command -v pi
+command -v hermes
 ```
 
 Add the uv tool bin directory to `PATH` if needed. `powercontext setup codex`, `powercontext setup claude-code`,
-`powercontext setup dsh`, and `powercontext setup pi` report an error rather than attempting installation when the host
-CLI is unavailable.
+`powercontext setup dsh`, `powercontext setup openclaw`, `powercontext setup pi`, and `powercontext setup hermes` report
+an error rather than attempting installation when the host CLI is unavailable. `powercontext setup select` installs
+only the hosts you choose. A selected host that is missing still fails that row and does not block the other selected
+hosts. An unselected host is skipped even if its CLI is on `PATH`.
 
 ## The plugin is missing or stale
 

diff --git a/docs/en/docs/reference/interfaces.md b/docs/en/docs/reference/interfaces.md
@@ -81,12 +81,18 @@ boundary flushing fail open; explicit durable writes require interactive confirm
 
 ```text
 powercontext setup codex
+powercontext setup claude-code
 powercontext setup dsh
+powercontext setup openclaw
 powercontext setup pi
+powercontext setup hermes
+powercontext setup select
 powercontext doctor
 powercontext doctor codex
+powercontext doctor claude-code
 powercontext doctor dsh
 powercontext doctor pi
+powercontext doctor hermes
 powercontext server run
 powercontext ready
 powercontext capabilities

diff --git a/docs/zh/docs/how-to/install-and-run.md b/docs/zh/docs/how-to/install-and-run.md
@@ -24,6 +24,19 @@ powercontext setup dsh --source oceanbase/powercontext --ref <ref>
 powercontext setup pi --source oceanbase/powercontext --ref <ref>
 ```
 
+单宿主命令仍是显式路径。一级宿主目录包含 `codex`、`claude-code`、`dsh`、`openclaw`、`pi` 和 `hermes`。
+若要一次安装多个宿主，可重复传入 `--host`；在 TTY 上省略 `--host` 则从目录中选择。不带子命令的
+`powercontext setup` 仍然只打印帮助：
+
+```bash
+powercontext setup select --host codex --host dsh --source oceanbase/powercontext --ref <ref>
+```
+
+未传入 `--server-url` 时，Claude Code 保留 `http://127.0.0.1:8000` 默认值，OpenClaw 保留
+`http://127.0.0.1:8765` 默认值；显式传入该选项时会覆盖两个被选中宿主的地址。OpenClaw 的 `--scope-mode`
+默认值为 `agent`。Codex、DSH、Pi 和 Hermes 只有在通过现有安装后诊断后才会报告为 installed。安装 Hermes 后，
+还需运行 `hermes memory setup` 并选择 PowerContext，然后再启动 Hermes。
+
 宿主专有选项见[配置 Codex](configure-codex.md)和[配置 DeepSeek Harness](configure-dsh.md)。
 
 ## 运行本地 Server

diff --git a/docs/zh/docs/how-to/troubleshoot.md b/docs/zh/docs/how-to/troubleshoot.md
@@ -33,7 +33,7 @@ git ls-remote https://github.com/oceanbase/powercontext.git HEAD
 如果失败，请配置 Git 使用的 credential helper 或 SSH key，再重新运行 `uv tool install`。`uv` 使用 Git
 凭据配置；PowerContext 不接收或保存仓库凭据。
 
-## 找不到 `powercontext`、`codex`、`claude`、`dsh` 或 `pi`
+## 找不到 PowerContext 或宿主 CLI
 
 执行：
 
@@ -43,11 +43,15 @@ command -v powercontext
 command -v codex
 command -v claude
 command -v dsh
+command -v openclaw
 command -v pi
+command -v hermes
 ```
 
 必要时把 uv tool bin 目录加入 `PATH`。宿主 CLI 不可用时，`powercontext setup codex`、
-`powercontext setup claude-code`、`powercontext setup dsh` 和 `powercontext setup pi` 都会报告错误，而不会尝试安装。
+`powercontext setup claude-code`、`powercontext setup dsh`、`powercontext setup openclaw`、`powercontext setup pi`
+和 `powercontext setup hermes` 都会报告错误，而不会尝试安装。`powercontext setup select` 只安装你选中的宿主。
+某个选中宿主未安装时，该行失败，但不会阻塞其余选中项；未选中的宿主即使已在 `PATH` 上也不会安装。
 
 ## 插件缺失或版本不一致
 

diff --git a/docs/zh/docs/reference/interfaces.md b/docs/zh/docs/reference/interfaces.md
@@ -72,12 +72,18 @@ Pi transcript。召回、采集和边界 flush 都会正常降级；显式持久
 
 ```text
 powercontext setup codex
+powercontext setup claude-code
 powercontext setup dsh
+powercontext setup openclaw
 powercontext setup pi
+powercontext setup hermes
+powercontext setup select
 powercontext doctor
 powercontext doctor codex
+powercontext doctor claude-code
 powercontext doctor dsh
 powercontext doctor pi
+powercontext doctor hermes
 powercontext server run
 powercontext ready
 powercontext capabilities