openclaw/docs
Josh Lehman 8525fd94ea
docs: sync Feishu secretref credential matrix
## Summary

- Problem: `src/secrets/target-registry.test.ts` fails on latest `main` because the runtime registry includes Feishu `encryptKey` paths that the docs matrix and surface reference omit.
- Why it matters: the docs/runtime sync guard currently blocks prep and merge work for unrelated PRs, including `#25558`.
- What changed: regenerated the secretref credential matrix and updated the surface reference to include both Feishu `encryptKey` paths.
- What did NOT change (scope boundary): no runtime registry behavior, config semantics, or channel handling changed.

## Change Type (select all)

- [x] Bug fix
- [ ] Feature
- [ ] Refactor
- [x] Docs
- [ ] Security hardening
- [ ] Chore/infra

## Scope (select all touched areas)

- [ ] Gateway / orchestration
- [ ] Skills / tool execution
- [ ] Auth / tokens
- [ ] Memory / storage
- [x] Integrations
- [ ] API / contracts
- [ ] UI / DX
- [ ] CI/CD / infra

## Linked Issue/PR

- Closes #
- Related #25558

## User-visible / Behavior Changes

None.

## Security Impact (required)

- New permissions/capabilities? `No`
- Secrets/tokens handling changed? `No`
- New/changed network calls? `No`
- Command/tool execution surface changed? `No`
- Data access scope changed? `No`
- If any `Yes`, explain risk + mitigation:

## Repro + Verification

### Environment

- OS: macOS
- Runtime/container: Node.js repo checkout
- Model/provider: N/A
- Integration/channel (if any): Feishu docs/runtime registry sync
- Relevant config (redacted): none

### Steps

1. Check out latest `main` before this change.
2. Run `./node_modules/.bin/vitest run --config vitest.unit.config.ts src/secrets/target-registry.test.ts`.
3. Apply this docs-only sync change and rerun the same command.

### Expected

- The target registry stays in sync with the generated docs matrix and the test passes.

### Actual

- Before this change, the test failed because `channels.feishu.encryptKey` and `channels.feishu.accounts.*.encryptKey` were missing from the docs artifacts.

## Evidence

Attach at least one:

- [x] Failing test/log before + passing after
- [ ] Trace/log snippets
- [ ] Screenshot/recording
- [ ] Perf numbers (if relevant)

## Human Verification (required)

What you personally verified (not just CI), and how:

- Verified scenarios: confirmed the failure on plain latest `main`, applied only these docs entries in a clean bootstrapped worktree, and reran `./node_modules/.bin/vitest run --config vitest.unit.config.ts src/secrets/target-registry.test.ts` to green.
- Edge cases checked: verified both top-level Feishu `encryptKey` and account-scoped `encryptKey` paths are present in the matrix and surface reference.
- What you did **not** verify: full repo test suite and CI beyond the targeted regression.

## Review Conversations

- [x] I replied to or resolved every bot review conversation I addressed in this PR.
- [x] I left unresolved only the conversations that still need reviewer or maintainer judgment.

If a bot review conversation is addressed by this PR, resolve that conversation yourself. Do not leave bot review conversation cleanup for maintainers.

## Compatibility / Migration

- Backward compatible? `Yes`
- Config/env changes? `No`
- Migration needed? `No`
- If yes, exact upgrade steps:

## Failure Recovery (if this breaks)

- How to disable/revert this change quickly: revert this commit.
- Files/config to restore: `docs/reference/secretref-user-supplied-credentials-matrix.json` and `docs/reference/secretref-credential-surface.md`
- Known bad symptoms reviewers should watch for: the target-registry docs sync test failing again for missing Feishu `encryptKey` entries.

## Risks and Mitigations

- Risk: the markdown surface reference could drift from the generated matrix again in a later credential-shape change.
  - Mitigation: `src/secrets/target-registry.test.ts` continues to guard docs/runtime sync.
