配置步骤

1. 从 Freedcamp 账户设置中获取您的 API Key 和 API Secret。
2. 将这两个值作为环境变量提供。

常见注入方式

• Shell 环境变量（本地测试）：

  export FREEDCAMP_API_KEY="..."
  export FREEDCAMP_API_SECRET="..."
  

• OpenClaw 配置（推荐）：设置 skills.entries.freedcamp.apiKey 和 skills.entries.freedcamp.env.FREEDCAMP_API_SECRET，确保密钥仅在智能体运行时注入。

通过 OpenClaw CLI 配置（推荐）

openclaw config set skills.entries.freedcamp.enabled true
openclaw config set skills.entries.freedcamp.apiKey "YOUR_API_KEY"
openclaw config set skills.entries.freedcamp.env.FREEDCAMP_API_SECRET "YOUR_API_SECRET"

验证已存储的配置：

openclaw config get skills.entries.freedcamp

移除已存储的凭证：

openclaw config unset skills.entries.freedcamp.apiKey
openclaw config unset skills.entries.freedcamp.env.FREEDCAMP_API_SECRET

首次调用（基础校验 + 接口探索）

• 当前用户身份 / 会话信息：

  node {baseDir}/scripts/freedcamp.mjs me

• 列出所有群组、项目和应用：

  node {baseDir}/scripts/freedcamp.mjs groups-projects

ID 解析

当用户提供项目名称时，请使用以下方式解析为 ID：

• groups-projects 返回全部群组及其下属项目，包含项目 ID 与项目名称
• 其他命令中应严格使用该输出中的 project_name 字段值

若存在多个匹配项，请勿猜测项目 ID。

核心功能：任务（tasks）

列出某项目下的全部任务

node {baseDir}/scripts/freedcamp.mjs tasks --project --all

按条件筛选任务列表

node {baseDir}/scripts/freedcamp.mjs tasks --project --status in_progress,not_started --assigned_to 2,-1

常用筛选参数：

• --status：逗号分隔，可选值：not_started、completed、in_progress、invalid、review
• --assigned_to：逗号分隔的用户 ID 列表。0 表示未分配，-1 表示所有人
• --due_from YYYY-MM-DD / --due_to YYYY-MM-DD
• --created_from YYYY-MM-DD / --created_to YYYY-MM-DD
• --list_status active|archived|all
• --with_archived true：包含归档项目中的任务
• --limit ：每页最多返回 200 条（默认 200）
• --offset ：用于分页

获取单个任务详情（含评论与附件）

node {baseDir}/scripts/freedcamp.mjs task

创建任务

node {baseDir}/scripts/freedcamp.mjs create-task --project --title "Task title"

支持可选描述与任务分组（task group）：

node {baseDir}/scripts/freedcamp.mjs create-task --project --title "Task title" --description "Details here" --task_group

更新任务

node {baseDir}/scripts/freedcamp.mjs update-task --title "New title" --status in_progress

状态取值说明：not_started（0）、completed（1）、in_progress（2）、invalid（3）、review（4）

按项目名称创建任务

node {baseDir}/scripts/freedcamp.mjs create-task-by-name --project_name "My Project" --app_name "Tasks" --title "New task"

通过会话数据将项目名称解析为 ID。当前仅支持 Tasks 应用。

任务分组（Task lists / groups）

• 列出某项目下的全部任务分组：

  node {baseDir}/scripts/freedcamp.mjs task-lists --project

• 指定应用（默认为 Tasks / app_id 2）：

  node {baseDir}/scripts/freedcamp.mjs task-lists --project --app_id 2

评论（Comments）

• 向任意对象添加评论：

  node {baseDir}/scripts/freedcamp.mjs comment --app_name "Tasks" --text "My comment"

评论内容默认自动包裹在

标签中；您也可直接传入原始 HTML：

node {baseDir}/scripts/freedcamp.mjs comment --app_name "Tasks" --html "

Bold text

支持的评论目标应用名

添加评论时，--app_name 必须是以下之一： Tasks、Discussions、Milestones、Time、Files、Issue Tracker、Wikis、CRM、Passwords、Calendar、Planner、Translations

通知（Notifications）

• 获取近期通知（最近 60 天）：

  node {baseDir}/scripts/freedcamp.mjs notifications

• 将某条通知标记为已读：

  node {baseDir}/scripts/freedcamp.mjs mark-read

数据模型参考

任务状态（Task statuses）

优先级（Priorities）

应用类型（App types）

重要说明

• 评论内容必须为 HTML 格式。通过 --text 传入的纯文本会自动包裹在

  标签中。

• 任务分页上限为每次请求 200 条；如需更多结果，请使用 --offset 分页参数。
• 会话（session）在本地缓存，并在收到 401 错误时自动刷新。
• tasks 命令的 --all 标志会自动分页拉取全部结果。

不支持的功能（Out of scope）

• 发票（Invoices）及发票增强版（Invoices Plus）相关 API 未开放。
• 不内置“Bot personality”逻辑；请在智能体提示词（agent prompt）中自行配置行为策略。