mirror of https://github.com/iflytek/skillhub.git synced 2026-08-28 11:25:00 +00:00

docs(faq): add CLI namespace-not-found and PostgreSQL permission entries (#743 )

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 13:39:49 +08:00

1.8 KiB

Raw Permalink Blame History

title	sidebar_position	description
常见问题	1	常见问题解答

常见问题

部署相关

如何修改默认端口？

修改 .env.release 中的端口配置。

如何配置 HTTPS？

建议使用反向代理（Nginx/Ingress）处理 TLS 终止。

数据库如何备份？

使用 PostgreSQL 标准备份工具（pg_dump）。

使用相关

如何重置管理员密码？

如果忘记管理员密码，可通过环境变量重新设置首登管理员，或直接操作数据库。

技能包上传失败怎么办？

检查：

文件大小是否超限
文件类型是否在白名单内
是否包含必需的 SKILL.md
SKILL.md frontmatter 格式是否正确

使用 CLI 安装技能时报 `namespace not found`？

多数情况是 CLI 没有指向你自己的 SkillHub 实例，或命名空间格式不对：

配置 registry 并登录：用环境变量或 --registry 指向你的实例，例如 clawhub --registry https://skillhub.your-company.com install <skill>；登录需要先在 Web 控制台生成 API Token。
命名空间 slug 格式：全局命名空间的技能直接用名字（如 my-skill）；团队命名空间要用 team--skill 的形式（@team/skill → team--skill）。
最稳妥的方式是直接在 SkillHub Web 界面点技能的「安装」按钮，复制其中已经带好正确 registry 与命名空间的命令。

SkillHub 同时提供 clawhub 和 skillhub 两种 CLI，用法见各自 README；通过 OpenClaw 对话安装技能时，底层同样调用 CLI。

开发相关

如何扩展 OAuth Provider？

参考现有 GitHub 实现，添加新的 OAuth Provider 配置。

如何自定义搜索实现？

实现 SearchIndexService 和 SearchQueryService 接口。

下一步

故障排查 - 问题诊断

1.8 KiB Raw Permalink Blame History Unescape Escape