scriptoriumadmin/skillhub
1
0
Fork 0
mirror of https://github.com/iflytek/skillhub.git synced 2026-08-27 11:14:59 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 2
skillhub/document/i18n/en/docusaurus-plugin-content-docs/current/05-reference/faq.md
FenjuFu 19855fbf49 docs(faq): add CLI namespace-not-found and PostgreSQL permission entries 
Add two entries collected from community support, to both the zh docs and
the en i18n mirror:

- FAQ: installing a skill via CLI reporting `namespace not found` — set the
  registry / log in with an API token, and use the correct namespace slug
  (`@team/skill` -> `team--skill`); the web UI Install button provides a
  ready-made command.
- Troubleshooting: PostgreSQL container failing to start with
  `operation not permitted` on bind mounts — fix data volume ownership
  (`chown 999:999`), check SELinux, or use the `runtime.sh` script.

Signed-off-by: FenjuFu <92919259+FenjuFu@users.noreply.github.com>
2026-08-24 10:34:21 +08:00

2 KiB
Raw Blame History

title sidebar_position description
FAQ 1 Frequently asked questions

FAQ

Deployment Related

How to change default port?

Modify port configuration in .env.release.

How to configure HTTPS?

Recommended to use reverse proxy (Nginx/Ingress) for TLS termination.

How to backup database?

Use PostgreSQL standard backup tools (pg_dump).

Usage Related

How to reset admin password?

If you forgot admin password, you can reconfigure bootstrap admin via environment variables or directly operate the database.

Skill package upload failed?

Check:

  1. Whether file size exceeds limit
  2. Whether file type is in whitelist
  3. Whether required SKILL.md is included
  4. Whether SKILL.md frontmatter format is correct

CLI install reports namespace not found?

Usually the CLI is not pointing at your own SkillHub instance, or the namespace format is wrong:

  1. Set the registry and log in: point at your instance via an environment variable or --registry, e.g. clawhub --registry https://skillhub.your-company.com install <skill>. Logging in requires an API Token generated in the web console first.
  2. Namespace slug format: skills in the global namespace use the bare name (e.g. my-skill); team namespaces use the team--skill form (@team/skill → team--skill).
  3. The most reliable way is to click the Install button on the skill's page in the SkillHub web UI and copy the command, which already includes the correct registry and namespace.

SkillHub ships both a clawhub and a skillhub CLI (see their respective READMEs); installing a skill through an OpenClaw conversation calls the CLI under the hood as well.

Development Related

How to extend OAuth Provider?

Refer to existing GitHub implementation, add new OAuth Provider configuration.

How to customize search implementation?

Implement SearchIndexService and SearchQueryService interfaces.

Next Steps