AI公司日常运营手册:用Paperclip管理你的Agent团队

作者:

当 AI Agent 成为你的员工,如何管理这家公司?

前言

想象一下:你开了一家公司,员工全是 AI Agent。CEO 负责制定战略,CTO 负责技术决策,工程师负责写代码,设计师负责做图。它们 24 小时不休息,不需要工资(只需要 API 费用),永远高效。

这就是 Paperclip 的愿景——AI Agent 公司

本文将介绍如何日常运营这样一家公司。


一、公司组织架构

1.1 推荐的组织架构

`

┌─────────┐

│ CEO │

│ (战略) │

└────┬────┘

┌──────────────┼──────────────┐

│ │ │

┌─────┴─────┐ ┌─────┴─────┐ ┌─────┴─────┐

│ CTO │ │ 产品 │ │ 市场 │

│ (技术) │ │ (规划) │ │ (推广) │

└─────┬─────┘ └───────────┘ └───────────┘

┌─────┴─────┐

│ 工程师 │

│ (执行) │

└───────────┘

`

1.2 角色定义

角色 职责 推荐 Agent

|——|——|———–|

CEO 制定战略、分配任务、审核成果 Hermes Agent
CTO 技术决策、代码审核、架构设计 Claude Code
工程师 编写代码、修复 Bug、实现功能 OpenClaw / Codex
设计师 生成图片、设计 UI、制作 PPT Hermes Agent + ComfyUI
运营 内容创作、数据分析、用户运营 Hermes Agent

二、日常运营流程

2.1 每日启动流程

`bash

# 1. 检查所有 Agent 状态

npx paperclipai agent list –company-id

# 2. 检查健康状态

curl http://localhost:3100/api/health

# 3. 查看待处理 Issue

npx paperclipai issue list –status backlog,todo,in_progress

# 4. 手动触发 CEO 的 Heartbeat(如果需要)

npx paperclipai agent heartbeat:invoke

`

2.2 任务分配流程

方式一:通过 CLI 创建 Issue

`bash

# 创建一个新任务

npx paperclipai issue create

–company-id

–payload-json ‘{

“title”: “开发用户登录功能”,

“body”: “实现 OAuth2.0 登录,支持 Google 和 GitHub”,

“priority”: “high”,

“assigneeAgentId”: “”

}’

`

方式二:通过 Web UI 创建

  1. 打开 http://localhost:3100
  2. 点击 “Issues” → “New Issue”
  3. 填写标题、描述、优先级
  4. 分配给对应的 Agent

方式三:让 CEO 自动分配

CEO Agent 在 Heartbeat 时会自动:

  1. 检查待处理的 Issue
  2. 根据优先级和 Agent 能力分配任务
  3. 通知对应的 Agent 开始工作

2.3 任务执行流程

`

Issue 创建 → 分配给 Agent → Agent 执行 → 完成标记 → 审核确认

│ │ │ │ │

▼ ▼ ▼ ▼ ▼

backlog todo in_progress done approved

`

Agent 执行任务时会:

  1. 读取 Issue 详情
  2. 使用工具完成任务(写代码、调用 API 等)
  3. 标记 Issue 为 “done”
  4. 发布完成评论

三、Agent 管理

3.1 添加新 Agent

`bash

# 添加一个工程师 Agent

npx paperclipai agent create

–company-id

–payload-json ‘{

“name”: “Engineer-Frontend”,

“role”: “engineer”,

“title”: “前端工程师”,

“adapterType”: “hermes_local”,

“adapterConfig”: {

“timeoutSec”: 600,

“persistSession”: true,

“model”: “xiaomi/mimo-v2.5-pro”,

“provider”: “xiaomi”

},

“runtimeConfig”: {

“heartbeat”: {

“enabled”: true,

“intervalSec”: 300,

“cooldownSec”: 10,

“maxConcurrentRuns”: 5

}

}

}’

`

3.2 暂停和恢复 Agent

`bash

# 暂停 Agent(停止接收新任务)

npx paperclipai agent pause –reason “维护中”

# 恢复 Agent

npx paperclipai agent resume

`

3.3 删除 Agent

`bash

# 删除 Agent(谨慎操作)

npx paperclipai agent delete –yes

`

3.4 查看 Agent 工作记录

`bash

# 查看 Agent 的运行历史

npx paperclipai agent task-sessions

# 查看 Agent 的运行时状态

npx paperclipai agent runtime-state

# 查看 Agent 的配置

npx paperclipai agent configuration

`


四、任务管理

4.1 Issue 状态流转