2026-03-12 08:18:13 -07:00
..
.i18n fix(docs): revert accidental es/pt-BR translation scaffold from #18473 2026-02-17 02:23:41 +01:00
assets docs: add Vercel sponsorship (#29270) 2026-03-02 06:25:46 +00:00
automation mattermost: fix DM media upload for unprefixed user IDs (#29925) 2026-03-10 14:22:24 +05:30
channels Security: require Feishu webhook encrypt key (#44087) 2026-03-12 11:01:00 -04:00
cli Models: enforce source-managed SecretRef markers in models.json (#43759) 2026-03-12 02:22:52 -05:00
concepts Models: enforce source-managed SecretRef markers in models.json (#43759) 2026-03-12 02:22:52 -05:00
debug Docs: enable markdownlint autofixables except list numbering (#10476) 2026-02-06 10:08:59 -05:00
design docs: tighten subscription guidance and update MiniMax M2.5 refs 2026-03-03 00:02:37 +00:00
diagnostics Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
experiments docs(protocol): document slash-delimited schema lookup plugin ids 2026-03-06 08:53:29 -05:00
gateway Models: enforce source-managed SecretRef markers in models.json (#43759) 2026-03-12 02:22:52 -05:00
help docs(ollama): align onboarding guidance with code 2026-03-11 20:11:51 +00:00
images docs(feishu): Feishu docs – add verificationToken and align zh-CN with EN (openclaw#31555) thanks @xbsheng 2026-03-02 21:33:41 -06:00
install build: align Node 22 guidance with 22.16 minimum 2026-03-12 20:07:44 +05:30
ja-JP docs: fix broken dashboard image on i18n pages (#38031) 2026-03-07 00:22:19 +03:00
nodes Gateway: fail closed unresolved local auth SecretRefs (#42672) 2026-03-10 21:41:56 -05:00
platforms build: align Node 22 guidance with 22.16 minimum 2026-03-12 20:07:44 +05:30
plugins docs: context engine 2026-03-06 08:55:58 -05:00
providers docs(ollama): align onboarding guidance with code 2026-03-11 20:11:51 +00:00
refactor chore(docs): drop refactor cleanup tracker 2026-03-09 00:26:20 +00:00
reference docs: sync Feishu secretref credential matrix 2026-03-12 08:18:13 -07:00
security docs: fix Mintlify-incompatible links in security docs (#27698) 2026-03-03 14:51:28 -08:00
start build: raise Node 22 compatibility floor to 22.16 2026-03-12 20:07:44 +05:30
tools Docs: clarify llm-task thinking presets 2026-03-12 19:27:07 +11:00
web fix(gateway): harden token fallback/reconnect behavior and docs (#42507) 2026-03-10 17:05:57 -05:00
zh-CN Revert "docs: add Browserbase as hosted remote CDP option" 2026-03-08 18:48:10 +00:00
CNAME refactor: rename to openclaw 2026-01-30 03:16:21 +01:00
auth-credential-semantics.md follow-up: align ingress, atomic paths, and channel tests with credential semantics (#33733) 2026-03-03 20:29:46 -06:00
brave-search.md docs: update Brave Search API docs for Feb 2026 plan restructuring (#40111) 2026-03-08 14:06:21 -04:00
ci.md CI: gate Windows checks by windows-relevant scope (#32456) 2026-03-02 19:10:58 -08:00
date-time.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
docs.json docs: add Kubernetes install guide, setup script, and manifests (#34492) 2026-03-12 07:28:21 -04:00
index.md build: raise Node 22 compatibility floor to 22.16 2026-03-12 20:07:44 +05:30
logging.md Feat/logger support log level validation0222 (#23436) 2026-02-22 11:15:13 +01:00
nav-tabs-underline.js docs(ui): add animated underline for nav tabs (#21912) 2026-02-20 09:33:46 -05:00
network.md docs: canonicalize docs paths and align zh navigation (#11428) 2026-02-07 15:40:35 -05:00
perplexity.md fix(secrets): resolve web tool SecretRefs atomically at runtime 2026-03-09 22:57:03 -05:00
pi-dev.md docs: replace removed pi test script with current commands 2026-02-22 21:07:34 +01:00
pi.md fix(pi): stop history image reinjection token blowup 2026-02-26 16:38:20 +01:00
prose.md docs: canonicalize docs paths and align zh navigation (#11428) 2026-02-07 15:40:35 -05:00
style.css fix(ios): force tls for non-loopback manual gateway hosts (#21969) 2026-02-20 16:28:47 +00:00
tts.md Docs: clarify OpenAI-compatible TTS endpoints 2026-03-05 16:57:51 -05:00
vps.md Docs: remove MDX-breaking secret markers 2026-03-07 10:09:00 -08:00
whatsapp-openclaw-ai-zh.jpg Docs: add zh-CN landing notice + AI image 2026-02-02 18:35:01 +01:00
whatsapp-openclaw.jpg refactor: rename to openclaw 2026-01-30 03:16:21 +01:00