You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

安装@microsoft/botframework-cli成功后无法运行bf orchestrator命令

bf命令未识别问题排查方案
  • 步骤1:验证npm全局路径是否加入系统环境变量
    执行命令npm root -g获取npm全局模块存储路径,该路径的上层目录(一般Windows系统为C:\Users\<你的用户名>\AppData\Roaming\npm,macOS/Linux系统为/usr/local/bin对应的父级目录)需要添加到系统PATH环境变量中。
  • 步骤2:确认包是否实际安装成功
    进入上述npm全局路径下的node_modules目录,检查是否存在@microsoft/botframework-cli文件夹,同时检查npm根目录下是否存在bf.cmd(Windows)或bf(macOS/Linux)可执行文件。如果文件缺失,说明安装未实际完成,可使用管理员权限打开终端,执行npm install -g @microsoft/botframework-cli --force重新安装,安装前可切换国内npm源避免网络问题:npm config set registry https://registry.npmmirror.com。
  • 步骤3:刷新终端环境
    安装完成后必须关闭所有已打开的终端窗口(包括VSCode内置终端),重新打开后再执行bf --version验证是否能正常输出版本号。
  • 步骤4:校验Node.js版本兼容性
    Bot Framework CLI仅兼容Node.js 14.x、16.x版本,执行node -v查看当前Node.js版本,如果版本过高可使用nvm工具切换到兼容版本后重新安装CLI。
  • 步骤5:macOS/Linux权限问题处理
    不要使用sudo执行全局安装命令,可先将npm全局安装路径配置到当前用户目录下,避免权限不足导致执行文件未正确生成。

内容的提问来源于stack exchange,提问作者ashtrix-001

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.05 20:21:00