如何安装 Composio CLI、完成登录并执行第一次工具搜索与调用

如何安装 Composio CLI、完成登录并执行第一次工具搜索与调用【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composioComposio CLI 让你在终端里直接完成三件事搜索 Composio 平台上的工具、连接应用账号、执行工具调用不需要先搭 SDK 应用或配置 MCP。这篇文章覆盖一条完整的初始路径在一台受支持的机器上安装composio命令、完成浏览器登录、执行第一次composio search和第一次composio execute。主要依据是仓库中的 CLI 文档、INSTALL.md 和 CLI 包 README。准备条件确认平台受支持安装器支持以下平台来源INSTALL.md 的 Supported platforms 一节Linux x64Linux ARM64macOS IntelmacOS Apple SiliconWindows需要在 WSL 里安装并运行安装器确认系统在内列范围内后就可以执行安装。安装 CLI用一条命令安装curl -fsSL https://composio.dev/install | sh安装器的行为来源docs/content/docs/cli.mdx 的 Install 一节把完整 CLI 包下载到~/.composio并在~/.local/bin/composio创建入口点根据$SHELL识别zsh、bash、fish向对应的启动文件写入一个受管理的# Composio CLIPATH 块让之后的终端能在PATH里找到composio。bash 还会额外配置一个 login 模式启动文件~/.bash_profile或~/.bash_login中先存在的那个都不存在则新建~/.bash_profile因为 login bashmacOS Terminal.app 启动的 shell不会读~/.bashrc默认不安装 agent 插件也不登录除非你显式要求。官方发行版会先做 SHA-256 校验校验清单缺失、没有对应平台条目、条目格式错误或与checksums.txt不匹配时安装会以Refusing to install中止。系统上既没有sha256sum也没有shasum时安装器会打印警告并跳过校验继续。可选跳过 shell 配置或固定版本在 CI、Docker 镜像或启动文件由 dotfile 工具管理的场景用COMPOSIO_INSTALL_SHELLnone做一个只安装、不改 shell 文件的运行curl -fsSL https://composio.dev/install | COMPOSIO_INSTALL_SHELLnone sh也可以强制指定 shellzsh、bash、fish或用COMPOSIO_INSTALL_VERSION/ 位置参数固定版本位置参数优先于COMPOSIO_INSTALL_VERSIONcurl -fsSL https://composio.dev/install | sh -s -- composio/cli0.3.1这些变量和默认值的完整列表见 INSTALL.md 中的参数表。验证安装安装完成后打开一个新终端启动文件只在之后的终端生效然后运行composio --version which composio如果 shell 没被识别或 shell 配置失败CLI 仍然会装上但安装器会打印一条可直接运行的命令绝对路径在当前终端用该路径运行即可。完成登录composio login登录行为来源docs/content/changelog/03-13-26-cli-improvements.mdx默认流程是浏览器 OAuth完成后会弹出交互式选择器让你选默认组织和项目只有一个组织和项目时会自动选中composio login -y跳过选择器、直接使用会话默认值适合脚本或 CIcomposio login --no-browser只打印登录 URL、不打开浏览器适合无图形界面的环境注意--api-key、--org-id、--project-id等 flag 已从composio login中移除非交互场景请使用浏览器流程加-y。登录身份保存在~/.composio的user_data.json中可通过COMPOSIO_CACHE_DIR环境变量改位置见 CLI 包 README 的 Configuration 一节。用下面命令确认当前登录用户composio whoamiwhoami的输出不再显示 API key改为提示composio manage orgs switch等后续操作。第一次工具搜索用自然语言描述任务即可搜索工具以下查询是文档原例composio search summarize my unread gmailsearch支持--toolkits toolkit限定工具集、--limit integer限制条数、--human输出具体以composio search --help full为准命令列表来源ts/packages/cli/README.md。搜索结果里会给出工具的 slug后续link和execute都依赖它。连接应用并执行第一次调用如果目标工具所属的 toolkit 还没有连接账号先连接来源CLI 文档 的 Search, connect, and execute tools 一节以下均为文档示例# 连接应用账号默认打开浏览器并等待账号变为 ACTIVE composio link gmailcomposio link默认打开浏览器并等待连接完成--no-wait则打印跳转 URL 和 JSON 后立即退出供脚本使用。查看目标工具的入参 schema确认需要哪些字段composio execute GMAIL_FETCH_EMAILS --get-schema然后执行工具-d传 JSON 参数下面这条是文档示例命令参数含义以--get-schema的返回为准composio execute GMAIL_FETCH_EMAILS \ -d { query: is:unread newer_than:1d, max_results: 10 }执行成功的判断命令返回工具的执行结果工具输出本身即结果文档未给出固定的成功日志格式。如果提示需要连接回到composio link toolkit完成授权后再重试。常见问题与限制新终端找不到composio启动文件的 PATH 修改只影响之后的终端。要么打开新终端要么用安装器打印的绝对路径命令。安装时输出Refusing to installSHA-256 校验未通过见上文安装一节不要绕过校验手动执行。shell 不受支持安装器不识别$SHELL时仍会完成二进制安装并打印一条可运行命令也可以显式设置COMPOSIO_INSTALL_SHELL指定或跳过 shell 配置。不要基于 CLI 构建生产集成文档明确提示 CLI 处于持续开发中不提供应用运行时层面的 SLA 承诺需要稳定集成时应基于 Composio SDK 和 API来源CLI 文档 的 Building on top of the CLI 提示框。升级composio upgrade会原地替换~/.composio中的包入口点~/.local/bin/composio保持不变可传版本号固定发行版如composio upgrade 0.3.1或加--beta取最新预发布。下一步任意命令加--help full查看完整帮助例如composio execute --help full、composio dev --help full如果你使用 Codex 或 Claude Code可以用composio setup --target auto安装对应的原生插件非交互环境加--yes插件会教 agent 使用composio search、composio link、composio execute详见 Agent plugins 文档需要在项目、auth config、日志、触发器等开发者平台上调试时使用composio dev子命令组composio dev init、composio dev logs tools等命令清单见 CLI 文档 的 Build on the Composio platform 一节。【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考