by 详细分析 ▾
运行时依赖
版本
简化 GitHub 安装章节，并扩展英文二进制使用指南。
安装命令
点击复制技能文档
# Bit CLI 技能（仅文档） ## 技能目的与触发场景 - 目的：为 Bit URL 缩短器 CLI（bit）提供使用入口，用于创建、查询、更新、删除短链接并查看点击数据。 - 触发场景： - 用户提到“短 URL”“bit-cli”等需求，或输入 bit create/list/get/update/delete/clicks 等命令。 - 用户希望通过 OpenClaw 执行 Bit API 操作。 - 用户需要验证 Bit API 可用性（例如健康检查）。 ## 安装（GitHub） - 安装源：https://github.com/ParinLL/bit-cli - 从 GitHub 安装： ``bash git clone https://github.com/ParinLL/bit-cli.git cd bit-cli go build -o bit . sudo mv bit /usr/local/bin/ ` - 构建前请先查阅仓库内容。 ## 所需环境变量 / 权限 - 必需环境变量： - BIT_API_KEY（必需）：Bit API 认证密钥。 - BIT_API_URL（可选）：Bit API 基础 URL，默认为 http://localhost:4000。 - 权限要求： - bit 可执行文件必须能在 PATH 中被调用。 - 使用 sudo mv 安装到 /usr/local/bin 需要管理员权限。 - 若目标 API 为远程地址，则需网络连通性。 ## 使用 bit 二进制文件 - 验证安装： `bash which bit bit ping ` - 运行命令前配置 API 访问： `bash export BIT_API_URL="http://localhost:4000" export BIT_API_KEY="your-api-key" ` - 命令格式： - bit [arguments] [flags] - 主要命令及使用时机： - bit ping —— 在其他操作前快速检查 API 健康状态。 - bit create —— 为目标 URL 创建短链接。 - bit list [--limit N] [--cursor X] —— 列出链接，支持大数据集分页。 - bit get —— 获取单个链接及其近期点击详情。 - bit update —— 替换现有短链接的目标 URL。 - bit delete —— 按 ID 删除短链接。 - bit clicks [--limit N] [--cursor X] —— 查看链接的点击历史，支持分页。 - 典型工作流： `bash # 1) 确认服务可达 bit ping # 2) 创建短链接 bit create https://example.com/docs # 3) 列出链接以找到新 ID bit list --limit 20 # 4) 查看单个链接 bit get 1 # 5) 查看点击记录 bit clicks 1 --limit 50 # 6) 如需更新目标地址 bit update 1 https://example.com/new-docs # 7) 不再需要时删除 bit delete 1 ` - 实用提示： - 请求意外失败时，先执行 bit ping。 - 使用 list/get 确认 ID 后再执行 update 或 delete。 - 将 BIT_API_KEY 保存在环境变量中，而非命令历史或共享脚本。 ## 常见故障排查 - bit: command not found - 原因：CLI 未安装或不在 PATH。 - 解决：用 go build 重新构建，并确认 which bit 返回有效路径。 - 401 Unauthorized / 403 Forbidden - 原因：BIT_API_KEY 缺失或无效。 - 解决：重新设置 BIT_API_KEY，并确认密钥在服务端仍有效。 - connection refused / 超时 - 原因：BIT_API_URL 错误、Bit 服务未启动或网络不可达。 - 解决：先运行 bit ping，再检查 API 服务状态与 URL。 - 命令成功但数据异常 - 原因：目标 ID 不存在、数据已被删除或更新载荷格式错误。 - 解决：用 bit list 或 bit get ` 验证当前状态，然后重试。