coze-power

Polar Sponsor
爱发电 赞助
.NET 9.0

将您的 Coze 机器人连接至本地机器能力。Coze 机器人运行在云端,无法访问本地文件、执行命令或控制您的设备——Coze-Power 通过一个轻量级 HTTP 服务器 + 兼容 Coze 的 OpenAPI 插件解决了这一问题。10 分钟即可完成配置:支持网页搜索、文件操作、命令执行、剪贴板访问、桌面通知等功能,更多能力持续扩展中。 适用于以下场景: - 您希望 Coze 机器人能够读写本地文件 - 您需要 Coze 机器人在本地机器上执行 shell 命令 - 您的 Coze 机器人需执行

Coze-Power:打通 Coze Bot 与本地能力的桥梁

概述

Coze Bot 功能强大,但运行于云端。它无法读取您的本地文件、执行终端命令,也无法直接与您的设备交互。Coze-Power 通过一个轻量级 HTTP 服务器解决这一问题——该服务器以标准 OpenAPI 接口形式暴露本地工具,供 Coze 插件调用。

架构

Coze-Power 架构图

快速上手(5 分钟)

1. 启动服务端

cd coze-power
python3 server.py
# 服务将在 http://localhost:8899 启动

2. 将其公开暴露(任选其一)

# 使用 ngrok(新手推荐)
ngrok http 8899
# → https://xxxx.ngrok.io  (复制该 URL)

# 或使用 Cloudflare Tunnel
cloudflared tunnel --url http://localhost:8899

