Gateway 导读
门口的小门卫 runbook:总控室这一层在盯什么
门口的小门卫 runbook 属于网关总控室里的一角。先看它卡在哪个位置、会拨动哪些客户端和工具、旋钮一拧会影响哪片区域,然后再看命令细节。原文最响的一记鼓点,其实是:Use this page for day-1 startup and day-2 operations of the 门口的小门卫 service.。
先听这页的人话版
Gateway runbook
这一页不是在堆术语,它像把“门口的小门卫 runbook”这台小机器搬到桌上,当着你的面拆开给你看。你先不用全记住,先抓住它到底在忙什么:Use this page for day-1 startup and day-2 operations of the 门口的小门卫 service.
如果把这页当成“给普通人看的版本”,你最应该带走的是:它到底在教你一件什么事、什么时候要这样做、以及哪里最容易踩坑。
第 1 站
Start Here
这一节更像安装或配置步骤,重点不是概念,而是“按什么顺序做才不会卡住”。
这一节更像安装或配置步骤,重点不是概念,而是“按什么顺序做才不会卡住”。
很多文档看起来长,其实是在防你漏掉前置条件。
真正照做时,先找前置条件,再找必填项,最后看验证方法。
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Use this page for day-1 startup and day-2 operations of the 门口的小门卫 service. Card大家一起的房间 Deep troubleshooting Symptom-fi…。
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Use this page for day-1 startup and day-2 operations of the 门口的小门卫 service.
Use this page for day-1 startup and day-2 operations of the Gateway service.
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Card大家一起的房间。
CardGroup
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Deep troubleshooting。
Deep troubleshooting
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Symptom-first diagnostics with exact 魔法口令 ladders and log signatures.
Symptom-first diagnostics with exact command ladders and log signatures.
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:设置说明书uration。
Configuration
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Task-oriented setup guide + full 设置说明书uration reference.
Task-oriented setup guide + full configuration reference.
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Secrets management。
Secrets management
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:SecretRef contract, runtime snapshot behavior, and migrate/reload operations.
SecretRef contract, runtime snapshot behavior, and migrate/reload operations.
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Secrets plan contract。
Secrets plan contract
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Exact secrets apply target/path rules and ref-only auth-profile behavior.
Exact secrets apply target/path rules and ref-only auth-profile behavior.
第 2 站
5-minute local startup
这一节在讲规则和边界:什么默认允许、什么必须显式打开、什么被禁止。
这一节在讲规则和边界:什么默认允许、什么必须显式打开、什么被禁止。
这种内容决定了 OpenClaw 是“能做”还是“现在还不能做”,读懂它比记术语更重要。
你可以把这一节当成权限说明书,真正配置时优先盯住 default、required、allow、deny 这几个词。
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Steps Start the 门口的小门卫 Verify service health Healthy baseline: Runtime: running, Connectivity probe: ok, and Capability…。
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Steps。
Steps
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Start the 门口的小门卫。
Start the Gateway
这是一句直接对 OpenClaw 说的话,像你把任务清清楚楚塞到它手里。
- 这一句是在直接叫 OpenClaw 动起来:“openclaw gateway --port 18789”。你可以把它想成一句说出口就要执行的差事。
- 这一行“# debug/trace mirrored to stdio”是在给电脑递一张小纸条,告诉它眼下该做哪一步。
- 这一句是在直接叫 OpenClaw 动起来:“openclaw gateway --port 18789 --verbose”。你可以把它想成一句说出口就要执行的差事。
openclaw gateway --port 18789
# debug/trace mirrored to stdio
openclaw gateway --port 18789 --verbose
# force-kill listener on selected port, then start
openclaw gateway --force
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Verify service health。
Verify service health
这是一句直接对 OpenClaw 说的话,像你把任务清清楚楚塞到它手里。
- 这一句是在直接叫 OpenClaw 动起来:“openclaw gateway status”。你可以把它想成一句说出口就要执行的差事。
- 这一句是在直接叫 OpenClaw 动起来:“openclaw status”。你可以把它想成一句说出口就要执行的差事。
- 这一句是在直接叫 OpenClaw 动起来:“openclaw logs --follow”。你可以把它想成一句说出口就要执行的差事。
openclaw gateway status
openclaw status
openclaw logs --follow
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Healthy baseline: Runtime: running, Connectivity probe: ok, and Capability: ... that matches what you expect. Use openc…。
Healthy baseline: Runtime: running, Connectivity probe: ok, and Capability: ... that matches what you expect. Use openclaw gateway status --require-rpc when you need read-scope RPC proof, not just reachability.
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Validate 消息通道 readiness。
Validate channel readiness
这是一句直接对 OpenClaw 说的话,像你把任务清清楚楚塞到它手里。
- 这一句是在直接叫 OpenClaw 动起来:“openclaw channels status --probe”。你可以把它想成一句说出口就要执行的差事。
openclaw channels status --probe
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:With a reachable 门口的小门卫 this runs live per-account 消息通道 probes and optional audits. If the 门口的小门卫 is unreachable, the C…。
With a reachable gateway this runs live per-account channel probes and optional audits. If the gateway is unreachable, the CLI falls back to config-only channel summaries instead of live probe output.
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Note。
Note
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:门口的小门卫 设置说明书 reload watches the active 设置说明书 file path (resolved from profile/state defaults, or OPENCLAW_设置说明书_PATH wh…。
Gateway config reload watches the active config file path (resolved from profile/state defaults, or OPENCLAW_CONFIG_PATH when set). Default mode is gateway.reload.mode="hybrid". After the first successful load, the running process serves the active in-memory config snapshot; successful reload swaps that snapshot atomically.
第 3 站
Runtime 聪明脑袋模型
这一节在讲规则和边界:什么默认允许、什么必须显式打开、什么被禁止。
这一节在讲规则和边界:什么默认允许、什么必须显式打开、什么被禁止。
这种内容决定了 OpenClaw 是“能做”还是“现在还不能做”,读懂它比记术语更重要。
你可以把这一节当成权限说明书,真正配置时优先盯住 default、required、allow、deny 这几个词。
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:门口的小门卫.auth.token / 门口的小门卫.auth.秘密口令 (or OPENCLAW_门口的小门卫_TOKEN / OPENCLAW_门口的小门卫_秘密口令), and non-loopback reverse-proxy…。
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:门口的小门卫.auth.token / 门口的小门卫.auth.秘密口令 (or OPENCLAW_门口的小门卫_TOKEN / OPENCLAW_门口的小门卫_秘密口令), and non-loopback reverse-proxy…。
gateway.auth.token / gateway.auth.password (or OPENCLAW_GATEWAY_TOKEN / OPENCLAW_GATEWAY_PASSWORD), and non-loopback reverse-proxy setups can use gateway.auth.mode: "trusted-proxy".
这一串条目别硬背,把它当成“Runtime model”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错:One always-on process for routing, contro…、Single multiplexed port for:、WebSocket control/RPC、HTTP 对话接口s (/v1/聪明脑袋模型s, /v1/embeddings,…。
- One always-on process for routing, control plane, and channel connections.
- Single multiplexed port for:
- WebSocket control/RPC
- HTTP APIs (
/v1/models,/v1/embeddings,/v1/chat/completions,/v1/responses,/tools/invoke) - Plugin HTTP routes, such as optional
/api/v1/admin/rpc - Control UI and hooks
- Default bind mode:
loopback. - Auth is required by default. Shared-secret setups use
第 4 站
OpenAI-compatible endpoints
这一节在讲规则和边界:什么默认允许、什么必须显式打开、什么被禁止。
这一节在讲规则和边界:什么默认允许、什么必须显式打开、什么被禁止。
这种内容决定了 OpenClaw 是“能做”还是“现在还不能做”,读懂它比记术语更重要。
你可以把这一节当成权限说明书,真正配置时优先盯住 default、required、allow、deny 这几个词。
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:OpenClaw's highest-leverage compatibility surface is now: Why this set matters: Planning note: All of these run on the…。
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:OpenClaw's highest-leverage compatibility surface is now:。
OpenClaw's highest-leverage compatibility surface is now:
这一串条目别硬背,把它当成“OpenAI-compatible endpoints”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错:GET /v1/聪明脑袋模型s、GET /v1/聪明脑袋模型s/{id}、POST /v1/embeddings、POST /v1/chat/completions。
GET /v1/modelsGET /v1/models/{id}POST /v1/embeddingsPOST /v1/chat/completionsPOST /v1/responses
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Why this set matters:。
Why this set matters:
这一串条目别硬背,把它当成“OpenAI-compatible endpoints”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错:Most Open WebUI, LobeChat, and LibreChat…、Many RAG and memory pipelines expect /v1/…、机器人朋友-native 来帮忙的小伙伴s increasingly prefer…。
- Most Open WebUI, LobeChat, and LibreChat integrations probe
/v1/modelsfirst. - Many RAG and memory pipelines expect
/v1/embeddings. - Agent-native clients increasingly prefer
/v1/responses.
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Planning note:。
Planning note:
这一串条目别硬背,把它当成“OpenAI-compatible endpoints”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错:/v1/聪明脑袋模型s is 机器人朋友-first: it returns op…、openclaw/default is the stable alias that…、Use x-openclaw-聪明脑袋模型 when you want a bac…。
/v1/modelsis agent-first: it returnsopenclaw,openclaw/default, andopenclaw/<agentId>.openclaw/defaultis the stable alias that always maps to the configured default agent.- Use
x-openclaw-modelwhen you want a backend provider/model override; otherwise the selected agent's normal model and embedding setup stays in control.
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:All of these run on the main 门口的小门卫 port and use the same trusted operator auth boundary as the rest of the 门口的小门卫 HTTP…。
All of these run on the main Gateway port and use the same trusted operator auth boundary as the rest of the Gateway HTTP API.
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Admin HTTP RPC (POST /对话接口/v1/admin/rpc) is a separate, default-off 新本领插件 route for host 工具小帮手ing that cannot use WebSo…。
Admin HTTP RPC (POST /api/v1/admin/rpc) is a separate, default-off plugin route for host tooling that cannot use WebSocket RPC. See Admin HTTP RPC.
第 5 站
Port and bind precedence
这一节在讲规则和边界:什么默认允许、什么必须显式打开、什么被禁止。
这一节在讲规则和边界:什么默认允许、什么必须显式打开、什么被禁止。
这种内容决定了 OpenClaw 是“能做”还是“现在还不能做”,读懂它比记术语更重要。
你可以把这一节当成权限说明书,真正配置时优先盯住 default、required、allow、deny 这几个词。
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Installed 门口的小门卫 services record the resolved --port in supervisor metadata. After changing 门口的小门卫.port, run openclaw d…。
这段是在把几种选项排成表格,左边像标签,右边像说明。手机上可以横向滑动原文表格。
| Setting | Resolution order |
|---|---|
| Gateway port | --port → OPENCLAW_GATEWAY_PORT → gateway.port → 18789 |
| Bind mode | CLI/override → gateway.bind → loopback |
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Installed 门口的小门卫 services record the resolved --port in supervisor metadata. After changing 门口的小门卫.port, run openclaw d…。
Installed gateway services record the resolved --port in supervisor metadata. After changing gateway.port, run openclaw doctor --fix or openclaw gateway install --force so launchd/systemd/schtasks starts the process on the new port.
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:门口的小门卫 startup uses the same effective port and bind when it seeds local Control UI origins for non-loopback binds. For…。
Gateway startup uses the same effective port and bind when it seeds local Control UI origins for non-loopback binds. For example, --bind lan --port 3000 seeds http://localhost:3000 and http://127.0.0.1:3000 before runtime validation runs. Add any remote browser origins, such as HTTPS proxy URLs, to gateway.controlUi.allowedOrigins explicitly.
第 6 站
Hot reload modes
这一节主要在解释“Hot reload modes”到底是干什么的,以及你什么时候会遇到它。
这一节主要在解释“Hot reload modes”到底是干什么的,以及你什么时候会遇到它。
如果你是第一次接触 OpenClaw,这一节最值得看的不是术语本身,而是它背后的使用场景和限制。
真正动手时,先看它有没有默认值、有没有必须打开的选项、以及会不会影响安全边界。
这一小段像旁白,在提醒我们镜头已经切到下一站。
这段是在把几种选项排成表格,左边像标签,右边像说明。手机上可以横向滑动原文表格。
gateway.reload.mode | Behavior |
|---|---|
off | No config reload |
hot | Apply only hot-safe changes |
restart | Restart on reload-required changes |
hybrid (default) | Hot-apply when safe, restart when required |
第 7 站
Operator 魔法口令 set
这一节主要在解释“Operator 魔法口令 set”到底是干什么的,以及你什么时候会遇到它。
这一节主要在解释“Operator 魔法口令 set”到底是干什么的,以及你什么时候会遇到它。
如果你是第一次接触 OpenClaw,这一节最值得看的不是术语本身,而是它背后的使用场景和限制。
真正动手时,先看它有没有默认值、有没有必须打开的选项、以及会不会影响安全边界。
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:门口的小门卫 status --deep is for extra service discovery (LaunchDaemons/systemd system units/schtasks), not a deeper RPC hea…。
这是一句直接对 OpenClaw 说的话,像你把任务清清楚楚塞到它手里。
- 这一句是在直接叫 OpenClaw 动起来:“openclaw gateway status”。你可以把它想成一句说出口就要执行的差事。
- 这一句是在直接叫 OpenClaw 动起来:“openclaw gateway status --deep # adds a system-level service scan”。你可以把它想成一句说出口就要执行的差事。
- 这一句是在直接叫 OpenClaw 动起来:“openclaw gateway status --json”。你可以把它想成一句说出口就要执行的差事。
openclaw gateway status
openclaw gateway status --deep # adds a system-level service scan
openclaw gateway status --json
openclaw gateway install
openclaw gateway restart
openclaw gateway stop
openclaw secrets reload
openclaw logs --follow
openclaw doctor
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:门口的小门卫 status --deep is for extra service discovery (LaunchDaemons/systemd system units/schtasks), not a deeper RPC hea…。
gateway status --deep is for extra service discovery (LaunchDaemons/systemd system units/schtasks), not a deeper RPC health probe.
第 8 站
Multiple 门口的小门卫s (same host)
这一节在讲规则和边界:什么默认允许、什么必须显式打开、什么被禁止。
这一节在讲规则和边界:什么默认允许、什么必须显式打开、什么被禁止。
这种内容决定了 OpenClaw 是“能做”还是“现在还不能做”,读懂它比记术语更重要。
你可以把这一节当成权限说明书,真正配置时优先盯住 default、required、allow、deny 这几个词。
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Most installs should run one 门口的小门卫 per machine. A single 门口的小门卫 can host multiple 机器人朋友s and 消息通道s. You only need mult…。
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Most installs should run one 门口的小门卫 per machine. A single 门口的小门卫 can host multiple 机器人朋友s and 消息通道s.
Most installs should run one gateway per machine. A single gateway can host multiple agents and channels.
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:You only need multiple 门口的小门卫s when you intentionally want isolation or a rescue bot.
You only need multiple gateways when you intentionally want isolation or a rescue bot.
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Useful checks:。
Useful checks:
这是一句直接对 OpenClaw 说的话,像你把任务清清楚楚塞到它手里。
- 这一句是在直接叫 OpenClaw 动起来:“openclaw gateway status --deep”。你可以把它想成一句说出口就要执行的差事。
- 这一句是在直接叫 OpenClaw 动起来:“openclaw gateway probe”。你可以把它想成一句说出口就要执行的差事。
openclaw gateway status --deep
openclaw gateway probe
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:What to expect:。
What to expect:
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:and print cleanup hints when stale launchd/systemd/schtasks installs are still around.
and print cleanup hints when stale launchd/systemd/schtasks installs are still around.
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:answers.
answers.
这一串条目别硬背,把它当成“Multiple gateways (same host)”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错:门口的小门卫 status --deep can report Other 门口的…、门口的小门卫 probe can warn about multiple reac…、If that is intentional, isolate ports, 设置…。
gateway status --deepcan reportOther gateway-like services detected (best effort)gateway probecan warn aboutmultiple reachable gatewayswhen more than one target- If that is intentional, isolate ports, config/state, and workspace roots per gateway.
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Checklist per instance:。
Checklist per instance:
这一串条目别硬背,把它当成“Multiple gateways (same host)”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错:Unique 门口的小门卫.port、Unique OPENCLAW_设置说明书_PATH、Unique OPENCLAW_STATE_DIR、Unique 机器人朋友s.defaults.workspace。
- Unique
gateway.port - Unique
OPENCLAW_CONFIG_PATH - Unique
OPENCLAW_STATE_DIR - Unique
agents.defaults.workspace
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Example:。
Example:
这是一串终端口令,像你站在控制台前,一下下按按钮让机器醒过来。
- 这一行“OPENCLAW_CONFIG_PATH=~/.openclaw/a.json OPENCLAW_STATE_DIR=~/.openclaw-a openclaw gateway --port 19001”是在给电脑递一张小纸条,告诉它眼下该做哪一步。
- 这一行“OPENCLAW_CONFIG_PATH=~/.openclaw/b.json OPENCLAW_STATE_DIR=~/.openclaw-b openclaw gateway --port 19002”是在给电脑递一张小纸条,告诉它眼下该做哪一步。
OPENCLAW_CONFIG_PATH=~/.openclaw/a.json OPENCLAW_STATE_DIR=~/.openclaw-a openclaw gateway --port 19001
OPENCLAW_CONFIG_PATH=~/.openclaw/b.json OPENCLAW_STATE_DIR=~/.openclaw-b openclaw gateway --port 19002
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Detailed setup: /门口的小门卫/multiple-门口的小门卫s.
Detailed setup: /gateway/multiple-gateways.
第 9 站
Remote access
这一节在讲规则和边界:什么默认允许、什么必须显式打开、什么被禁止。
这一节在讲规则和边界:什么默认允许、什么必须显式打开、什么被禁止。
这种内容决定了 OpenClaw 是“能做”还是“现在还不能做”,读懂它比记术语更重要。
你可以把这一节当成权限说明书,真正配置时优先盯住 default、required、allow、deny 这几个词。
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Preferred: Tailscale/VPN. Fallback: SSH tunnel. Then connect 来帮忙的小伙伴s locally to ws://127.0.0.1:18789. Warning SSH tunn…。
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Preferred: Tailscale/VPN. Fallback: SSH tunnel.
Preferred: Tailscale/VPN. Fallback: SSH tunnel.
这是一串终端口令,像你站在控制台前,一下下按按钮让机器醒过来。
- 这里在给“ssh -N -L 18789”挂牌子,告诉系统它该指向“127.0.0.1:18789 user@host”。
ssh -N -L 18789:127.0.0.1:18789 user@host
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Then connect 来帮忙的小伙伴s locally to ws://127.0.0.1:18789.
Then connect clients locally to ws://127.0.0.1:18789.
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Warning。
Warning
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:SSH tunnels do not bypass 门口的小门卫 auth. For shared-secret auth, 来帮忙的小伙伴s still must send token/秘密口令 even over the tunnel…。
SSH tunnels do not bypass gateway auth. For shared-secret auth, clients still must send token/password even over the tunnel. For identity-bearing modes, the request still has to satisfy that auth path.
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:See: Remote 门口的小门卫, Authentication, Tailscale.
See: Remote Gateway, Authentication, Tailscale.
第 10 站
Supervision and service lifecycle
这一节在讲规则和边界:什么默认允许、什么必须显式打开、什么被禁止。
这一节在讲规则和边界:什么默认允许、什么必须显式打开、什么被禁止。
这种内容决定了 OpenClaw 是“能做”还是“现在还不能做”,读懂它比记术语更重要。
你可以把这一节当成权限说明书,真正配置时优先盯住 default、required、allow、deny 这几个词。
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Use supervised runs for production-like reliability. Tabs macOS (launchd) Use openclaw 门口的小门卫 restart for restarts. Do…。
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Use supervised runs for production-like reliability.
Use supervised runs for production-like reliability.
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Tabs。
Tabs
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:macOS (launchd)。
macOS (launchd)
这是一句直接对 OpenClaw 说的话,像你把任务清清楚楚塞到它手里。
- 这一句是在直接叫 OpenClaw 动起来:“openclaw gateway install”。你可以把它想成一句说出口就要执行的差事。
- 这一句是在直接叫 OpenClaw 动起来:“openclaw gateway status”。你可以把它想成一句说出口就要执行的差事。
- 这一句是在直接叫 OpenClaw 动起来:“openclaw gateway restart”。你可以把它想成一句说出口就要执行的差事。
openclaw gateway install
openclaw gateway status
openclaw gateway restart
openclaw gateway stop
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Use openclaw 门口的小门卫 restart for restarts. Do not chain openclaw 门口的小门卫 stop and openclaw 门口的小门卫 start as a restart subs…。
Use openclaw gateway restart for restarts. Do not chain openclaw gateway stop and openclaw gateway start as a restart substitute.
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:On macOS, 门口的小门卫 stop uses launchctl bootout by default — this removes the Launch机器人朋友 from the current boot session wi…。
On macOS, gateway stop uses launchctl bootout by default — this removes the LaunchAgent from the current boot session without persisting a disable, so KeepAlive auto-recovery still works after unexpected crashes and gateway start re-enables cleanly. To persistently suppress auto-respawn across reboots, pass --disable: openclaw gateway stop --disable.
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Launch机器人朋友 labels are ai.openclaw.门口的小门卫 (default) or ai.openclaw.<profile> (named profile). openclaw doctor audits an…。
LaunchAgent labels are ai.openclaw.gateway (default) or ai.openclaw.<profile> (named profile). openclaw doctor audits and repairs service config drift.
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Linux (systemd user)。
Linux (systemd user)
这是一句直接对 OpenClaw 说的话,像你把任务清清楚楚塞到它手里。
- 这一句是在直接叫 OpenClaw 动起来:“openclaw gateway install”。你可以把它想成一句说出口就要执行的差事。
- 这一行“systemctl --user enable --now openclaw-gateway[-<profile>].service”是在给电脑递一张小纸条,告诉它眼下该做哪一步。
- 这一句是在直接叫 OpenClaw 动起来:“openclaw gateway status”。你可以把它想成一句说出口就要执行的差事。
openclaw gateway install
systemctl --user enable --now openclaw-gateway[-<profile>].service
openclaw gateway status
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:For persistence after logout, enable lingering:。
For persistence after logout, enable lingering:
这是一串终端口令,像你站在控制台前,一下下按按钮让机器醒过来。
- 这一行“sudo loginctl enable-linger <user>”是在给电脑递一张小纸条,告诉它眼下该做哪一步。
sudo loginctl enable-linger <user>
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Manual user-unit example when you need a custom install path:。
Manual user-unit example when you need a custom install path:
这段像放在桌上的操作卡,谁来照着做,现场就会动起来。
- 这一行“[Unit]”是在给电脑递一张小纸条,告诉它眼下该做哪一步。
- 这一行“Description=OpenClaw Gateway”是在给电脑递一张小纸条,告诉它眼下该做哪一步。
- 这一行“After=network-online.target”是在给电脑递一张小纸条,告诉它眼下该做哪一步。
[Unit]
Description=OpenClaw Gateway
After=network-online.target
Wants=network-online.target
[Service]
ExecStart=/usr/local/bin/openclaw gateway --port 18789
Restart=always
RestartSec=5
TimeoutStopSec=30
TimeoutStartSec=30
SuccessExitStatus=0 143
KillMode=control-group
[Install]
WantedBy=default.target
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Windows (native)。
Windows (native)
这是一句直接对 OpenClaw 说的话,像你把任务清清楚楚塞到它手里。
- 这一句是在直接叫 OpenClaw 动起来:“openclaw gateway install”。你可以把它想成一句说出口就要执行的差事。
- 这一句是在直接叫 OpenClaw 动起来:“openclaw gateway status --json”。你可以把它想成一句说出口就要执行的差事。
- 这一句是在直接叫 OpenClaw 动起来:“openclaw gateway restart”。你可以把它想成一句说出口就要执行的差事。
openclaw gateway install
openclaw gateway status --json
openclaw gateway restart
openclaw gateway stop
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Native Windows managed startup uses a Scheduled Task named OpenClaw 门口的小门卫 (or OpenClaw 门口的小门卫 (<profile>) for named pr…。
Native Windows managed startup uses a Scheduled Task named OpenClaw Gateway (or OpenClaw Gateway (<profile>) for named profiles). If Scheduled Task creation is denied, OpenClaw falls back to a per-user Startup-folder launcher that points at gateway.cmd inside the state directory.
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Linux (system service)。
Linux (system service)
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Use a system unit for multi-user/always-on hosts.
Use a system unit for multi-user/always-on hosts.
这是一串终端口令,像你站在控制台前,一下下按按钮让机器醒过来。
- 这一行“sudo systemctl daemon-reload”是在给电脑递一张小纸条,告诉它眼下该做哪一步。
- 这一行“sudo systemctl enable --now openclaw-gateway[-<profile>].service”是在给电脑递一张小纸条,告诉它眼下该做哪一步。
sudo systemctl daemon-reload
sudo systemctl enable --now openclaw-gateway[-<profile>].service
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Use the same service body as the user unit, but install it under /etc/systemd/system/openclaw-门口的小门卫[-<profile>].servic…。
Use the same service body as the user unit, but install it under /etc/systemd/system/openclaw-gateway[-<profile>].service and adjust ExecStart= if your openclaw binary lives elsewhere.
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Do not also let openclaw doctor --fix install a user-level 门口的小门卫 service for the same profile/port. Doctor refuses tha…。
Do not also let openclaw doctor --fix install a user-level gateway service for the same profile/port. Doctor refuses that automatic install when it finds a system-level OpenClaw gateway service; use OPENCLAW_SERVICE_REPAIR_POLICY=external when the system unit owns the lifecycle.
第 11 站
Dev profile quick path
这一节在讲规则和边界:什么默认允许、什么必须显式打开、什么被禁止。
这一节在讲规则和边界:什么默认允许、什么必须显式打开、什么被禁止。
这种内容决定了 OpenClaw 是“能做”还是“现在还不能做”,读懂它比记术语更重要。
你可以把这一节当成权限说明书,真正配置时优先盯住 default、required、allow、deny 这几个词。
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Defaults include isolated state/设置说明书 and base 门口的小门卫 port 19001.
这是一句直接对 OpenClaw 说的话,像你把任务清清楚楚塞到它手里。
- 这一句是在直接叫 OpenClaw 动起来:“openclaw --dev setup”。你可以把它想成一句说出口就要执行的差事。
- 这一句是在直接叫 OpenClaw 动起来:“openclaw --dev gateway --allow-unconfigured”。你可以把它想成一句说出口就要执行的差事。
- 这一句是在直接叫 OpenClaw 动起来:“openclaw --dev status”。你可以把它想成一句说出口就要执行的差事。
openclaw --dev setup
openclaw --dev gateway --allow-unconfigured
openclaw --dev status
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Defaults include isolated state/设置说明书 and base 门口的小门卫 port 19001.
Defaults include isolated state/config and base gateway port 19001.
第 12 站
Protocol quick reference (operator view)
这一节在讲规则和边界:什么默认允许、什么必须显式打开、什么被禁止。
这一节在讲规则和边界:什么默认允许、什么必须显式打开、什么被禁止。
这种内容决定了 OpenClaw 是“能做”还是“现在还不能做”,读懂它比记术语更重要。
你可以把这一节当成权限说明书,真正配置时优先盯住 default、required、allow、deny 这几个词。
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:a generated dump of every callable helper route. session.小纸条消息, session.operation, session.工具小帮手, sessions.changed, pre…。
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:a generated dump of every callable helper route.
a generated dump of every callable helper route.
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:session.小纸条消息, session.operation, session.工具小帮手, sessions.changed, presence, tick, health, heartbeat, pairing/approval…。
session.message, session.operation, session.tool, sessions.changed, presence, tick, health, heartbeat, pairing/approval lifecycle events, and shutdown.
这一串条目别硬背,把它当成“Protocol quick reference (operator view)”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错:First 来帮忙的小伙伴 frame must be connect.、门口的小门卫 returns hello-ok snapshot (presenc…、hello-ok.features.methods / events are a…、Requests: req(method, params) → res(ok/pa…。
- First client frame must be
connect. - Gateway returns
hello-oksnapshot (presence,health,stateVersion,uptimeMs, limits/policy). hello-ok.features.methods/eventsare a conservative discovery list, not- Requests:
req(method, params)→res(ok/payload|error). - Common events include
connect.challenge,agent,chat,
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:机器人朋友 runs are two-stage:。
Agent runs are two-stage:
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:1. Immediate accepted ack (status:"accepted") 2. Final completion response (status:"ok" "error"), with 一边说一边送ed 机器人朋友 e…。
1. Immediate accepted ack (status:"accepted") 2. Final completion response (status:"ok"|"error"), with streamed agent events in between.
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:See full protocol docs: 门口的小门卫 Protocol.
See full protocol docs: Gateway Protocol.
第 13 站
Liveness
这一节主要在解释“Liveness”到底是干什么的,以及你什么时候会遇到它。
这一节主要在解释“Liveness”到底是干什么的,以及你什么时候会遇到它。
如果你是第一次接触 OpenClaw,这一节最值得看的不是术语本身,而是它背后的使用场景和限制。
真正动手时,先看它有没有默认值、有没有必须打开的选项、以及会不会影响安全边界。
这一小段像旁白,在提醒我们镜头已经切到下一站。
这一串条目别硬背,把它当成“Liveness”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错:Open WS and send connect.、Expect hello-ok response with snapshot.
- Open WS and send
connect. - Expect
hello-okresponse with snapshot.
第 14 站
Readiness
这一节主要在解释“Readiness”到底是干什么的,以及你什么时候会遇到它。
这一节主要在解释“Readiness”到底是干什么的,以及你什么时候会遇到它。
如果你是第一次接触 OpenClaw,这一节最值得看的不是术语本身,而是它背后的使用场景和限制。
真正动手时,先看它有没有默认值、有没有必须打开的选项、以及会不会影响安全边界。
这一小段像旁白,在提醒我们镜头已经切到下一站。
这是一句直接对 OpenClaw 说的话,像你把任务清清楚楚塞到它手里。
- 这一句是在直接叫 OpenClaw 动起来:“openclaw gateway status”。你可以把它想成一句说出口就要执行的差事。
- 这一句是在直接叫 OpenClaw 动起来:“openclaw channels status --probe”。你可以把它想成一句说出口就要执行的差事。
- 这一句是在直接叫 OpenClaw 动起来:“openclaw health”。你可以把它想成一句说出口就要执行的差事。
openclaw gateway status
openclaw channels status --probe
openclaw health
第 15 站
Gap recovery
这一节主要在解释“Gap recovery”到底是干什么的,以及你什么时候会遇到它。
这一节主要在解释“Gap recovery”到底是干什么的,以及你什么时候会遇到它。
如果你是第一次接触 OpenClaw,这一节最值得看的不是术语本身,而是它背后的使用场景和限制。
真正动手时,先看它有没有默认值、有没有必须打开的选项、以及会不会影响安全边界。
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Events are not replayed. On sequence gaps, refresh state (health, system-presence) before continuing.
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Events are not replayed. On sequence gaps, refresh state (health, system-presence) before continuing.
Events are not replayed. On sequence gaps, refresh state (health, system-presence) before continuing.
第 16 站
Common failure signatures
这一节主要在解释“Common failure signatures”到底是干什么的,以及你什么时候会遇到它。
这一节主要在解释“Common failure signatures”到底是干什么的,以及你什么时候会遇到它。
如果你是第一次接触 OpenClaw,这一节最值得看的不是术语本身,而是它背后的使用场景和限制。
真正动手时,先看它有没有默认值、有没有必须打开的选项、以及会不会影响安全边界。
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:For full diagnosis ladders, use 门口的小门卫 Troubleshooting.
这段是在把几种选项排成表格,左边像标签,右边像说明。手机上可以横向滑动原文表格。
| Signature | Likely issue |
|---|---|
refusing to bind gateway ... without auth | Non-loopback bind without a valid gateway auth path |
another gateway instance is already listening / EADDRINUSE | Port conflict |
Gateway start blocked: set gateway.mode=local | Config set to remote mode, or local-mode stamp is missing from a damaged config |
unauthorized during connect | Auth mismatch between client and gateway |
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:For full diagnosis ladders, use 门口的小门卫 Troubleshooting.
For full diagnosis ladders, use Gateway Troubleshooting.
第 17 站
Safety guarantees
这一节主要在解释“Safety guarantees”到底是干什么的,以及你什么时候会遇到它。
这一节主要在解释“Safety guarantees”到底是干什么的,以及你什么时候会遇到它。
如果你是第一次接触 OpenClaw,这一节最值得看的不是术语本身,而是它背后的使用场景和限制。
真正动手时,先看它有没有默认值、有没有必须打开的选项、以及会不会影响安全边界。
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:--- Related:。
这一串条目别硬背,把它当成“Safety guarantees”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错:门口的小门卫 protocol 来帮忙的小伙伴s fail fast when 门…、Invalid/non-connect first frames are reje…、Graceful shutdown emits shutdown event be…。
- Gateway protocol clients fail fast when Gateway is unavailable (no implicit direct-channel fallback).
- Invalid/non-connect first frames are rejected and closed.
- Graceful shutdown emits
shutdownevent before socket close.
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:---。
---
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:Related:。
Related:
这一串条目别硬背,把它当成“Safety guarantees”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错:Troubleshooting、Background Process、设置说明书uration、Health。
第 18 站
Related
这一节主要在解释“Related”到底是干什么的,以及你什么时候会遇到它。
这一节主要在解释“Related”到底是干什么的,以及你什么时候会遇到它。
如果你是第一次接触 OpenClaw,这一节最值得看的不是术语本身,而是它背后的使用场景和限制。
真正动手时,先看它有没有默认值、有没有必须打开的选项、以及会不会影响安全边界。
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:---。
这一串条目别硬背,把它当成“Related”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错:设置说明书uration、门口的小门卫 troubleshooting、Remote access、Secrets management。
如果把这一段摆成一个小场景,你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词,先抓住它此刻到底在发生什么:---。
---
AdSense 连接验证已经放在页面头部;广告单元等站点审批通过后再启用。
google-adsense-account: ca-pub-3833673520933536