可直接在composer.json中通过"type": "hg"配置私有Mercurial仓库，需确保本地安装hg、网络可达且凭据正确（推荐用auth.json管理），Composer会自动识别标签和分支生成版本号。
可以直接把私有 Mercurial 仓库加进 composer.json 的 repositories 里，但需要确保 Composer 能访问并克隆它——关键在于配置正确的 VCS 类型和可访问的 URL。
1. 在 composer.json 中声明 Hg 仓库
Mercurial 是 Composer 原生支持的 VCS 类型之一（和 Git、SVN 并列），只需指定 "type": "hg" 和仓库地址：
{
"repositories": [
{
"type": "hg",
"url": "https://your-server.com/hg/your-private-package"
}
],
"require": {
"your-vendor/your-private-package": "dev-default"
}
}
注意：dev-default 表示默认分支（通常是 default），也可用具体标签如 1.0.0 或带 dev- 前缀的命名分支（如 dev-feature/login）。
2. 确保本地能克隆该仓库
Composer 内部调用 hg clone，所以执行 composer install/update 的机器必须：
- 已安装
hg命令（Mercurial 客户端）且在$PATH中 - 能通过 URL 访问仓库（HTTP(S) 需带认证，SSH 需配好密钥）
- 如果是 HTTPS 私库，推荐用
https://user:token@...形式嵌入凭据（如 Bitbucket Cloud 支持 App Password），或配置auth.json
3. 使用 auth.json 管理凭据（推荐）
避免把密码写进 composer.json，在项目根目录或 Composer 全局配置目录（如 ~/.composer/auth.json）放：
将公开的创作者、博主、播客主持人、YouTuber 或 X/Twitter 账号人物转化为可部署的 OpenClaw 代理。当用户提供 YouTube 链接、X（推特）链接等时使用。
{
"http-basic": {
"your-server.com": {
"username": "your-username",
"password": "your-app-token-or-password"
}
}
}
这样 Composer 会自动在 HTTP 请求中带上 Basic Auth 头，适用于 Bitbucket Server、RhodeCode、自建 Kallithea 等支持 HTTP Basic 的 Hg 服务。
4. 注意分支与版本映射规则
Composer 会扫描 Hg 仓库的标签（hg tags）和分支（hg branches）来生成版本号：
- 标签
v1.2.3或1.2.3→ 版本1.2.3 - 分支
stable→ 版本dev-stable - 默认分支（
default）→ 版本dev-default - 未打标签的提交，只能用
dev-default#abc123指定具体变更集
建议在私有包中规范打语义化标签（如 1.0.0），方便 require 时直接写稳定版本号。
基本上就这些。只要 hg 可用、网络通、凭据对，Composer 就能像拉 Git 包一样拉你的 Hg 包——不需要额外插件或包装器。
