freedcamp

# Freedcamp

This skill provides a dependency-free Node.js CLI that calls the Freedcamp REST API (v1) using **HMAC-SHA1 secured credentials** (API Key + API Secret).

- Script: `{baseDir}/scripts/freedcamp.mjs`
- Auth: `FREEDCAMP_API_KEY` + `FREEDCAMP_API_SECRET`
- Output: **JSON only** (stdout), suitable for agents and automation

## Setup

1. Obtain your Freedcamp API key and secret from your Freedcamp account settings.
2. Provide both values as environment variables.

### Common injection patterns

- Shell env (local testing):

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

- OpenClaw config (recommended): set `skills.entries.freedcamp.apiKey` and `skills.entries.freedcamp.env.FREEDCAMP_API_SECRET` so secrets are injected only for the agent run.

### Configure via OpenClaw CLI (recommended)

```bash
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"
```

**Verify what is stored:**

```bash
openclaw config get skills.entries.freedcamp
```

**Remove stored credentials:**

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

## First calls (sanity + discovery)

- Who am I / session info:

  `node {baseDir}/scripts/freedcamp.mjs me`

- List all groups, projects, and apps:

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

## ID resolution

When the user provides project names, resolve to IDs using:

- `groups-projects` returns all groups with their projects, including project IDs and names
- Use the exact `project_name` from the output for other commands

Avoid guessing a project ID when multiple matches exist.

## Core: tasks

### List tasks in a project

`node {baseDir}/scripts/freedcamp.mjs tasks --project <project_id> --all`

### List tasks with filters

`node {baseDir}/scripts...

# Freedcamp skill for OpenClaw / Clawdbot

A dependency-free **AgentSkill** that integrates **Freedcamp** via the **Freedcamp REST API (v1)** using **HMAC-SHA1 secured credentials** (API Key + API Secret).

- No npm dependencies
- Node.js 18+ (uses built-in `fetch`, `crypto`)
- JSON-only output (designed for agent tool calls)
- Supports both:
  - Personal task management (my tasks / triage / notifications)
  - Project workflows (task creation, status updates, comments, task lists, groups)

## Repo layout

- `SKILL.md` -- skill instructions for the agent runtime
- `README.md` -- human-facing quickstart (this file)
- `AGENTS.md` -- agent-facing development guide
- `scripts/freedcamp.mjs` -- CLI (the only executable)
- `references/REFERENCE.md` -- implementation notes and API links
- `_meta.json` -- OpenClaw/ClawHub metadata

## Prerequisites

- Node.js **18+**
- A Freedcamp account
- Freedcamp **API Key** and **API Secret**

## Setup (API credentials)

1. Get your API Key and API Secret from your Freedcamp account settings https://freedcamp.com/manage/account#integrations-api.
2. Provide them to the runtime as `FREEDCAMP_API_KEY` and `FREEDCAMP_API_SECRET`.

### Recommended: store credentials in OpenClaw config (non-interactive)

This keeps secrets out of prompts and reduces accidental leakage.

**Recommended:**

```bash
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"
```

**Verify what is stored:**

```bash
openclaw config get skills.entries.freedcamp
openclaw config get skills.entries.freedcamp.enabled
openclaw config get skills.entries.freedcamp.apiKey
```

**Remove stored credentials:**

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

### Local smoke test

```bash
export FREEDCAMP_API_KEY="YOUR_KEY"
export FREEDC...