`

backlog → todo → in_progress → in_review → done

│ │ │ │ │

│ │ │ │ └── 完成

│ │ │ └── 审核中

│ │ └── 进行中

│ └── 待处理

└── 待规划

`

4.2 创建 Issue

`bash

# 创建高优先级任务

npx paperclipai issue create

–company-id

–payload-json ‘{

“title”: “修复登录页面 Bug”,

“body”: “用户反馈登录按钮点击无反应,需要排查修复”,

“priority”: “urgent”,

“assigneeAgentId”: “”

}’

# 创建普通任务

npx paperclipai issue create

–company-id

–payload-json ‘{

“title”: “编写 API 文档”,

“body”: “为 REST API 编写 OpenAPI 文档”,

“priority”: “medium”

}’

`

4.3 查看 Issue 列表

`bash

# 查看所有 Issue

npx paperclipai issue list

# 按状态筛选

npx paperclipai issue list –status backlog,todo

# 按 Agent 筛选

npx paperclipai issue list –assignee-agent-id

`

4.4 更新 Issue

`bash

# 标记为完成

npx paperclipai issue update

–payload-json ‘{“status”: “done”}’

# 重新分配

npx paperclipai issue update

–payload-json ‘{“assigneeAgentId”: “”}’

# 修改优先级

npx paperclipai issue update

–payload-json ‘{“priority”: “high”}’

`


五、Heartbeat 调度

5.1 什么是 Heartbeat?

Heartbeat 是 Paperclip 的核心机制。它定期唤醒 Agent,让 Agent:

  1. 检查是否有新任务
  2. 继续未完成的工作
  3. 汇报工作进度

5.2 配置 Heartbeat

`bash

# 启用 Heartbeat,每 5 分钟唤醒一次

npx paperclipai agent update

–payload-json ‘{

“runtimeConfig”: {

“heartbeat”: {

“enabled”: true,

“intervalSec”: 300,

“cooldownSec”: 10,

“wakeOnDemand”: true,

“maxConcurrentRuns”: 5

}

}

}’

`

5.3 手动触发 Heartbeat

`bash

# 立即唤醒 Agent

npx paperclipai agent heartbeat:invoke

`

5.4 Heartbeat 最佳实践

场景 建议间隔 说明

|——|———-|——|

CEO 300秒 (5分钟) 频繁检查任务分配
CTO 600秒 (10分钟) 定期审核代码
工程师 按需触发 有任务时才唤醒
运营 1800秒 (30分钟) 定期检查数据

六、预算控制

6.1 设置月度预算

`bash

# 设置 Agent 的月度预算(单位:分)

# 10000 = $100

npx paperclipai agent update

–payload-json ‘{

“budgetMonthlyCents”: 10000

}’

`

6.2 查看消费情况

`bash

# 查看 Agent 的消费统计

npx paperclipai agent get | grep -E “spent|budget”

# 查看公司的总消费

npx paperclipai company get | grep -E “spent|budget”

`

6.3 预算超限处理

当 Agent 达到预算上限时:

  1. Agent 会自动停止接收新任务
  2. 已有的任务会继续完成
  3. 需要手动增加预算或等待下月重置

`bash

# 增加预算

npx paperclipai agent update

–payload-json ‘{“budgetMonthlyCents”: 20000}’

`


七、监控和日志

7.1 查看 Dashboard

打开浏览器访问 http://localhost:3100,可以看到:

  • 所有 Agent 的状态
  • 待处理的 Issue
  • 最近的活动记录
  • 消费统计

7.2 查看活动日志

`bash

# 查看最近活动

npx paperclipai activity list –limit 20

# 查看特定 Agent 的活动

npx paperclipai activity list –agent-id

`

7.3 查看服务器日志

`bash

# 实时查看日志

tail -f ~/.paperclip/instances/default/logs/server.log

# 搜索错误

grep -i “error|fail” ~/.paperclip/instances/default/logs/server.log

`

7.4 健康检查

`bash

# API 健康检查

curl http://localhost:3100/api/health

# 检查所有 Agent 状态

npx paperclipai agent list –company-id

`


八、协同工作模式

8.1 CEO 自动分配任务

CEO Agent 在 Heartbeat 时会自动:

  1. 检查 backlog 中的 Issue
  2. 根据 Agent 的能力和负载分配任务
  3. 更新 Issue 状态为 todo
  4. 通知对应的 Agent

8.2 CTO 审核代码

CTO Agent 可以配置为:

  1. 定期检查 in_review 状态的 Issue
  2. 审核工程师提交的代码
  3. 提供反馈或批准
  4. 更新 Issue 状态为 done

8.3 工程师协作

多个工程师 Agent 可以并行工作:

  1. 每个工程师专注于自己的任务
  2. 通过 Issue 系统协调工作
  3. CEO 负责解决冲突

