feat: support remark for openclaw (#12361)

Refs #12191

Author: zhengkunwang223

agent/app/api/v2/agents.go

@@ -91,6 +91,26 @@ func (b *BaseApi) ResetAgentToken(c *gin.Context) {
 	helper.Success(c)
 }
 
+// @Tags AI
+// @Summary Update Agent remark
+// @Accept json
+// @Param request body dto.AgentRemarkUpdateReq true "request"
+// @Success 200
+// @Security ApiKeyAuth
+// @Security Timestamp
+// @Router /ai/agents/remark [post]
+func (b *BaseApi) UpdateAgentRemark(c *gin.Context) {
+	var req dto.AgentRemarkUpdateReq
+	if err := helper.CheckBindAndValidate(&req, c); err != nil {
+		return
+	}
+	if err := agentService.UpdateRemark(req); err != nil {
+		helper.BadRequest(c, err)
+		return
+	}
+	helper.Success(c)
+}
+
 // @Tags AI
 // @Summary Update Agent model config
 // @Accept json

agent/app/dto/agents.go

@@ -4,6 +4,7 @@ import "time"
 
 type AgentCreateReq struct {
 	Name           string   `json:"name" validate:"required"`
+	Remark         string   `json:"remark"`
 	AppVersion     string   `json:"appVersion" validate:"required"`
 	WebUIPort      int      `json:"webUIPort" validate:"required"`
 	BridgePort     int      `json:"bridgePort"`
@@ -29,6 +30,7 @@ type AgentCreateReq struct {
 type AgentItem struct {
 	ID            uint      `json:"id"`
 	Name          string    `json:"name"`
+	Remark        string    `json:"remark"`
 	AgentType     string    `json:"agentType"`
 	Provider      string    `json:"provider"`
 	ProviderName  string    `json:"providerName"`
@@ -63,6 +65,11 @@ type AgentTokenResetReq struct {
 	ID uint `json:"id" validate:"required"`
 }
 
+type AgentRemarkUpdateReq struct {
+	ID     uint   `json:"id" validate:"required"`
+	Remark string `json:"remark"`
+}
+
 type AgentModelConfigUpdateReq struct {
 	AgentID   uint   `json:"agentId" validate:"required"`
 	AccountID uint   `json:"accountId" validate:"required"`

agent/app/model/agent.go

@@ -3,6 +3,7 @@ package model
 type Agent struct {
 	BaseModel
 	Name          string `json:"name" gorm:"not null;unique"`
+	Remark        string `json:"remark"`
 	AgentType     string `json:"agentType" gorm:"default:openclaw"`
 	Provider      string `json:"provider"`
 	Model         string `json:"model"`

agent/app/service/agents.go

@@ -29,6 +29,7 @@ type IAgentService interface {
 	Page(req dto.SearchWithPage) (int64, []dto.AgentItem, error)
 	Delete(req dto.AgentDeleteReq) error
 	ResetToken(req dto.AgentTokenResetReq) error
+	UpdateRemark(req dto.AgentRemarkUpdateReq) error
 	UpdateModelConfig(req dto.AgentModelConfigUpdateReq) error
 	GetOverview(req dto.AgentOverviewReq) (*dto.AgentOverview, error)
 	GetProviders() ([]dto.ProviderInfo, error)
@@ -234,6 +235,7 @@ func (a AgentService) Create(req dto.AgentCreateReq) (*dto.AgentItem, error) {
 	}
 	agent := &model.Agent{
 		Name:          req.Name,
+		Remark:        req.Remark,
 		AgentType:     agentType,
 		Provider:      provider,
 		Model:         storedModel,
@@ -323,6 +325,15 @@ func (a AgentService) ResetToken(req dto.AgentTokenResetReq) error {
 	return agentRepo.Save(agent)
 }
 
+func (a AgentService) UpdateRemark(req dto.AgentRemarkUpdateReq) error {
+	agent, err := agentRepo.GetFirst(repo.WithByID(req.ID))
+	if err != nil {
+		return err
+	}
+	agent.Remark = req.Remark
+	return agentRepo.Save(agent)
+}
+
 func (a AgentService) UpdateModelConfig(req dto.AgentModelConfigUpdateReq) error {
 	agent, err := loadOpenclawAgentByID(req.AgentID)
 	if err != nil {

agent/app/service/agents_utils.go

@@ -340,6 +340,7 @@ func buildAgentItem(agent *model.Agent, appInstall *model.AppInstall, envMap map
 	item := dto.AgentItem{
 		ID:            agent.ID,
 		Name:          agent.Name,
+		Remark:        agent.Remark,
 		AgentType:     agentType,
 		Provider:      agent.Provider,
 		ProviderName:  providercatalog.DisplayName(agent.Provider),

agent/init/migration/migrate.go

@@ -77,6 +77,7 @@ func InitAgentDB() {
 		migrations.AddAITerminalSettings,
 		migrations.UpdateAgentQuickJumpTitle,
 		migrations.FixOpenclaw20260323HTTPPort,
+		migrations.AddAgentRemarkColumn,
 	})
 	if err := m.Migrate(); err != nil {
 		global.LOG.Error(err)

agent/init/migration/migrations/init.go

@@ -1151,3 +1151,10 @@ WHERE version = ?
 		).Error
 	},
 }
+
+var AddAgentRemarkColumn = &gormigrate.Migration{
+	ID: "20260330-add-agent-remark-column",
+	Migrate: func(tx *gorm.DB) error {
+		return tx.AutoMigrate(&model.Agent{})
+	},
+}

agent/router/ro_ai.go

@@ -44,6 +44,7 @@ func (a *AIToolsRouter) InitRouter(Router *gin.RouterGroup) {
 		aiToolsRouter.POST("/agents/search", baseApi.PageAgents)
 		aiToolsRouter.POST("/agents/delete", baseApi.DeleteAgent)
 		aiToolsRouter.POST("/agents/token/reset", baseApi.ResetAgentToken)
+		aiToolsRouter.POST("/agents/remark", baseApi.UpdateAgentRemark)
 		aiToolsRouter.POST("/agents/model/update", baseApi.UpdateAgentModelConfig)
 		aiToolsRouter.POST("/agents/overview", baseApi.GetAgentOverview)
 		aiToolsRouter.GET("/agents/providers", baseApi.GetAgentProviders)

frontend/src/api/interface/ai.ts

@@ -238,6 +238,7 @@ export namespace AI {
 
     export interface AgentCreateReq {
         name: string;
+        remark: string;
         appVersion: string;
         webUIPort: number;
         bridgePort?: number;
@@ -263,6 +264,7 @@ export namespace AI {
     export interface AgentItem {
         id: number;
         name: string;
+        remark: string;
         agentType: 'openclaw' | 'copaw';
         provider: string;
         providerName: string;
@@ -297,6 +299,11 @@ export namespace AI {
         id: number;
     }
 
+    export interface AgentRemarkUpdateReq {
+        id: number;
+        remark: string;
+    }
+
     export interface AgentModelConfigUpdateReq {
         agentId: number;
         accountId: number;

frontend/src/api/modules/ai.ts

@@ -109,6 +109,10 @@ export const resetAgentToken = (req: AI.AgentTokenResetReq) => {
     return http.post(`/ai/agents/token/reset`, req);
 };
 
+export const updateAgentRemark = (req: AI.AgentRemarkUpdateReq) => {
+    return http.post(`/ai/agents/remark`, req);
+};
+
 export const updateAgentModelConfig = (req: AI.AgentModelConfigUpdateReq) => {
     return http.post(`/ai/agents/model/update`, req);
 };