cs-math

cs-math

用途

此技能可让 OpenClaw 执行计算机科学数学运算，涵盖离散数学（例如集合、图）、组合数学（例如排列）、概率论（例如分布）、线性代数（例如矩阵运算）以及机器学习所需的微积分（例如梯度），并使用经过优化的算法。

适用场景

当任务涉及代码中的数学计算时，可使用此技能，例如计算算法中的概率、求解机器学习模型的线性方程组，或分析数据结构中的组合问题。需要精确、可编程地进行数学运算时（例如优化问题或统计分析），请使用此技能，而非用于一般查询。

主要功能

• 执行离散数学运算：排列、组合、图遍历（例如通过邻接矩阵）。
• 处理概率问题：计算期望值、二项概率，或模拟概率分布。
• 执行线性代数运算：矩阵乘法、行列式、逆矩阵和特征值计算。
• 支持机器学习所需的微积分：计算损失函数的梯度和偏导数。
• 集成数据：处理输入中的数组或向量，并以 JSON 格式返回结果。

使用模式

通过指定操作和参数，使用 OpenClaw 的 CLI 或 API 调用此技能。为保持一致，请始终将输入作为 JSON 对象传递。例如，在 Python 代码中：import openclaw; result = openclaw.invoke_skill('cs-math', {'operation': 'permutation', 'n': 5, 'r': 3})。将输出作为字典处理，例如检查是否包含 'result' 键。使用 try-except 块捕获 API 调用失败。如果要重复使用参数，请将其存储在 JSON 等配置文件中：{"default_n": 5}，并在调用前加载。

常用命令/API

使用 OpenClaw CLI：openclaw cs-math --operation calculate --params '{"type": "permutation", "n": 5, "r": 3}' --output json 对于 API，请向 /api/skills/cs-math/execute 发送 POST 请求，包含请求头 {'Authorization': 'Bearer $OPENCLAW_API_KEY'} 和请求体：{"operation": "matrix_multiply", "A": [[1,2],[3,4]], "B": [[5,6],[7,8]]} 配置格式：参数必须是 JSON 对象，例如 {"operation": "probability", "distribution": "binomial", "n": 10, "p": 0.5}。常用标志：--verbose 用于输出调试信息，--timeout 30 用于设置 API 超时时间（秒）。Python 代码示例： import openclaw params = {"operation": "gradient", "function": "x2 + y2", "at": [1,1]} result = openclaw.invoke('cs-math', params) print(result['value']) # 输出梯度向量

集成说明

设置用于身份验证的环境变量：export OPENCLAW_API_KEY=your_api_key_value。在代码中，导入 OpenClaw 库并调用技能，例如：openclaw.set_api_key(os.environ['OPENCLAW_API_KEY']); openclaw.invoke('cs-math', params)。对于 Web 应用，请使用 SDK 处理重试：openclaw.configure(retries=3)。确保根据架构验证输入，例如使用 JSON Schema 验证 params。如果要将此技能嵌入更大的工作流中，可通过 OpenClaw 的事件系统与其他技能串联，例如在数学计算后触发 'algorithms' 技能。

错误处理

始终检查响应中是否包含 'error' 键，例如，如果 result.get('error') 为真，则引发自定义异常。常见错误：参数不是数值（例如排列中的 'n' 为负数）时会触发 InvalidInputError，可按以下方式处理：try: openclaw.invoke('cs-math', {'operation': 'permutation', 'n': -1}) except ValueError as e: log_error(e)。对于 API 超时，请使用 --timeout 标志并捕获 HTTP 错误：如果 response.status_code == 504，则最多重试 3 次。提前验证输入，例如使用以下方式确保求逆时矩阵为方阵：if not all(len(row) == len(matrix) for row in matrix): raise Error。调试时，使用 --verbose 标志记录详细错误信息。

具体用法示例

1. 计算从 5 个项目中每次取 3 个进行排列的排列数：使用代码：import openclaw; params = {"operation": "permutation", "n": 5, "r": 3}; result = openclaw.invoke('cs-math', params); print(result['result']) # Outputs: 10
2. 对两个 2x2 矩阵进行矩阵乘法：使用代码：import openclaw; A = [[1,2],[3,4]]; B = [[5,6],[7,8]]; params = {"operation": "matrix_multiply", "A": A, "B": B}; result = openclaw.invoke('cs-math', params); print(result['result']) # Outputs: [[19,22],[43,50]]

图关系

• 所属集群：computer-science
• 相关标签：math, discrete, probability, linear-algebra, combinatorics, statistics
• 关联技能：algorithms（用于将数学应用于排序/复杂度）、data-science（用于统计集成）、ml-foundations（用于模型训练中的微积分）