能力标签

🔌 MCP 🤖 Agent 🔄 工作流 🌐 翻译 🐳 Docker 💻 CLI 🔗 REST API 🧠 Claude ✨ GPT 🖥 本地 LLM

⚙️

Agent工作流

Pikiclaw AI工作流

基于 TypeScript · 无代码搭建完整 AI 自动化流程

英文名：pikiclaw

⭐ 263 Stars 🍴 30 Forks 💻 TypeScript 📄 MIT 🏷 AI 7.8分

7.8AI 综合评分

AI工作流Claude集成CLI工具开源

⬇ 下载源码 ZIP ⚙️ 配置说明

✦ AI Skill Hub 推荐

Pikiclaw AI工作流是 AI Skill Hub 本期精选Agent工作流之一。综合评分 7.8 分，整体质量较高。我们推荐使用将其纳入你的 AI 工具库，帮助提升工作效率。

📚 深度解析

Pikiclaw AI工作流是一套完整的 AI Agent 自动化工作流方案。随着 AI 能力的不断提升，基于 Agent 的自动化工作流正在成为提升个人和团队效率的核心方式。区别于传统的 RPA 自动化（模拟鼠标键盘操作），AI Agent 工作流通过理解任务意图、动态规划执行路径，能够处理更复杂的非结构化任务。

Pikiclaw AI工作流工作流的设计遵循"最小配置，最大复用"原则：核心逻辑已经封装好，用户只需配置自己的 API Key 和业务参数即可快速上手。工作流内置错误处理和重试机制，在网络波动或 API 限速等情况下仍能稳定运行，适合作为生产环境的自动化基础设施。

在实际部署时，建议先在测试环境中运行 3-5 次，验证各个环节的输出结果符合预期，再部署到生产环境。AI Skill Hub 评分 7.8 分，是同类 Agent 工作流中的精选推荐。

📋 工具概览

Pikiclaw AI工作流是一套完整的 AI Agent 自动化工作流方案。通过可视化的节点编排，将复杂的多步骤任务拆解为清晰的自动化流程，实现全程无人值守的智能处理。支持与数百种外部服务和 API 无缝集成，适合构建数据处理管线、业务自动化和 AI 辅助决策系统。

GitHub Stars

⭐ 263

开发语言

TypeScript

支持平台

Windows / macOS / Linux

维护状态

轻量级项目，按需更新

开源协议

MIT

AI 综合评分

7.8 分

工具类型

Agent工作流

Forks

📖 中文文档

以下内容由 AI Skill Hub 根据项目信息自动整理，如需查看完整原始文档请访问底部「原始来源」。

📌 核心特色

可视化 Agent 工作流编排，无需编写复杂代码
支持多步骤自动化任务链，实现全流程无人值守
与外部 API、数据库和第三方服务无缝集成
内置错误处理与自动重试机制，保障稳定运行
提供可复用的自动化模板，快速在同类场景部署

🎯 主要使用场景

自动化日常重复性工作，将精力集中于创造性任务
构建数据采集 → 处理 → 输出的完整自动化管线
实现跨平台、跨系统的数据流转和业务协同

以下安装命令基于项目开发语言和类型自动生成，实际以官方 README 为准。

安装命令

# 方式一：npm 全局安装
npm install -g pikiclaw

# 方式二：npx 直接运行（无需安装）
npx pikiclaw --help

# 方式三：项目依赖安装
npm install pikiclaw

# 方式四：从源码运行
git clone https://github.com/xiaotonng/pikiclaw
cd pikiclaw
npm install
npm start

📋 安装步骤说明

访问 GitHub 仓库获取工作流文件
在对应平台（Dify / Flowise / Make 等）中找到「导入工作流」功能
上传工作流文件
按照提示配置必要的环境变量和 API Key
运行测试确认流程正常后投入使用

以下用法示例由 AI Skill Hub 整理，涵盖最常见的使用场景。

常用命令 / 代码示例

# 命令行使用
pikiclaw --help

# 基本用法
pikiclaw [options] <input>

# Node.js 代码中使用
const pikiclaw = require('pikiclaw');

const result = await pikiclaw.run(options);
console.log(result);