3. 导入 Coze 插件

  1. 在 Coze Studio 中,进入 插件 → 创建插件
  2. 选择“从 OpenAPI 导入” → 上传 assets/openapi-spec.json
  3. Server URL 设置为您的 ngrok / Cloudflare URL(例如:https://xxxx.ngrok.io
  4. 添加 API 密钥认证:请求头名称为 X-API-Key,值来自您的 config.json
  5. 保存并启用该插件
  6. 将插件添加至您的 Coze Bot

4. 测试功能

在您的 Coze Bot 中尝试以下指令:

"搜索最新 AI 新闻"
"列出我桌面的文件"
"显示当前系统状态"

可用工具

工具方法端点描述
Web 搜索POST/tools/web-search搜索网络并返回结果
读取文件POST/tools/read-file读取本地文件内容
写入文件POST/tools/write-file向本地文件写入内容
列出目录POST/tools/list-dir列出指定目录下的文件
执行命令POST/tools/run-command执行 Shell 命令
系统信息POST/tools/system-info获取操作系统、CPU、内存等信息
读取剪贴板POST/tools/clipboard-read读取剪贴板内容
写入剪贴板POST/tools/clipboard-write向剪贴板写入内容
发送通知POST/tools/notify发送桌面通知
健康检查GET/health检查服务运行状态

配置

在技能目录下创建 config.json 文件:

{
  "api_key": "your-secret-api-key",
  "host": "0.0.0.0",
  "port": 8899,
  "allowed_commands": ["ls", "pwd", "cat", "echo", "python3", "node"],
  "allowed_paths": ["/home", "/tmp"],
  "max_file_size_kb": 1024
}

安全性

⚠️ 您正在将本地设备暴露至互联网。 请严格遵守以下规则:

  • 务必启用 API 密钥认证(切勿在无认证状态下运行)
  • 通过 allowed_commandsallowed_paths 限制可访问的命令与路径
  • 生产环境建议:使用 ngrok 提供 HTTPS(自动启用 TLS)
  • 严禁在未启用认证的情况下暴露此服务
  • 建议在 Docker 容器中运行以实现隔离

Coze 插件配置(详细步骤)

详见 references/coze-plugin-setup.md 中的 Coze 配置分步指南。

示例

详见 references/examples.md 中真实的 Coze Bot 提示词及预期行为。

API 参考文档

详见 references/api-reference.md 中完整的接口文档说明。

Coze-Power:打通 Coze Bot 与本地能力的桥梁

概述

Coze Bot 功能强大,但运行于云端。它无法读取您的本地文件、执行终端命令,也无法直接与您的设备交互。Coze-Power 通过一个轻量级 HTTP 服务器解决这一问题——该服务器以标准 OpenAPI 接口形式暴露本地工具,供 Coze 插件调用。

架构

Coze-Power 架构图

快速上手(5 分钟)

1. 启动服务端

cd coze-power
python3 server.py
# 服务将在 http://localhost:8899 启动

2. 将其公开暴露(任选其一)

# 使用 ngrok(新手推荐)
ngrok http 8899
# → https://xxxx.ngrok.io  (复制该 URL)

# 或使用 Cloudflare Tunnel
cloudflared tunnel --url http://localhost:8899

3. 导入 Coze 插件

  1. 在 Coze Studio 中,进入 插件 → 创建插件
  2. 选择“从 OpenAPI 导入” → 上传 assets/openapi-spec.json
  3. Server URL 设置为您的 ngrok / Cloudflare URL(例如:https://xxxx.ngrok.io
  4. 添加 API 密钥认证:请求头名称为 X-API-Key,值来自您的 config.json
  5. 保存并启用该插件
  6. 将插件添加至您的 Coze Bot

4. 测试功能

在您的 Coze Bot 中尝试以下指令:

"搜索最新 AI 新闻"
"列出我桌面的文件"
"显示当前系统状态"

可用工具

工具方法端点描述
Web 搜索POST/tools/web-search搜索网络并返回结果
读取文件POST/tools/read-file读取本地文件内容
写入文件POST/tools/write-file向本地文件写入内容
列出目录POST/tools/list-dir列出指定目录下的文件
执行命令POST/tools/run-command执行 Shell 命令
系统信息POST/tools/system-info获取操作系统、CPU、内存等信息
读取剪贴板POST/tools/clipboard-read读取剪贴板内容
写入剪贴板POST/tools/clipboard-write向剪贴板写入内容
发送通知POST/tools/notify发送桌面通知
健康检查GET/health检查服务运行状态

配置

在技能目录下创建 config.json 文件:

{
  "api_key": "your-secret-api-key",
  "host": "0.0.0.0",
  "port": 8899,
  "allowed_commands": ["ls", "pwd", "cat", "echo", "python3", "node"],
  "allowed_paths": ["/home", "/tmp"],
  "max_file_size_kb": 1024
}

安全性

⚠️ 您正在将本地设备暴露至互联网。 请严格遵守以下规则:

  • 务必启用 API 密钥认证(切勿在无认证状态下运行)
  • 通过 allowed_commandsallowed_paths 限制可访问的命令与路径
  • 生产环境建议:使用 ngrok 提供 HTTPS(自动启用 TLS)
  • 严禁在未启用认证的情况下暴露此服务
  • 建议在 Docker 容器中运行以实现隔离

Coze 插件配置(详细步骤)

详见 references/coze-plugin-setup.md 中的 Coze 配置分步指南。

示例

详见 references/examples.md 中真实的 Coze Bot 提示词及预期行为。

API 参考文档

详见 references/api-reference.md 中完整的接口文档说明。

相关专题

更多
Aionclaw智能助手介绍
Aionclaw智能助手介绍

本专题汇总了AionClaw(AI龙虾助手)的功能介绍与在线使用入口。AionClaw是杭州趣猿人工智能有限公司推出的桌面级AI智能体,能直接在电脑上读写文件、运行脚本、操作浏览器,自动交付Word、PPT、Excel等成品。

2026.09.20

0

13

AionClaw AI智能体与电脑自动化任务执行功能使用教程
AionClaw AI智能体与电脑自动化任务执行功能使用教程

AionClaw专题整理AI智能体与电脑自动化相关功能使用教程,涵盖安装部署、AI任务执行、Skills技能、文件处理、浏览器控制、电脑操作、持久记忆、聊天工具连接以及办公、编程和内容创作等功能,帮助用户快速掌握AionClaw的实际使用方法。

2026.09.20

0

15

AI视频生成软件推荐
AI视频生成软件推荐

本专题汇总了当前主流的AI视频生成软件推荐与排行榜单,涵盖seko、AniShort、剧云、Lovart、LiblibAI及立刻mv等热门工具。同时整理了各软件在文生视频、图生视频、时长限制、画质表现及免费额度等方面的差异对比,助您快速选对适合创作需求的AI视频生成工具。

2026.09.16

0

9

ai生成视频的工具免费版合集
ai生成视频的工具免费版合集

本专题汇总了当前免费AI生成视频工具的排行榜与推荐清单,涵盖seko、讯飞智作、AniShort及剧云、Lovart等多模型集成平台。同时整理了各工具的免费额度、输出时长、水印政策及适用场景差异,助您快速选择合适工具开启AI视频创作。

2026.09.16

0

10

Pandas时间序列分析与可视化报表
Pandas时间序列分析与可视化报表

本专题整理Pandas日期转换、时间索引、重采样、滚动窗口、时区处理、plot绘图、Styler表格样式和报表输出方法。

2026.09.16

0

23

Pandas数据筛选索引与清洗处理
Pandas数据筛选索引与清洗处理

本专题整理Pandas中的loc、iloc、条件筛选、query查询、缺失值处理、重复值删除、类型转换和字符串列清洗方法。

2026.09.16

0

25

Pandas数据读取导入与文件导出处理
Pandas数据读取导入与文件导出处理

本专题整理Pandas读取CSV、Excel、JSON、SQL、Parquet等文件的方法,以及to_csv、to_excel、to_sql和to_parquet等常用数据导出流程。

2026.09.16

0

27

GDB怎么设置断点
GDB怎么设置断点

本专题介绍GDB按照函数名、源代码行号和文件位置设置断点的方法,详细说明run、continue、next、step等命令的配合使用,帮助定位程序崩溃、逻辑异常及代码未按预期执行的问题。

2026.09.11

0

28

GDB怎么查看变量值
GDB怎么查看变量值

本专题介绍GDB调试过程中查看变量值的具体方法,涵盖局部变量、函数参数、数组、结构体和指针内容查询,同时整理变量持续显示、格式化输出及无法读取变量时的排查思路。

2026.09.11

0

22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.6万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 133万人学习