图文并茂教你快速上手Paperclip+Claude code并解决使用中的各种问题

如何去掉Inbox的小图标数字

解决方案

如何查看你的组织架构，修改组织架构

查看组织架构

修改组织架构

任务目标：Agent 团队配置与中文化设置                                                                                                                                               
                                                                                                                                                                                     
  具体任务：                                                                                                                                                                         
  1. Agent 重命名                                                                                                                                                                    
     - 将"糖豆豆"改名为"全栈开发"                                                                                                                                                    
                                                                                                                                                                                     
  2. 新增 Agent                                                                                                                                                                      
     - 创建"测试" Agent（专注于测试相关工作）                                                                                                                                        
     - 创建"运维" Agent（专注于运维相关工作）                                                                                                                                        
                                                                                                                                                                                     
  3. 信息完善                                                                                                                                                                        
     - 为"全栈开发"、"测试"、"运维"三个 Agent 编写/更新个人信息 , 使用中文                                                                                                                                                                                                                             
     - 信息应包括角色描述、技能专长、工作职责等                                                                                                                                      
                                                                                                                                                                                     
  4. 中文化偏好设置                                                                                                                                                                  
     - 为所有现有 Agent 创建/更新记忆文件（MEMORY.md）                                                                                                                               
     - 在记忆文件中明确记录：所有回复、项目分析、文档记录均使用中文                                                                                                                  
     - 确保新创建的 Agent 也继承这一偏好           

如何查看你的agent正在干什么

解决方案

创建的agent 第二天起来莫名其妙丢失了怎么办

解决方案

再创建一个Agent, 指挥它恢复丢失的数据 最重要的一点，给它开启创建agent的权限 开始下达命令 已经找回数据，点击approve 我们可以观察一下它是如何处理的：

下面是我让救火队长生成的处理报告汇总

丢失Agent恢复处理报告

问题描述

昨天创建了几个agent（包含CTO、糖豆豆），但是今天都找不到了，需要恢复回来。

处理步骤

1. 检查现有Agent状态

• 调用API查看公司中现有的agent列表
• 发现只有2个agent（小助手、救火队长），CTO和糖豆豆确实丢失

2. 检查本地配置文件

• 扫描本地agent配置目录
• 发现存在4个agent目录，说明配置文件没有丢失
• 确认丢失的agent配置：
  • ef55b3c6-7120-4cac-a334-34e74e50b99f - CEO agent配置
  • 0f65e971-1096-4f66-9ba9-84f8819ef48f - CTO agent配置

3. 恢复Agent

• 使用 paper-create-agent 技能提交招聘请求

• 为每个丢失的agent创建招聘请求：

  CEO Agent

  • ID: 6a4a2231-a952-4653-a4bb-a2761a41c70b
  • Role: CEO
  • Title: Chief Executive Officer
  • 审批ID: 06aa3633-7183-4fd0-92c5-4ea861581df6

  CTO Agent

  • ID: d438d310-a4dd-4850-9422-a8fac98e5057
  • Role: CTO
  • Title: Chief Technology Officer
  • 审批ID: ca0e1fd7-6fd1-4913-8319-5b802f53d8b2

  糖豆豆 Agent

  • ID: ae3892d7-ab92-455c-91d5-1acb1ddb03fb
  • Role: Helper
  • Title: Helper
  • 审批ID: b49bf145-99b8-440e-95bb-39fd05ca0e54

4. 完成任务

• 更新任务状态为 done
• 添加完成说明和审批链接

结果

已成功提交3个agent的招聘请求，等待董事会批准后即可恢复丢失的agent。

Issue: The Paperclip local adapter is not auto-injecting PAPERCLIP_API_KEY (short-lived JWT token) into the heartbeat environment. This is a persistent adapter-level configuration issue.

解决方案

其实我是让claude 帮我处理的，下面是解决方案：

推荐操作: 该问题是由于 Paperclip 实例初始化不完整导致的，缺少包含 PAPERCLIP_AGENT_JWT_SECRET的.env文件。使用paperclipai doctor --repair` 命令可以自动修复此问题。

paperclipai doctor --repair --yes

修复后重启服务器，Agent 认证将恢复正常。

Claude run failed: subtype=success: API Error: 400 {"error":{"code":"InvalidParameter","message":"The parameter max_tokens specified in the request is not valid: integer above maximum value, expected a value <= 32768, but got 64000 instead. Request id: 021774878405477fdfd2e3c33d5b6eddad55ac385080e7225e9e7","param":"max_tokens","type":"BadRequest"}}(adapter_failed)

解决方案

检查一下此任务使用的模型是否是你配置的模型，我发现这个失败的任务，使用的并不是我配置的claude本地模型，我做了以下操作，就解决了这个问题：

• 1. 直接关闭了这个任务
• 2. 确认一下本地claude状态可用
• 3. 重新创建了一个新的任务

💖 结语

今天就写到这里啦~ 小伙伴们，我们明天再见！👋

欢迎大家指出问题，一起进步~ (￣ω￣(￣ω￣〃 (￣ω￣〃)ゝ