docs(openclaw): clarify verify availability and status triage#175
Open
MatrixAdventurer wants to merge 1 commit intomatrixorigin:mainfrom
Open
Conversation
MatrixAdventurer
requested review from
XuPeng-SH,
aptend and
randomradio
as code owners
MatrixAdventurer
force-pushed
the
fix/openclaw-readme-verify-and-status-triage
branch
from
05b8414 to
410b6eb
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary\n- replace the README smoke-check command from [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
[plugins] feishu_chat: Registered feishu_chat tool
[plugins] feishu_wiki: Registered feishu_wiki tool
[plugins] feishu_drive: Registered feishu_drive tool
[plugins] feishu_bitable: Registered bitable tools
[plugins] thememoria: registered (api) to [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
[plugins] feishu_chat: Registered feishu_chat tool
[plugins] feishu_wiki: Registered feishu_wiki tool
[plugins] feishu_drive: Registered feishu_drive tool
[plugins] feishu_bitable: Registered bitable tools
[plugins] thememoria: registered (api)
🦞 OpenClaw 2026.4.9 (0512059) — I'll butter your workflow like a lobster roll: messy, delicious, effective.
Usage: openclaw memoria [options] [command]
Memoria plugin commands
Options:
-h, --help Display help for command
Commands:
capabilities Show plugin capabilities and compatibility mappings
health Check Memoria connectivity
help Display help for command
list List recent Memoria memories
profile Show the current Memoria profile
search Search Memoria memories
setup Configure Memoria cloud API backend
stats Show aggregate Memoria statistics\n- clarify that some released OpenClaw builds may not expose [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
[plugins] feishu_chat: Registered feishu_chat tool
[plugins] feishu_wiki: Registered feishu_wiki tool
[plugins] feishu_drive: Registered feishu_drive tool
[plugins] feishu_bitable: Registered bitable tools
[plugins] thememoria: registered (api) yet\n- document a direct Memoria triage flow for cases where [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
[plugins] feishu_chat: Registered feishu_chat tool
[plugins] feishu_wiki: Registered feishu_wiki tool
[plugins] feishu_drive: Registered feishu_drive tool
[plugins] feishu_bitable: Registered bitable tools
[plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
[plugins] feishu_chat: Registered feishu_chat tool
[plugins] feishu_wiki: Registered feishu_wiki tool
[plugins] feishu_drive: Registered feishu_drive tool
[plugins] feishu_bitable: Registered bitable tools
[plugins] thememoria: registered (api)
[plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
[plugins] feishu_chat: Registered feishu_chat tool
[plugins] feishu_wiki: Registered feishu_wiki tool
[plugins] feishu_drive: Registered feishu_drive tool
[plugins] feishu_bitable: Registered bitable tools
OpenClaw status
Overview
┌──────────────────────┬───────────────────────────────────────────────────────────────────────────────────────────────┐
│ Item │ Value │
├──────────────────────┼───────────────────────────────────────────────────────────────────────────────────────────────┤
│ OS │ macos 26.4 (arm64) · node 25.8.1 │
│ Dashboard │ http://127.0.0.1:54188/ │
│ Tailscale │ off │
│ Channel │ stable (default) │
│ Update │ pnpm · up to date · npm latest 2026.4.9 │
│ Gateway │ local · ws://127.0.0.1:54188 (local loopback) · reachable 54ms · auth token · MacBook-Air- │
│ │ Long.local (10.222.2.82) app 2026.4.9 macos 26.4 │
│ Gateway self │ MacBook-Air-Long.local (10.222.2.82) app 2026.4.9 macos 26.4 │
│ Gateway service │ LaunchAgent installed · loaded · running (pid 29202, state active) │
│ Node service │ LaunchAgent not installed │
│ Agents │ 7 · 2 bootstrap files present · sessions 5 · default main active 14m ago │
│ Memory │ enabled (plugin thememoria) · unavailable │
│ Plugin compatibility │ none │
│ Probes │ skipped (use --deep) │
│ Events │ none │
│ Tasks │ 0 active · 0 queued · 0 running · no issues · audit clean · 1 tracked │
│ Heartbeat │ 30m (main), disabled (annie), disabled (fury), disabled (morpheus), disabled (oracle), │
│ │ disabled (ronger), disabled (stark) │
│ Sessions │ 5 active · default gpt-5.4 (200k ctx) · 7 stores │
└──────────────────────┴───────────────────────────────────────────────────────────────────────────────────────────────┘
Security audit
Summary: 0 critical · 4 warn · 1 info
WARN Reverse proxy headers are not trusted
gateway.bind is loopback and gateway.trustedProxies is empty. If you expose the Control UI through a reverse proxy, configure trusted proxies so local-client c…
Fix: Set gateway.trustedProxies to your proxy IPs or keep the Control UI local-only.
WARN Some gateway.nodes.denyCommands entries are ineffective
gateway.nodes.denyCommands uses exact node command-name matching only (for example
system.run), not shell-text filtering inside a command payload. - Unknown …Fix: Use exact command names (for example: canvas.present, canvas.hide, canvas.navigate, canvas.eval, canvas.snapshot, canvas.a2ui.push, canvas.a2ui.pushJSONL, canvas.a2ui.reset). If you need broader restrictions, remove risky command IDs from allowCommands/default workflows and tighten tools.exec policy.
WARN Plugin installs include unpinned npm specs
Unpinned plugin install records: - thememoria (@matrixorigin/thememoria)
Fix: Pin install specs to exact versions (for example,
@scope/pkg@1.2.3) for higher supply-chain stability.WARN Feishu doc create can grant requester permissions
channels.feishu tools include "doc"; feishu_doc action "create" can grant document access to the trusted requesting Feishu user.
Fix: Disable channels.feishu.tools.doc when not needed, and restrict tool access for untrusted prompts.
Full report: openclaw security audit
Deep probe: openclaw security audit --deep
Channels
┌──────────┬─────────┬────────┬────────────────────────────────────────────────────────────────────────────────────────┐
│ Channel │ Enabled │ State │ Detail │
├──────────┼─────────┼────────┼────────────────────────────────────────────────────────────────────────────────────────┤
│ Telegram │ ON │ OK │ token config×2 (8637…HF9Q · len 46) · accounts 2/2 │
│ WhatsApp │ ON │ OK │ linked · +16507998703 · auth 9m ago · accounts 1 │
│ Feishu │ ON │ OK │ configured │
└──────────┴─────────┴────────┴────────────────────────────────────────────────────────────────────────────────────────┘
Sessions
┌──────────────────────────────────────────────────┬────────┬─────────┬──────────────┬─────────────────────────────────┐
│ Key │ Kind │ Age │ Model │ Tokens │
├──────────────────────────────────────────────────┼────────┼─────────┼──────────────┼─────────────────────────────────┤
│ agent:stark:feishu:direct:ou_e9… │ direct │ 3m ago │ gpt-5.4 │ 70k/272k (26%) · 🗄️ 28% cached │
│ agent:main:telegram:direct:1654… │ direct │ 14m ago │ gpt-5.4 │ 103k/272k (38%) · 🗄️ 25% cached │
│ agent:main:main │ direct │ 20m ago │ gpt-5.4 │ 124k/272k (46%) · 🗄️ 50% cached │
│ agent:main:feishu:direct:ou_e92… │ direct │ 16h ago │ gpt-5.4 │ 33k/272k (12%) · 🗄️ 49% cached │
│ agent:ronger:telegram:direct:16… │ direct │ 40h ago │ gpt-5.4 │ 11k/200k (5%) · 🗄️ 14% cached │
└──────────────────────────────────────────────────┴────────┴─────────┴──────────────┴─────────────────────────────────┘
FAQ: https://docs.openclaw.ai/faq
Troubleshooting: https://docs.openclaw.ai/troubleshooting
Next steps:
Need to share? openclaw status --all
Need to debug live? openclaw logs --follow
Need to test channels? openclaw status --deep reports memory unavailable even though the plugin backend is healthy\n\n## Why\nWhile validating a live OpenClaw + Memoria installation, I hit a mismatch where:\n- the plugin was loaded\n- [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
[plugins] feishu_chat: Registered feishu_chat tool
[plugins] feishu_wiki: Registered feishu_wiki tool
[plugins] feishu_drive: Registered feishu_drive tool
[plugins] feishu_bitable: Registered bitable tools
[plugins] thememoria: registered (api)
{
"userId": "longw-local",
"backend": "api",
"status": "ok",
"mode": "api",
"instance_id": "4d1453fcb1104f1e83222962edbcc405-1",
"db": true,
"warnings": []
} returned \n- [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
[plugins] feishu_chat: Registered feishu_chat tool
[plugins] feishu_wiki: Registered feishu_wiki tool
[plugins] feishu_drive: Registered feishu_drive tool
[plugins] feishu_bitable: Registered bitable tools
[plugins] thememoria: registered (api) returned real memories\n- but [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
[plugins] feishu_chat: Registered feishu_chat tool
[plugins] feishu_wiki: Registered feishu_wiki tool
[plugins] feishu_drive: Registered feishu_drive tool
[plugins] feishu_bitable: Registered bitable tools
[plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
[plugins] feishu_chat: Registered feishu_chat tool
[plugins] feishu_wiki: Registered feishu_wiki tool
[plugins] feishu_drive: Registered feishu_drive tool
[plugins] feishu_bitable: Registered bitable tools
[plugins] thememoria: registered (api)
[plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
[plugins] feishu_chat: Registered feishu_chat tool
[plugins] feishu_wiki: Registered feishu_wiki tool
[plugins] feishu_drive: Registered feishu_drive tool
[plugins] feishu_bitable: Registered bitable tools
OpenClaw status
Overview
┌──────────────────────┬───────────────────────────────────────────────────────────────────────────────────────────────┐
│ Item │ Value │
├──────────────────────┼───────────────────────────────────────────────────────────────────────────────────────────────┤
│ OS │ macos 26.4 (arm64) · node 25.8.1 │
│ Dashboard │ http://127.0.0.1:54188/ │
│ Tailscale │ off │
│ Channel │ stable (default) │
│ Update │ pnpm · up to date · npm latest 2026.4.9 │
│ Gateway │ local · ws://127.0.0.1:54188 (local loopback) · reachable 30ms · auth token · MacBook-Air- │
│ │ Long.local (10.222.2.82) app 2026.4.9 macos 26.4 │
│ Gateway self │ MacBook-Air-Long.local (10.222.2.82) app 2026.4.9 macos 26.4 │
│ Gateway service │ LaunchAgent installed · loaded · running (pid 29202, state active) │
│ Node service │ LaunchAgent not installed │
│ Agents │ 7 · 2 bootstrap files present · sessions 5 · default main active 14m ago │
│ Memory │ enabled (plugin thememoria) · unavailable │
│ Plugin compatibility │ none │
│ Probes │ skipped (use --deep) │
│ Events │ none │
│ Tasks │ 0 active · 0 queued · 0 running · no issues · audit clean · 1 tracked │
│ Heartbeat │ 30m (main), disabled (annie), disabled (fury), disabled (morpheus), disabled (oracle), │
│ │ disabled (ronger), disabled (stark) │
│ Sessions │ 5 active · default gpt-5.4 (200k ctx) · 7 stores │
└──────────────────────┴───────────────────────────────────────────────────────────────────────────────────────────────┘
Security audit
Summary: 0 critical · 4 warn · 1 info
WARN Reverse proxy headers are not trusted
gateway.bind is loopback and gateway.trustedProxies is empty. If you expose the Control UI through a reverse proxy, configure trusted proxies so local-client c…
Fix: Set gateway.trustedProxies to your proxy IPs or keep the Control UI local-only.
WARN Some gateway.nodes.denyCommands entries are ineffective
gateway.nodes.denyCommands uses exact node command-name matching only (for example
system.run), not shell-text filtering inside a command payload. - Unknown …Fix: Use exact command names (for example: canvas.present, canvas.hide, canvas.navigate, canvas.eval, canvas.snapshot, canvas.a2ui.push, canvas.a2ui.pushJSONL, canvas.a2ui.reset). If you need broader restrictions, remove risky command IDs from allowCommands/default workflows and tighten tools.exec policy.
WARN Plugin installs include unpinned npm specs
Unpinned plugin install records: - thememoria (@matrixorigin/thememoria)
Fix: Pin install specs to exact versions (for example,
@scope/pkg@1.2.3) for higher supply-chain stability.WARN Feishu doc create can grant requester permissions
channels.feishu tools include "doc"; feishu_doc action "create" can grant document access to the trusted requesting Feishu user.
Fix: Disable channels.feishu.tools.doc when not needed, and restrict tool access for untrusted prompts.
Full report: openclaw security audit
Deep probe: openclaw security audit --deep
Channels
┌──────────┬─────────┬────────┬────────────────────────────────────────────────────────────────────────────────────────┐
│ Channel │ Enabled │ State │ Detail │
├──────────┼─────────┼────────┼────────────────────────────────────────────────────────────────────────────────────────┤
│ Telegram │ ON │ OK │ token config×2 (8637…HF9Q · len 46) · accounts 2/2 │
│ WhatsApp │ ON │ OK │ linked · +16507998703 · auth 9m ago · accounts 1 │
│ Feishu │ ON │ OK │ configured │
└──────────┴─────────┴────────┴────────────────────────────────────────────────────────────────────────────────────────┘
Sessions
┌──────────────────────────────────────────────────┬────────┬─────────┬──────────────┬─────────────────────────────────┐
│ Key │ Kind │ Age │ Model │ Tokens │
├──────────────────────────────────────────────────┼────────┼─────────┼──────────────┼─────────────────────────────────┤
│ agent:stark:feishu:direct:ou_e9… │ direct │ 3m ago │ gpt-5.4 │ 70k/272k (26%) · 🗄️ 28% cached │
│ agent:main:telegram:direct:1654… │ direct │ 14m ago │ gpt-5.4 │ 103k/272k (38%) · 🗄️ 25% cached │
│ agent:main:main │ direct │ 20m ago │ gpt-5.4 │ 124k/272k (46%) · 🗄️ 50% cached │
│ agent:main:feishu:direct:ou_e92… │ direct │ 16h ago │ gpt-5.4 │ 33k/272k (12%) · 🗄️ 49% cached │
│ agent:ronger:telegram:direct:16… │ direct │ 40h ago │ gpt-5.4 │ 11k/200k (5%) · 🗄️ 14% cached │
└──────────────────────────────────────────────────┴────────┴─────────┴──────────────┴─────────────────────────────────┘
FAQ: https://docs.openclaw.ai/faq
Troubleshooting: https://docs.openclaw.ai/troubleshooting
Next steps:
Need to share? openclaw status --all
Need to debug live? openclaw logs --follow
Need to test channels? openclaw status --deep still showed memory as unavailable\n\nThat makes the current README guidance a bit misleading for operators, especially because some shipped builds do not expose [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
[plugins] feishu_chat: Registered feishu_chat tool
[plugins] feishu_wiki: Registered feishu_wiki tool
[plugins] feishu_drive: Registered feishu_drive tool
[plugins] feishu_bitable: Registered bitable tools
[plugins] thememoria: registered (api) even though the plugin source mentions it. This PR keeps the docs aligned with the commands operators can reliably use today.\n\n## Validation\n- [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
[plugins] feishu_chat: Registered feishu_chat tool
[plugins] feishu_wiki: Registered feishu_wiki tool
[plugins] feishu_drive: Registered feishu_drive tool
[plugins] feishu_bitable: Registered bitable tools
[plugins] thememoria: registered (api)
🦞 OpenClaw 2026.4.9 (0512059) — I can grep it, git blame it, and gently roast it—pick your coping mechanism.
Usage: openclaw memoria [options] [command]
Memoria plugin commands
Options:
-h, --help Display help for command
Commands:
capabilities Show plugin capabilities and compatibility mappings
health Check Memoria connectivity
help Display help for command
list List recent Memoria memories
profile Show the current Memoria profile
search Search Memoria memories
setup Configure Memoria cloud API backend
stats Show aggregate Memoria statistics\n- [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
[plugins] feishu_chat: Registered feishu_chat tool
[plugins] feishu_wiki: Registered feishu_wiki tool
[plugins] feishu_drive: Registered feishu_drive tool
[plugins] feishu_bitable: Registered bitable tools
[plugins] thememoria: registered (api)
{
"userId": "longw-local",
"backend": "api",
"status": "ok",
"mode": "api",
"instance_id": "4d1453fcb1104f1e83222962edbcc405-1",
"db": true,
"warnings": []
}\n- [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
[plugins] feishu_chat: Registered feishu_chat tool
[plugins] feishu_wiki: Registered feishu_wiki tool
[plugins] feishu_drive: Registered feishu_drive tool
[plugins] feishu_bitable: Registered bitable tools
[plugins] thememoria: registered (api)
{
"backend": "api",
"userIdStrategy": "config",
"autoRecall": true,
"autoObserve": false,
"llmConfigured": true,
"tools": [
"memory_search",
"memory_get",
"memory_store",
"memory_retrieve",
"memory_recall",
"memory_list",
"memory_stats",
"memory_profile",
"memory_correct",
"memory_purge",
"memory_forget",
"memory_health",
"memory_observe",
"memory_governance",
"memory_consolidate",
"memory_reflect",
"memory_extract_entities",
"memory_link_entities",
"memory_rebuild_index",
"memory_capabilities",
"memory_snapshot",
"memory_snapshots",
"memory_rollback",
"memory_branch",
"memory_branches",
"memory_checkout",
"memory_branch_delete",
"memory_merge",
"memory_diff"
],
"embeddedOnly": [],
"cliCommands": [
"memoria",
"ltm"
],
"aliases": {
"memory_recall": "memory_retrieve",
"ltm list": "memory_list",
"ltm search": "memory_recall",
"ltm stats": "memory_stats",
"ltm health": "memory_health"
},
"backendFeatures": {
"rollback": true,
"snapshots": true,
"branches": true,
"governance": true,
"reflect": true,
"entities": true,
"rebuildIndex": true
},
"limitations": [
"OpenClaw reserves
openclaw memoryfor built-in file-memory commands; compatibility CLI is exposed asopenclaw ltm.","memory_get is resolved from recent tool results plus a bounded Rust MCP scan; if an older memory is missing, rerun memory_search or memory_list first."
]
}\n- [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
[plugins] feishu_chat: Registered feishu_chat tool
[plugins] feishu_wiki: Registered feishu_wiki tool
[plugins] feishu_drive: Registered feishu_drive tool
[plugins] feishu_bitable: Registered bitable tools
[plugins] thememoria: registered (api)\n- [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
[plugins] feishu_chat: Registered feishu_chat tool
[plugins] feishu_wiki: Registered feishu_wiki tool
[plugins] feishu_drive: Registered feishu_drive tool
[plugins] feishu_bitable: Registered bitable tools
[plugins] thememoria: registered (api)