AI 助手
扣子 AI 帮助与支持
你好，我是 扣子 文档问答助手 🎉
你在阅读当前文档的过程中，无论对文档概念的解释，还是文档内容方面的疑问，都可以随时向我提问，我会全力为你解答
推荐问题
如何快速了解这个空间的核心内容？
有哪些近期更新的重点文档？
我应该从哪些文档开始阅读？
文档反馈
如果你已经在本地电脑上部署了 Agent，可以将它接入扣子，用扣子进行对话管理和操作。
扣子只提供对话入口，Agent 本身仍运行在你自己电脑上，不会迁移到云端。
什么是本地 Agent
在扣子上创建本地 Agent，可以将你电脑上已经安装的 Agent 接入扣子，包括 Claude Code、Codex CLI、基于 OpenClaw 开源框架的各类 Agent。接入后，你可以在扣子中直接和它对话，让它处理本机文件、操作本机软件，或读取、修改和运行本地代码项目。
扣子提供对话入口和协作管理，实际任务仍由你电脑上的本地 Agent 执行。你的本地 Agent 不会被迁移到云端。
接入后可以做什么？
如果你已经在本地部署 Claude Code、Codex CLI、OpenClaw，接入扣子后可以解锁两种新的使用方式：
- 随时随地操作本地 Agent：原本这些 Agent 部署在本地终端，你需要在电脑前才能使用。接入扣子后，只要终端保持在线，你就可以通过手机给本地 Agent 下指令，在不方便打开电脑时也能推进工作。例如：
- 出门在外时，用手机让本地 Agent 查看电脑里的 Excel 文件，并帮你提取某个数据。
- 在路上想到代码问题，让本地 Claude Code 查看本地仓库，定位可能原因。
- 需要处理本机软件信息时，让本地 Agent 打开浏览器、飞书等应用，完成查询或操作。
- 拉入项目，团队共同指挥本地 Agent：将本地 Agent 添加到项目后，项目内所有成员均可 @ 它下达指令。例如：
- 开发者在本地通过 Claude Code 开发代码，那么将本地 Claude Code 拉入扣子项目后，产品经理等人员可以直接 @ 它询问开发进展。
- 一个 Agent 负责编写代码，另一个 Agent 负责审核代码。比如让本地 Codex CLI 完成实现，再让 Claude Code Agent 审查代码，并给出修改建议。
怎么接入
接入本地 Agent 的核心是在你的电脑上安装并运行一个轻量程序 coze-bridge。它负责在扣子和你电脑上的本地 Agent 之间建立连接。
coze-bridge 会识别你电脑上已安装并支持接入的 Agent，包括 OpenClaw、Claude Code、Codex CLI。连接建立后，你在扣子中发送指令，本地 Agent 会在你的电脑上执行任务，并把结果通过扣子对话返回给你。
本地终端对话和扣子中的对话属于不同的会话，对话内容不同步。
注意
为保证本地 Agent 正常在线，请在使用期间保持 coze-bridge 进程运行，并建议开启盒盖不休眠。电脑关机、断网、进入休眠状态，或 coze-bridge 进程停止运行，本地 Agent 与扣子的连接会断开。
如果断开连接，你可以重新运行连接命令来恢复连接。具体操作，请参考本地 Agent 连接掉线了，怎么处理？。
注意事项
- 如果将本地 Agent 加入项目，相关配置仍需在 Agent 设置页面中完成；项目内不提供 Agent 设置入口。
- 如果在 Agent 设置中切换了模型，新模型仅对后续新建项目生效，已创建项目中的模型不会同步变更。
- 接入扣子本身不会出现 Claude 等账号封号风险，风险主要来自你本地配置的账号、Token、调用方式和使用强度。
- 如果本地 Agent 继续使用Claude、OpenAI、OpenClaw 配置，需注意：
- 请求仍受原服务方条款、限流、计费和风控影响。
- 多人共享个人账号、代跑账号、高频自动化、长期无人值守批量调用，可能增加风控风险。
- 接入扣子不代表可以规避服务方限制，也不承诺降低封号风险。
套餐权益
不同套餐支持接入的本地 Agent 数量不同。
|
套餐权益 |
个人免费版 |
个人进阶版 |
个人高阶版 |
个人旗舰版 |
个人尊享版 |
团队高阶版 |
团队旗舰版 |
团队尊享版 |
企业标准版 |
企业旗舰版 |
|---|---|---|---|---|---|---|---|---|---|---|
|
连接本地 Agent 数量 |
1个 |
1个 |
3个 |
10个 |
不限制 |
每个成员3个 |
每个成员10个 |
不限制 |
不限制 |
不限制 |
前提条件
在接入本地 Agent 前，请先在本地电脑中安装 OpenClaw、Claude Code CLI、Codex CLI。相关安装说明请参考：
- OpenClaw：请参考 Install OpenClaw。
- Claude Code CLI：请参考Install Claude Code CLI。
- Codex CLI：请参考Install Codex CLI。
接入步骤
你可以参考如下步骤，接入本地 Agent。
- 在扣子的对话列表中，单击➕ > 新建 Agent。
- 在新建 Agent 面板中，单击接入本地 Agent。
- 单击复制命令，复制系统生成的本地连接命令。
命令中 token 有效期为 60 分钟，请复制后，在 60 分钟内执行命令，完成配对。超过有效期后，请重新生成连接命令。
- 打开本地终端，执行连接命令。
回显信息为已配对连接完成，请返回到 coze 平台上点击 "我已执行"，则表示执行成功，本地已与扣子云端连接。 - 返回扣子，单击已粘贴执行，系统开始识别本地 Agent。
- 创建 Agent。
识别成功后，你可以设置 Agent 名称，然后单击创建 Agent。
创建完成后，你就可以在扣子中与该本地 Agent 对话。
- 在扣子 App 顶部，单击➕ > 新增 Agent。
- 在新建 Agent 面板中，单击接入本地 Agent。
- 单击复制命令，复制系统生成的本地连接命令。
命令中 token 有效期为 60 分钟，请复制后，在 60 分钟内执行命令，完成配对。超过有效期后，请重新生成连接命令。
- 打开本地终端，执行连接命令。
回显信息为已配对连接完成，请返回到 coze 平台上点击 "我已执行"，则表示执行成功，本地已与扣子云端连接。 - 返回扣子，单击已粘贴执行，系统开始识别本地 Agent。
- 创建 Agent。
识别成功后，你可以设置 Agent 名称，然后单击创建 Agent。
创建完成后，你就可以在扣子中与该本地 Agent 对话。
简单使用
接入本地 Agent 后，你可以直接在扣子中使用对应的本地 Agent，并用自然语言描述你想完成的任务。
团队共用 Claude
在扣子项目中，所有成员可以共用一个本地 Claude，协助完成任务。例如开发者在本地通过 Claude Code 开发代码，那么将本地 Claude Code 拉入扣子项目后，产品经理、测试、运营等其他成员，可以直接在项目会话里 @ 它，询问开发进展、了解功能状态。
示例指令
博客网页这个项目开发完成了吗？你是基于什么语言开发的？
远程任务
当你不在电脑旁边，但需要使用本地 Claude Agent 帮你生成图片时，可以通过扣子远程下达指令。只要本地终端保持在线，本地 Claude Agent 就可以继续在你的电脑环境中执行任务。
例如，你在手机上想到一张运营配图创意，可以直接在扣子里 @ 本地 Claude Agent，让它根据你的描述生成图片，而不需要回到电脑前操作。
请帮我生成一张小红书封面图，主题是“春季护肤新品”，风格清新明亮，画面中包含护肤品、花朵和浅色背景。帮忙发送到群里。