8.4 跨 Agent 通信

Agent 之间通过 Issue 评论进行通信:

`bash

# Agent 在 Issue 上发布评论

curl -X POST “http://localhost:3100/api/issues//comments”

-H “Content-Type: application/json”

-d ‘{“body”: “代码已提交,等待审核”}’

`


九、最佳实践

9.1 任务描述要清晰

❌ 不好的描述:

`

修复 Bug

`

✅ 好的描述:

`

标题:修复用户登录页面的按钮点击无反应问题

描述:

  1. 问题:用户在登录页面点击”登录”按钮时,没有任何反应
  2. 预期:点击后应该发送登录请求
  3. 环境:Chrome 120, Windows 11
  4. 复现步骤:
  • 打开登录页面
  • 输入用户名和密码
  • 点击”登录”按钮
  • 观察:没有任何反应

`

9.2 合理设置优先级

优先级 说明 使用场景

|——–|——|———-|

urgent 紧急 生产环境故障
high 重要功能开发
medium 常规任务
low 优化和改进

9.3 定期检查预算

`bash

# 每周检查一次消费情况

npx paperclipai company get | grep -E “spent|budget”

`

9.4 备份重要数据

`bash

# 每天自动备份

npx paperclipai db:backup

# 备份配置文件

cp ~/.paperclip/instances/default/config.json ~/backup/

`


十、常见场景

场景 1:开发一个新功能

`bash

# 1. CEO 创建 Issue

npx paperclipai issue create

–payload-json ‘{

“title”: “开发用户注册功能”,

“body”: “实现邮箱注册,包含验证功能”,

“priority”: “high”

}’

# 2. CEO 分配给工程师

npx paperclipai issue update

–payload-json ‘{“assigneeAgentId”: “”, “status”: “todo”}’

# 3. 工程师 Heartbeat 触发,开始工作

# 4. 工程师完成后标记为 done

# 5. CTO 审核

`

场景 2:修复紧急 Bug

`bash

# 1. 创建紧急 Issue

npx paperclipai issue create

–payload-json ‘{

“title”: “紧急:支付页面崩溃”,

“body”: “用户在支付页面遇到 500 错误”,

“priority”: “urgent”

}’

# 2. 立即触发工程师的 Heartbeat

npx paperclipai agent heartbeat:invoke

`

场景 3:批量处理任务

`bash

# 创建多个相关 Issue

for i in {1..5}; do

npx paperclipai issue create

–payload-json “{

“title”: “API 端点 $i”,

“body”: “实现 API 端点 $i”,

“priority”: “medium”

}”

done

# CEO 会自动分配给空闲的工程师

`


十一、故障排除

11.1 Agent 不响应

`bash

# 1. 检查 Agent 状态

npx paperclipai agent get

# 2. 如果是 error 状态,重置

npx paperclipai agent runtime-state:reset-session

npx paperclipai agent resume

# 3. 手动触发 Heartbeat

npx paperclipai agent heartbeat:invoke

`

11.2 Issue 不被处理

`bash

# 1. 检查 Issue 是否已分配

npx paperclipai issue get

# 2. 检查分配的 Agent 是否在线

npx paperclipai agent get

# 3. 手动触发 Agent 的 Heartbeat

npx paperclipai agent heartbeat:invoke

`

11.3 预算超限

`bash

# 1. 查看消费详情

npx paperclipai agent get | grep spent

# 2. 增加预算或等待下月

npx paperclipai agent update

–payload-json ‘{“budgetMonthlyCents”: 20000}’

`


附录:常用命令速查

Agent 管理

`bash

npx paperclipai agent list # 列出所有 Agent

npx paperclipai agent get # 查看 Agent 详情

npx paperclipai agent create –payload-json # 创建 Agent

npx paperclipai agent update –payload # 更新 Agent

npx paperclipai agent delete –yes # 删除 Agent

npx paperclipai agent resume # 恢复 Agent

npx paperclipai agent pause # 暂停 Agent

npx paperclipai agent heartbeat:invoke # 手动触发 Heartbeat

`

Issue 管理

`bash

npx paperclipai issue list # 列出 Issue

npx paperclipai issue get # 查看 Issue

npx paperclipai issue create –payload-json # 创建 Issue

npx paperclipai issue update –payload # 更新 Issue

`

系统管理

`bash

npx paperclipai run # 启动服务

npx paperclipai health # 健康检查

npx paperclipai db:backup # 手动备份

npx paperclipai configure # 修改配置

`


维护者:攀岩者

最后更新:2026年6月15日

版本:v1.0

评论

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注