Skip to content

Tool Reference & Role Authorization ​

Role-Level Dynamic Tool Authorization v1.14.3+ ​

TIP

Claw's capability boundaries are determined by role. Administrators naturally have all tools; other roles can only call explicitly authorized Tools — high-risk operations are completely invisible and uncallable for unauthorized roles. This enables Claw to be safely deployed in production environments while providing a personalized AI experience for every user.

In the erupt-ai role management interface, check the available Tools for each role and configure a dedicated system prompt. Changes take effect immediately without a restart. See Authorize Tools by Role.

@Tools Reference Table ​

The following lists all built-in @Tool entries in Erupt AI Claw. They can be selectively authorized in the role configuration interface.

System Tools ​

ToolDescription
getCurrentDateTimeGet the current date and time
execShellExecute a shell command (high-risk; recommend granting to admins only, and requires enable-exec-shell: true)

See Shell Execution Guardrails for the protection details.

File Management ​

All file operations are confined to the current user's sandbox directory (~/.erupt/{account}):

ToolDescription
listFilesList files and directories inside the sandbox (name, type, size)
readFileRead the content of a text file inside the sandbox
writeFileWrite a text file inside the sandbox (creates parent directories, overwrites if present)
appendFileAppend text to a file inside the sandbox (creates it if absent)
deleteFileDelete a file or empty directory inside the sandbox
moveFileMove or rename a file within the sandbox

Spring Boot ​

ToolDescription
getActiveProfilesGet the currently active Spring profiles
getPropertyRead the value of a specified Spring configuration property
getScheduledTasksGet the list of Spring scheduled tasks

JVM Monitoring ​

ToolDescription
getJvmMemoryGet JVM heap memory usage
getJvmUptimeGet JVM uptime
getThreadInfoGet JVM thread details
getGcStatsGet garbage collection statistics

Erupt Data ​

ToolDescription
eruptModelListGet the list of all Erupt models
eruptSchemaGet the field schema of a specified Erupt model
eruptDataQueryQuery the data list of an Erupt model
findEruptDataByPkQuery a single Erupt data record by primary key
insertEruptDataInsert a new record into an Erupt model
updateEruptDataUpdate a record in an Erupt model
deleteEruptDataDelete a record from an Erupt model
getEruptModulesGet the list of loaded Erupt modules
geneEruptCodeGenerate Erupt model code

Erupt User ​

ToolDescription
eruptUserInfoGet the current logged-in user's information
eruptUserPermissionsGet the current user's permission information

Skill Management ​

ToolDescription
listSkillsList all available Skills
getSkillDetailGet details of a specified Skill (including the file list under scripts/ and references/)
readSkillFileRead a specific file inside a Skill directory (progressive disclosure)
saveSkillCreate or update a Skill (follows the Agent Skills open standard)
patchSkillPatch SKILL.md with an exact find-and-replace — fix a wrong instruction the moment it's discovered, safer than rewriting the whole file
writeSkillFileWrite a file inside a Skill directory (e.g. scripts/run.sh, references/api_docs.md)
deleteSkillDelete a specified Skill

Memory Management ​

ToolDescription
listMemoriesList all memory entries
getMemoryGet the content of a specified memory
saveMemorySave a memory entry
deleteMemoryDelete a specified memory

Contributors

The avatar of contributor named as YuePeng YuePeng

Changelog

Released under the Apache-2.0 License.