★ FEATURED ARTICLE 【免费下载链接】takopihe just wants to help-pi!项目地址https://gitcode.com/gh_mirrors/ta/takopi点击查看免费下载Takopi 是一款 Telegram 桥接 AI 编码 Agent 的工具它把 Codex、Claude Code、OpenCode、Pi 这些 AI 编码引擎接入你的 Telegram让你随时随地发出第一个编码任务并实时观看 AI Agent 读文件、调用工具、改代码的全过程。本文用 10 分钟带你完成安装到跑通第一个任务的全部流程。一、3分钟安装Takopiuv Agent CLI 一键配置Takopi 本身只是一个指挥官真正干活的是你机器上已安装的 Agent CLI。安装分三步步骤命令说明1curl -LsSf https://astral.sh/uv/install.sh \| sh安装 Python 包管理器uv2uv python install 3.14Takopi 需要 Python 3.143uv tool install -U takopi安装 Takopi然后再装至少一个 AI 编码引擎任选其一即可已有的订阅可直接复用Codexnpm install -g openai/codex复用 ChatGPT 订阅Claude Codenpm install -g anthropic-ai/claude-code复用 Claude 订阅OpenCodenpm install -g opencode-ailatestPinpm install -g mariozechner/pi-coding-agent装完后用takopi --version验证看到版本号就说明成功了。 详细安装说明见 docs/tutorials/install.md二、运行引导向导4步创建Telegram机器人在项目目录里直接运行takopi首次运行会自动进入交互式配置向导只需回答 4 个问题Bot Token回答n后会提示你到 Telegram 找 BotFather 发送/newbot创建机器人拿到形如123456789:ABC...的 token 粘贴回来选择工作流新手直接选assistant持续聊天 自动续接官方推荐团队多项目可选 workspace连接聊天在 Telegram 里给你的 bot 发一个/start终端会显示捕获到的chat_id选择默认引擎Takopi 会自动扫描你 PATH 上装了哪些 Agent CLI选一个即可。确认保存到~/.takopi/takopi.toml后向导结束Takopi 即刻开始监听消息。⚠️ 记住bot token 拿到手的人都能控制你的机器人切勿提交到 git 或公开分享。三、发出第一个编码任务cd ~/dev/your-project takopi启动后 Takopi 会在终端常驻并在 Telegram 里发一条 takopi is ready的就绪消息告诉你默认引擎、可用引擎和工作目录。关键认知Takopi 在你启动它的目录干活。Agent 只能看到当前目录里的文件想换项目就先CtrlC停掉到新目录重新启动。现在打开 Telegram给机器人发一条消息explain what this repo does解释一下这个仓库是做什么的就这么简单——你的第一个编码任务已发出。四、实时观看AI Agent干活进度流是最大亮点这是 Takopi 最爽的地方。Agent 一开始工作bot 就会发一条进度消息并原地实时编辑你可以像看直播一样看到它干活的每一步starting · codex · 0s—— 任务启动计时开始working · codex · 12s · step 3—— 已完成 3 步下面逐条列出它调用的工具例如✓ tool: read: readme.md、✓ tool: read: src/takopi/runner.pydone · codex · 11s · step 5—— 干完了最终答案以新消息推送保证你会收到通知包含完整的任务结果。命令执行、工具调用、文件变更、耗时全部一目了然。这套进度渲染逻辑的源码在 src/takopi/telegram/render.py引擎事件解析在 src/takopi/runners/ 目录下感兴趣可以深入阅读。五、继续对话、取消任务三个核心命令继续对话assistant 模式下无需任何操作直接再发一条消息即可自动续接上下文比如now add tests for the API现在给 API 加测试。想从头开始就发/new。取消任务看到 Agent 跑偏了在进度消息上点cancel按钮或回复/cancelTakopi 会立即终止进程。切换引擎想临时换个 AI Agent在消息开头加引擎前缀即可/claude explain the error handling in this codebase这一条消息就会改用 Claude Code 执行回复也会自动跟随该引擎。用/agent set claude可以把某个引擎设为当前聊天的默认值。完整命令表见 docs/reference/commands-and-directives.md六、常见问题快速排查症状原因与解法进度卡在 startingAgent 可能在扫描大仓库稍等或/cancel后换个更具体的提问提示找不到引擎 CLI对应引擎没装或不在 PATH 里按第一节命令补装bot 完全没反应确认终端里 Takopi 还在运行、且 Telegram 收到过 is ready 消息报错error: already running一个 token 只能跑一个实例停掉旧进程或删除~/.takopi/takopi.lock更多排错内容见 docs/how-to/troubleshooting.md 和 docs/tutorials/first-run.md。七、下一步把Takopi变成多项目管理器跑通第一个任务后推荐继续探索这些能力注册项目takopi init happy-gadgets之后在任何聊天里用/happy-gadgets 任务远程指挥worktree 分支隔离消息里带上feat/xxxAgent 会在独立 git worktree 里干活文件传输/file get、/file put直接在聊天里收发货代码文件配置文件所有行为都可通过takopi config list / get / set查看与修改完整参考见 docs/reference/config.md。现在打开 Telegram发出一条消息看看你的 AI Agent 是怎么干活的吧 赞分享【免费下载链接】takopihe just wants to help-pi!项目地址https://gitcode.com/gh_mirrors/ta/takopi点击查看免费下载相关推荐快速上手Agent Orchestrator15分钟跑通第一个编码Agent任务快速上手Agent Orchestrator15分钟跑通第一个编码Agent任务 Agent Orchestrator简称 AO是一款开源的 编码Agen快速上手Gas City3步创建你的第一个City并派发AI编程任务快速上手Gas City3步创建你的第一个City并派发AI编程任务 Gas City 是一个面向多智能体编码工作流的编排 SDKOrchestrationTaskflow 10行代码上手快速写出第一个高性能任务并行程序Taskflow 10行代码上手快速写出第一个高性能任务并行程序 Taskflow 是一款通用的 C 任务并行编程系统 task parallel pr高性能计算并发编程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