以下配置示例基于典型使用场景生成，具体参数请参照官方文档调整。

配置示例

# pikiclaw 配置说明
# 查看配置选项
pikiclaw --config-example > config.yml

# 常见配置项
# output_dir: ./output
# log_level: info
# workers: 4

# 环境变量（覆盖配置文件）
export PIKICLAW_CONFIG="/path/to/config.yml"

📑 README 深度解析真实文档完整度 56/100 查看 GitHub 原文 →

以下内容由系统直接从 GitHub README 解析整理，保留代码块、表格与列表结构。

简介

Core Features

Quick Start

Prerequisites: Node.js 20+, plus at least one official Agent CLI installed and authenticated on your system:

claude (Claude Code)
codex (Codex CLI)
gemini (Gemini CLI)
hermes (Hermes — via ACP / Agent Client Protocol)

Launch:

cd your-workspace
npx pikiclaw@latest

This instantly opens the Web Dashboard at http://localhost:3939. From there, you can drive sessions in the browser, connect IM channels, configure agents and models, install MCP servers and skills, and manage system permissions. Everything else is just one click away.

<details> <summary><b>Prefer the terminal? We have a setup wizard.</b></summary>

npx pikiclaw@latest --setup    # Interactive terminal setup wizard
npx pikiclaw@latest --doctor   # Environment health check only

</details>

<details> <summary><b>Want to run it on a server? Docker is supported.</b></summary>

docker run -d --name pikiclaw -p 3939:3939 \
  -e TELEGRAM_BOT_TOKEN=... \
  -e ANTHROPIC_API_KEY=sk-ant-... \
  -v pikiclaw-config:/home/piki/.pikiclaw \
  -v pikiclaw-workspace:/workspace \
  ghcr.io/xiaotonng/pikiclaw:latest

The official multi-arch image (linux/amd64 + linux/arm64) bakes in claude-code, codex, and gemini-cli. A docker-compose.yml example ships in the repo root — see docs/DOCKER.md for the full reference (auth flows, volume layout, reverse-proxy / TLS, pinning agent CLI versions).

</details>

---

Configuration

Persistent Configuration: ~/.pikiclaw/setting.json stores your channels, agents, Providers/Profiles, workspaces, and MCP extensions.
The Dashboard is the primary UI for configuration. The terminal wizard (--setup) and the doctor script (--doctor) are available for headless or CLI-first users.
Global MCP extensions are stored under the extensions.mcp key in the setting file.
Workspace MCP extensions follow standard conventions and are read from .mcp.json in the project root.
Project skills are loaded automatically from .pikiclaw/skills/*/SKILL.md (and we also support legacy .claude/commands/*.md formats).

Computer-Use Toggles (managed via the Extensions dashboard):

browserEnabled — Enables managed Chrome (Playwright). Upon first use, pikiclaw creates a dedicated profile in ~/.pikiclaw and reuses it for subsequent sessions. Log in once, and never scan a QR code or enter a password for those tools again.
peekabooEnabled — Enables macOS desktop automation (Peekaboo). Available on macOS only. Activating this launches @steipete/peekaboo's peekaboo-mcp binary and injects its UI-controlling tools. Note: You must grant your terminal Accessibility and Screen Recording permissions in System Settings → Privacy & Security before enabling this.

---

Command Reference

Command	Description
`/start`	View entry info, the active agent, and your working directory
`/sessions`	View, switch, or create new sessions
`/agents`	Switch the active Agent (Claude · Codex · Gemini · Hermes)
`/models`	View and switch the model or reasoning effort for the session
`/mode`	Toggle plan mode / reasoning effort
`/switch`	Browse and switch the working directory
`/workspaces`	Pick a saved workspace from the Dashboard's quick-pick list
`/goal`	Set or inspect a long-running, self-terminating session goal
`/stop`	Force-stop the current session
`/status`	Check runtime status, token usage, resource consumption, and session info
`/host`	Monitor host CPU, memory, disk, and battery levels
`/skills`	Browse available project skills
`/ext`	View the extensions overview
`/restart`	Restart and re-launch the underlying Bot service
`/sk_<name>`	Instantly run a specific project skill