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

cd coze-power python3 server.py # 服务将在 http://localhost:8899 启动
# 使用 ngrok(新手推荐) ngrok http 8899 # → https://xxxx.ngrok.io (复制该 URL) # 或使用 Cloudflare Tunnel cloudflared tunnel --url http://localhost:8899
assets/openapi-spec.jsonhttps://xxxx.ngrok.io)X-API-Key,值来自您的 config.json在您的 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
}⚠️ 您正在将本地设备暴露至互联网。 请严格遵守以下规则:
allowed_commands 和 allowed_paths 限制可访问的命令与路径详见 references/coze-plugin-setup.md 中的 Coze 配置分步指南。
详见 references/examples.md 中真实的 Coze Bot 提示词及预期行为。
详见 references/api-reference.md 中完整的接口文档说明。
Coze Bot 功能强大,但运行于云端。它无法读取您的本地文件、执行终端命令,也无法直接与您的设备交互。Coze-Power 通过一个轻量级 HTTP 服务器解决这一问题——该服务器以标准 OpenAPI 接口形式暴露本地工具,供 Coze 插件调用。

cd coze-power python3 server.py # 服务将在 http://localhost:8899 启动
# 使用 ngrok(新手推荐) ngrok http 8899 # → https://xxxx.ngrok.io (复制该 URL) # 或使用 Cloudflare Tunnel cloudflared tunnel --url http://localhost:8899
assets/openapi-spec.jsonhttps://xxxx.ngrok.io)X-API-Key,值来自您的 config.json在您的 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
}⚠️ 您正在将本地设备暴露至互联网。 请严格遵守以下规则:
allowed_commands 和 allowed_paths 限制可访问的命令与路径详见 references/coze-plugin-setup.md 中的 Coze 配置分步指南。
详见 references/examples.md 中真实的 Coze Bot 提示词及预期行为。
详见 references/api-reference.md 中完整的接口文档说明。